47 lines
1.3 KiB
Markdown
47 lines
1.3 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.
|
|
|