Class BrowserConfig

Action execution timeout in milliseconds

Additional Chromium launch arguments (e.g., --unsafely-treat-insecure-origin-as-secure)

Attach to an already-running browser instead of launching one. Auto-detects the connect method from the URL scheme:

• http(s)://… → Chrome DevTools Protocol (chromium.connectOverCDP), e.g. a real Chrome started with --remote-debugging-port=9222.
• ws(s)://… → Playwright browser server (chromium.connect), e.g. one started via chromium.launchServer() (pool / Docker / remote).

When set, the adapter does NOT close the browser on shutdown — the caller owns its lifecycle. Headless is ignored (the external browser already decided). Existing launch+close behavior is preserved when this is unset.

Force the connect method. A raw CDP websocket also uses ws://, which auto-detect would treat as a Playwright server; set 'cdp' to override. Defaults to 'auto' (scheme-based detection). Ignored when Connect is unset.

Run browser without a visible window

Pre-populate localStorage for specific origins before any page loads. Uses Playwright's storageState to inject entries at context creation, avoiding race conditions with SPA auth SDKs that check localStorage on init.

Each entry maps an origin (e.g. "http://localhost:4201") to key-value pairs. Set by the engine when LocalStorage auth bindings are configured.

Navigation timeout in milliseconds

When attached, reuse the running browser's first existing context so its cookies / auth / session are shared (the point of attaching to a user's browser), instead of creating a fresh isolated context. Defaults to false.

Note: this breaks per-test isolation. Viewport/UserAgent/InitialLocalStorage are ignored when reusing a context (they only apply to contexts we create). Ignored when Connect is unset.

Slow down actions by this many milliseconds (useful for debugging)

Custom user agent string

Viewport height in pixels

Viewport width in pixels