grantPermissions(permissions[, options])

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current 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/',
  });
}