ErrLookup › apify/crawlee

apify/crawlee

Crawlee—A web scraping and browser automation library for Node.js to build reliable crawlers. In JavaScript and TypeScript. Extract data for AI, LLMs, RAG, or GPTs. Download HTML, PDF, JPG, PNG, and other files from websites. Works with Puppeteer, Playwright, Cheerio, JSDOM, and raw HTTP. Both headful and headless mode. With proxy rotation. · TypeScript · 843 source files

Analyzed at dbe57fb09c on 2026-08-30. 166 documented errors.

Code / MessageTypeSeverityTags
cannot be used inside a storage transaction: If you really…
exception error storage, transaction, request-queue, rollback
​
exception error launch, browser-installation, diagnostics
]`)}: Attempt of failed, and will be retried
console warning retry, network, cli, transient-failure
Installing Playwright browsers in an environment where…
console info playwright, browsers, cli, idempotency
StateValidationError(persistStateKey, result.issues)
validation error validation, state, schema
The ` ` property is not available on the outer context…
exception error adaptive-playwright-crawler, context, pipeline, response
An extracted URL: is relative and options.baseUrl is not…
validation error enqueue-links, url, relative-url, configuration
The state conversion for
exception error validation, async, schema, recoverable-state
<dynamic: message extracted from proxied error via…
exception warning proxy, network, session, retry
<dynamic: blocked-request message returned by…
exception warning session, blocked, anti-scraping, retry
Resource served Content-Type , but only are allowed…
exception warning mime-type, content-type, http, configuration
(ArgumentValidationError for value: , label: )
validation error validation, zod, configuration
Compilation result is not a function!
exception error puppeteer, javascript, vm, configuration
The state object is not consistent with RequestList the…
exception error state, persistence, request-list
Unknown enqueue strategy
exception error typescript, exhaustiveness, enqueue-strategy
Invalid "proxyUrl" option: authentication is only supported…
validation error proxy, validation, authentication, socks
browserController.newPage() failed
exception error page-creation, browser-crash, retry
- Error status code was set by user.
http error http-status, error-status-code, retry, configuration
Stagehand observe() failed
exception error stagehand, llm, browser-automation
Stagehand did not register the page within
exception error stagehand, cdp, timeout, registration
Cannot activate BrowserController without an assigned…
exception error lifecycle, browser-controller, api-misuse
(possible values: 'Cloudflare challenge failed, found…
exception warning anti-bot, session, cloudflare, blocked-request
Request without proxy
console warning proxy, networking, browser-pool
Selector ' ' not found.
exception error http, cheerio, selector, static-html
Invalid "proxyUrl". Unsupported protocol
validation error proxy, validation, configuration, browser-launcher
Request ID does not match its uniqueKey.
exception error request-queue, data-integrity, storage
${status} - ${message}
http error http, status-code, json, server-error
At most one of `body`, `form` and `json` may be specified…
validation error http, request-options, validation, api-misuse
Cannot extract links because the DOM is not available.
exception error dom, link-extraction, crawler, html-parsing
Cannot detect CDP client for Puppeteer
exception error cdp, puppeteer, version-incompatibility, crawlee
Default route is already defined! / Route for label
exception error routing, configuration, duplicate
Stagehand agent() failed
exception error stagehand, llm, agent
The…
validation error configuration, concurrency, invalid-options
" " is not allowed because it would resolve outside of the…
validation error path-traversal, security, memory-storage, validation
The current SessionPool instance couldn't find a valid…
exception error session, session-pool, timeout
Cannot extend LaunchContext with key
validation error browser-pool, launch-context, reserved-key, api-misuse
Failed to load robots.txt from
http error network, robots-txt, http
Failed to resolve the remote browser endpoint.
exception critical network, remote-browser, launch
A new page can be created with provided context only when…
validation error browser-pool, playwright, incognito, context-options
Intercept request handler must call one of…
exception error request-interception, puppeteer, handler-contract, crawlee
Failed to connect to remote browser at
exception critical network, websocket, remote-browser, launch
Could not parse cookie header string
exception error cookies, http, parsing
Browser plugin at index
validation error configuration, plugins, constructor
Navigation timed out after
exception error timeout, navigation, http-crawler
AdaptivePlaywrightCrawler requires transactional storage -…
exception error configuration, storage, adaptive-playwright-crawler
Cannot fetch a request list from
exception error network, http, request-queue
Failed to create new page
exception error stagehand, playwright, page-creation, error-wrapping
Cannot decide what to purge before running again…
validation error configuration, purge, request-manager, rerun
The request is not being processed
exception error state, internal-invariant, sitemap
Remote browser endpoint resolved to an empty string.
validation error browser-pool, remote-browser, configuration, empty-endpoint
BrowserController already has a browser instance assigned.
exception error lifecycle, browser-controller, api-misuse
Expected an iterable or async iterable, got
validation error type-error, arguments, add-requests
ServiceConflictError('Configuration', configuration…
exception error configuration, dependency-injection, lifecycle
${this.getMessageFromError(error)}
exception error proxy, session, network, browser-crawler
The "value" parameter must be a String, Buffer…
validation error validation, key-value-store, content-type
StateValidationError(this.#persistStateKey, result.issues)
validation error validation, constructor, schema
Giving up
exception error rate-limit, stalled, keep-alive
An extracted URL: is relative and baseUrl is not set…
exception error cheerio, url, scraping
Stagehand extract() failed
exception error stagehand, ai, extract, llm
: \``).join(', ')} cannot be combined with `browserPool`…
validation error configuration, browser-pool, mutually-exclusive-options
Page with ID: already exists.
exception error duplicate-id, api-misuse, browser-pool
PuppeteerCrawlerOptions.launchContext.proxyUrl is not…
validation error configuration, proxy, puppeteer, crawlee
Skipping request (starting url: -> loaded url: ) because it…
exception warning redirect, enqueue-strategy, skipped-request
saveSnapshot with key
exception error puppeteer, snapshot, key-value-store, error-wrapping
Function `newContext()` is not available in incognito mode
exception error browser-pool, playwright, incognito, unsupported-api
OwnedOrInjected value is not initialized yet
exception error initialization, lifecycle, typescript
fetchNextRequest called on an uninitialized crawler
exception error internal-state, lifecycle, crawler
Cannot clear the state persisted under key
exception error state, persistence, lifecycle
Failed to get CDP URL from Stagehand
exception error stagehand, cdp, browser-launch, compatibility
Could not derive the default values of the custom…
exception error statistics, configuration, deserialization
Cannot extract links because the JSDOM is not available.
exception error jsdom, skip-navigation, enqueue-links, dom
Function `stopTracing()` is not available in incognito mode
exception error browser-pool, playwright, incognito, tracing
Request timed out after
exception warning timeout, network, http, performance
Dataset.forEach/map/reduce() support only a "json" format.
exception error validation, dataset, api-misuse
The `window` property is not available - `skipNavigation`…
exception error jsdom, skip-navigation, dom, api-misuse
Cannot record a journal entry on a transaction in the
exception error transaction, state, storage
Function `startTracing()` is not available in incognito mode
exception error browser-pool, playwright, incognito, tracing
The "value" parameter cannot be stringified to JSON
validation error serialization, json, key-value-store
- Internal Server Error
http error http, status-code, server-error, plain-text
The provided newUrlFunction did not return a valid…
validation error proxy, url-validation, configuration
Failed to infer format from the path
validation error configuration, dataset-export, validation
Function `newBrowserCDPSession()` is not available in…
exception error browser-pool, playwright, incognito, cdp
Stagehand instance not found for browser
exception error stagehand, browser-pool, configuration
PlaywrightCrawlerOptions.launchContext.proxyUrl is not…
validation error configuration, proxy, playwright, crawlee
Request options are not valid, the 'id' property must not…
validation error validation, request-queue, api-misuse
RequestList is not initialized; you must call "await…
exception error lifecycle, initialization, request-list
RequestValidationError(label, result.issues)
validation error validation, schema, request
The `body` property is not available - `skipNavigation` was…
exception error jsdom, skip-navigation, dom, api-misuse
Unsupported sitemap content type
exception error sitemap, content-type, parsing
dataset.getData(): The response is too large for parsing…
exception error dataset, memory, pagination
Request provider is not initialized!
exception error initialization, request-provider, internal-state
Can not parse mime type
validation critical configuration, mime-type, validation, crawler-setup
The state object is not consistent with RequestList…
exception error state, persistence, request-list
Resource served with unsupported charset/encoding
exception error encoding, charset, http, internationalization
Skipping request as disallowed by robots.txt
exception warning robots-txt, skipped-request, crawling-policy
The custom statistics field
validation error statistics, configuration, naming-collision
Cannot parse Glob pattern
validation error validation, enqueue-links, glob
Remote browser endpoint() must return a URL string or an…
validation error browser-pool, remote-browser, configuration, shape-validation
Request options are not valid, the 'requestsFromUrl'…
validation error validation, request-queue, type-error
Cannot set property ' ' on serviceLocator directly. Use the…
exception error proxy, immutability, dependency-injection