Menu

This is documentation for the next version of K6. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/browserbreadcrumb arrow BrowserContextbreadcrumb arrow grantPermissions(permissions[, options])
Open source

grantPermissions(permissions[, options])

Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if specified.

ParameterTypeDescription
permissionsarrayA string array of permissions to grant. A permission can be one of the following values: 'geolocation', 'midi', 'midi-sysex' (system-exclusive midi), 'notifications', 'camera', 'microphone', 'background-sync', 'ambient-light-sensor', 'accelerometer', 'gyroscope', 'magnetometer', 'accessibility-events', 'clipboard-read', 'clipboard-write', 'payment-handler'.
optionsobjectOptional.
options.originstringThe origin to grant permissions to, e.g. 'https://example.com'.

Returns

TypeDescription
Promise<void>A Promise that fulfills when the permissions have been granted.

Example

JavaScript
import { browser } from 'k6/browser';

export const options = {
  scenarios: {
    browser: {
      executor: 'shared-iterations',
      options: {
        browser: {
          type: 'chromium',
        },
      },
    },
  },
};

export default async function () {
  const context = await browser.newContext();
  await context.grantPermissions(['clipboard-read', 'clipboard-write'], {
    origin: 'https://example.com/',
  });
}