9b120f6c7b
* chore(main): release 17.1.3 * chore: generate versioned docs Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
1.6 KiB
1.6 KiB
| sidebar_label |
|---|
| Page.setRequestInterception |
Page.setRequestInterception() method
Activating request interception enables HTTPRequest.abort(), HTTPRequest.continue() and 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.
Signature:
class Page {
setRequestInterception(value: boolean): Promise<void>;
}
Parameters
| Parameter | Type | Description |
|---|---|---|
| value | boolean | Whether to enable request interception. |
Returns:
Promise<void>
Example
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();
})();