puppeteer/docs/api/puppeteer.httprequest.failure.md
jrandolf f07ad2c661
fix: update documentation on configuring puppeteer (#9150)
This PR updates the docs regarding configuring puppeteer. In addition,
some changes have been made to the documentation generator to show
default values on the documentation site.

Also fixes: https://github.com/puppeteer/puppeteer/pull/9144
2022-10-24 09:07:05 +02:00

36 lines
703 B
Markdown

---
sidebar_label: HTTPRequest.failure
---
# HTTPRequest.failure() method
Access information about the request's failure.
#### Signature:
```typescript
class HTTPRequest {
failure(): {
errorText: string;
} | null;
}
```
**Returns:**
{ errorText: string; } \| null
`null` unless the request failed. If the request fails this can return an object with `errorText` containing a human-readable error message, e.g. `net::ERR_FAILED`. It is not guaranteed that there will be failure text if the request fails.
## Remarks
## Example
Example of logging all failed requests:
```ts
page.on('requestfailed', request => {
console.log(request.url() + ' ' + request.failure().errorText);
});
```