setOffline(offline)

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

setOffline(offline)

Toggles the browser context’s connectivity on/off.

ParameterTypeDefaultDescription
offlinebooleanfalseWhether to emulate the browser context being disconnected (true) or connected (false).

Returns

TypeDescription
Promise<void>A Promise that fulfills when the connectivity has 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 context = await browser.newContext();

  await context.setOffline(true);

  const page = await context.newPage();

  try {
    // Will not be able to load the page
    await page.goto('https://test.k6.io/browser.php');
  } finally {
    await page.close();
  }
}