Skip to main content

Browser Sessions

The browser() primitive launches a stealthed Chrome instance and returns a CDP WebSocket URL. Connect Playwright or Puppeteer to automate pages with anti-bot stealth active.

How It Works

Each session gets its own Chrome process, spawned directly (not from the Playwright pool). This isolates sessions from scraping throughput.

Stealth Features

Sessions apply stealth via Chrome flags and emulation scripts: Sessions use direct Chrome spawn (the same as the scrape engine), so all stealth features are applied identically.

Usage

CLI

Resource Usage

  • Each session uses ~300MB memory (Chrome process)
  • Sessions are isolated from the scrape/crawl pool
  • Default timeout: 5 minutes (configurable via timeoutMs)