Error Reference
Error Reference¶
All error types thrown by the library across all languages.
CrawlError¶
Errors that can occur during crawling, scraping, or mapping operations.
| Variant | Message | Description |
|---|---|---|
NotFound |
not_found: | The requested page was not found (HTTP 404). |
Unauthorized |
unauthorized: | The request was unauthorized (HTTP 401). |
Forbidden |
forbidden: | The request was forbidden (HTTP 403). |
WafBlocked |
forbidden: waf/blocked: | The request was blocked by a WAF or bot protection (HTTP 403 with WAF indicators). vendor is the lowercase identifier of the detected WAF (e.g. "cloudflare", "datadome"). When the engine cannot identify the vendor, it uses "unknown". message is the freeform description for logs and human readers. The stable error tag remains forbidden: waf/blocked: MESSAGE so existing log-grep patterns and cross-language bindings continue to work; vendor is surfaced separately for structured consumers. |
Timeout |
timeout: | The request timed out. |
RateLimited |
rate_limited: | The request was rate-limited (HTTP 429). |
ServerError |
server_error: | A server error occurred (HTTP 5xx). |
BadGateway |
bad_gateway: | A bad gateway error occurred (HTTP 502). |
Gone |
gone: | The resource is permanently gone (HTTP 410). |
Connection |
connection: | A connection error occurred. |
Dns |
dns: | A DNS resolution error occurred. |
Ssl |
ssl: | An SSL/TLS error occurred. |
DataLoss |
data_loss: | Data was lost or truncated during transfer. |
BrowserError |
browser: | The browser failed to launch, connect, or navigate. |
BrowserTimeout |
browser_timeout: | The browser page load or rendering timed out. |
InvalidConfig |
invalid_config: | The provided configuration is invalid. |
Unsupported |
unsupported: | The requested capability is not supported by the active backend or build. |
Other |
other: | An unclassified error occurred. |