puppeteer/website/versioned_docs/version-21.5.0/api/puppeteer.page.emulatenetworkconditions.md
release-please[bot] b33ff31c2a
chore: release main (#11275)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2023-11-02 16:51:26 +01:00

1.4 KiB

sidebar_label
Page.emulateNetworkConditions

Page.emulateNetworkConditions() method

This does not affect WebSockets and WebRTC PeerConnections (see https://crbug.com/563644). To set the page offline, you can use Page.setOfflineMode().

A list of predefined network conditions can be used by importing PredefinedNetworkConditions.

Signature:

class Page {
  emulateNetworkConditions(
    networkConditions: NetworkConditions | null
  ): Promise<void>;
}

Parameters

Parameter Type Description
networkConditions NetworkConditions | null Passing null disables network condition emulation.

Returns:

Promise<void>

Example

import {PredefinedNetworkConditions} from 'puppeteer';
const slow3G = PredefinedNetworkConditions['Slow 3G'];

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.emulateNetworkConditions(slow3G);
  await page.goto('https://www.google.com');
  // other actions...
  await browser.close();
})();