setExtraHTTPHeaders(headers)

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.

Open source

setExtraHTTPHeaders(headers)

This sets extra HTTP headers which will be sent with subsequent HTTP requests.

ParameterTypeDefaultDescription
headersObject<string, string>An object containing the additional HTTP headers. All header values must be strings.

Returns

TypeDescription
Promise<void>A Promise that fulfills when the headers have been set.

Example

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

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

export default async function () {
  const page = await browser.newPage();

  await page.setExtraHTTPHeaders({ foo: 'bar' });
  const url = await page.goto('https://test.k6.io/browser.php');

  console.log(url.request().headers().foo); // prints bar
}