mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
88 lines
1.4 KiB
Markdown
88 lines
1.4 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
|
|
|
|
<table><thead><tr><th>
|
|
|
|
Parameter
|
|
|
|
</th><th>
|
|
|
|
Type
|
|
|
|
</th><th>
|
|
|
|
Description
|
|
|
|
</th></tr></thead>
|
|
<tbody><tr><td>
|
|
|
|
response
|
|
|
|
</td><td>
|
|
|
|
Partial<[ResponseForRequest](./puppeteer.responseforrequest.md)>
|
|
|
|
</td><td>
|
|
|
|
the response to fulfill the request with.
|
|
|
|
</td></tr>
|
|
<tr><td>
|
|
|
|
priority
|
|
|
|
</td><td>
|
|
|
|
number
|
|
|
|
</td><td>
|
|
|
|
_(Optional)_ If provided, intercept is resolved using cooperative handling rules. Otherwise, intercept is resolved immediately.
|
|
|
|
</td></tr>
|
|
</tbody></table>
|
|
**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.
|