e2d9858b38
* chore(main): release 17.0.0 * chore: generate versioned docs Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
---
|
|
sidebar_label: HTTPRequest.respond
|
|
---
|
|
|
|
# HTTPRequest.respond() method
|
|
|
|
Fulfills a request with the given response.
|
|
|
|
**Signature:**
|
|
|
|
```typescript
|
|
class HTTPRequest {
|
|
respond(
|
|
response: Partial<ResponseForRequest>,
|
|
priority?: number
|
|
): Promise<void>;
|
|
}
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| response | Partial<[ResponseForRequest](./puppeteer.responseforrequest.md)> | the response to fulfill the request with. |
|
|
| priority | number | <i>(Optional)</i> 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()](./puppeteer.page.setrequestinterception.md).
|
|
|
|
Exception is immediately thrown if the request interception is not enabled.
|
|
|
|
## Example
|
|
|
|
An example of fulfilling all requests with 404 responses:
|
|
|
|
```ts
|
|
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.
|