Skip to main content
Version: Next

HTTPRequest.respond() method

Fulfills a request with the given response.

Signature​

class HTTPRequest {
respond(
response: Partial<ResponseForRequest>,
priority?: number,
): Promise<void>;
}

Parameters​

Parameter

Type

Description

response

Partial<ResponseForRequest>

the response to fulfill the request with.

priority

number

(Optional) If provided, intercept is resolved using cooperative handling rules. Otherwise, intercept is resolved immediately.

Returns:

Promise<void>

Remarks​

To use this, request interception should be enabled with Page.setRequestInterception().

Exception is immediately thrown if the request interception is not enabled.

Example​

An example of fulfilling all requests with 404 responses:

await page.setRequestInterception(true);
page.on('request', request => {
request.respond({
status: 404,
contentType: 'text/plain',
body: 'Not Found!',
});
});

NOTE: Mocking responses for dataURL requests is not supported. Calling request.respond for a dataURL request is a noop.