browser

Experimental module

While we intend to keep experimental modules as stable as possible, we may need to introduce breaking changes. This could happen at future k6 releases until the module becomes fully stable and graduates as a k6 core module. For more information, refer to the extension graduation process.

Experimental modules maintain a high level of stability and follow regular maintenance and security measures. Feel free to open an issue if you have any feedback or suggestions.

The browser module APIs aim for rough compatibility with the Playwright API for NodeJS.

Note that because k6 does not run in NodeJS, the browser module APIs will slightly differ from their Playwright counterparts.

note

To work with the browser module, make sure you are using k6 version 0.43.0 or above.

Modules

The table below lists the importable properties from the top level module ('k6/experimental/browser').

Devices Example

To emulate the browser behaviour on a mobile device and approximately measure the browser performance, you can import devices from k6/experimental/browser.

1import { chromium, devices } from 'k6/experimental/browser';
2
3export default async function () {
4  const browser = chromium.launch({ headless: false });
5  const iphoneX = devices['iPhone X'];
6  const context = browser.newContext(iphoneX);
7  const page = context.newPage();
8
9  try {
10    await page.goto('https://test.k6.io/');
11  } finally {
12    page.close();
13    browser.close();
14  }
15}

Browser-level APIs