Error Reference
Error Reference
Section titled “Error Reference”All error types thrown by the library across all languages.
CrawlError
Section titled “CrawlError”Errors that can occur during crawling, scraping, or mapping operations.
| Variant | Message | Description |
|---|---|---|
NotFound |
not_found: {0} | The requested page was not found (HTTP 404). |
Unauthorized |
unauthorized: {0} | The request was unauthorized (HTTP 401). |
Forbidden |
forbidden: {0} | The request was forbidden (HTTP 403). |
WafBlocked |
forbidden: waf/blocked: {message} | 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: {0} | The request timed out. |
RateLimited |
rate_limited: {0} | The request was rate-limited (HTTP 429). |
ServerError |
server_error: {0} | A server error occurred (HTTP 5xx). |
BadGateway |
bad_gateway: {0} | A bad gateway error occurred (HTTP 502). |
Gone |
gone: {0} | The resource is permanently gone (HTTP 410). |
Connection |
connection: {0} | A connection error occurred. |
Dns |
dns: {0} | A DNS resolution error occurred. |
Ssl |
ssl: {0} | An SSL/TLS error occurred. |
DataLoss |
data_loss: {0} | Data was lost or truncated during transfer. |
BrowserError |
browser: {0} | The browser failed to launch, connect, or navigate. |
BrowserTimeout |
browser_timeout: {0} | The browser page load or rendering timed out. |
InvalidConfig |
invalid_config: {0} | The provided configuration is invalid. |
Unsupported |
unsupported: {0} | The requested capability is not supported by the active backend or build. |
SsrfPolicyViolation |
ssrf_policy_violation: {url} - {reason} | A URL was rejected by SSRF policy (private IP, metadata, disallowed scheme, etc). |
Other |
other: {0} | An unclassified error occurred. |
SsrfError
Section titled “SsrfError”SSRF validation error.
| Variant | Message | Description |
|---|---|---|
DeniedByPolicy |
denied by SSRF policy: {reason} | URL denied by SSRF policy: private IP, metadata IP, etc. |
NotOnAllowlist |
host not on allowlist | Host not on allowlist when an allowlist is configured. |
InvalidCidr |
invalid CIDR in SSRF allowlist: {0} | Allowlist entry is not a parseable CIDR block. |
DnsResolutionFailed |
dns resolution failed: {0} | DNS resolution failed for hostname. |
InvalidUrl |
invalid URL: {0} | Invalid URL format. |
DisallowedScheme |
disallowed scheme: {0} | URL scheme not in allowlist (e.g., ftp:// when only http/https allowed). |
TooManyRedirects |
too many redirects | Too many HTTP redirects encountered during validation. |