Extremely Popular
Go to Latest
method Page.prototype.setRequestInterception
import { Page } from "https://dotland.deno.dev/x/fresh@1.5.2/tests/deps.ts";

Activating request interception enables {@link HTTPRequest.abort}, {@link HTTPRequest.continue} and {@link HTTPRequest.respond} methods. This provides the capability to modify network requests that are made by a page.

Once request interception is enabled, every request will stall unless it's continued, responded or aborted; or completed using the browser cache.

Enabling request interception disables page caching.

See the Request interception guide for more details.

Examples

An example of a naïve request interceptor that aborts all image requests:

const puppeteer = require('puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.setRequestInterception(true);
  page.on('request', interceptedRequest => {
    if (
      interceptedRequest.url().endsWith('.png') ||
      interceptedRequest.url().endsWith('.jpg')
    )
      interceptedRequest.abort();
    else interceptedRequest.continue();
  });
  await page.goto('https://example.com');
  await browser.close();
})();

Parameters

value: boolean
  • Whether to enable request interception.

Returns

Promise<void>