f07ad2c661
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
36 lines
703 B
Markdown
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);
|
|
});
|
|
```
|