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/experimentalbreadcrumb arrow browserbreadcrumb arrow Pagebreadcrumb arrow throttleNetwork(networkProfile)
Open source

throttleNetwork(networkProfile)

Throttles the network in Chrome/Chromium to slow it down by the specified fields in the networkProfile object.

ParameterTypeDefaultDescription
networkProfileNetworkProfilenullThis is a mandatory parameter.
networkProfile.latencynumber0Minimum latency from request sent to response headers received (ms).
networkProfile.downloadnumber-1Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
networkProfile.uploadnumber-1Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.

To work with the most commonly tested network profiles, import networkProfiles from the browser module. There are three profiles available:

NameNotes
'No Throttling'No throttling, which is the default before applying any network throttling. This can be used to remove the network throttling.
'Fast 3G'Emulates a typical fast 3G connection
'Slow 3G'Emulates a typical slow 3G connection

Example

JavaScript 
import { browser, networkProfiles } from 'k6/experimental/browser';

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

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

  try {
    page.throttleNetwork(networkProfiles['Slow 3G']);

    await page.goto('https://test.k6.io/', { waitUntil: 'networkidle' });
  } finally {
    page.close();
  }
}