puppeteer/website/versioned_docs/version-17.1.3/api/puppeteer.httprequest.failure.md
release-please[bot] 9b120f6c7b
chore(main): release 17.1.3 (#8921)
* chore(main): release 17.1.3

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-09-08 13:16:39 +00:00

36 lines
702 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);
});
```