puppeteer/website/versioned_docs/version-21.3.1/api/puppeteer.httprequest.failure.md

36 lines
703 B
Markdown
Raw Normal View History

---
sidebar_label: HTTPRequest.failure
---
# HTTPRequest.failure() method
Access information about the request's failure.
2022-10-24 14:31:12 +00:00
#### 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);
});
```