Core API

Connect a driver

Attach Playwright, Puppeteer, or Selenium to a launched profile using the ws_endpoint and debugger_address from the launch response.

Attach over CDP

After a launch, use ws_endpoint for Playwright and Puppeteer, or debugger_address for Selenium. The browser already holds a context and a page, so grab the first of each rather than creating a new context.

import { chromium } from "playwright";
const browser = await chromium.connectOverCDP(res.ws_endpoint);
const page = browser.contexts()[0].pages()[0];
await page.goto("https://example.com");

Which field each driver needs

DriverConnect withField
Playwrightchromium.connectOverCDPws_endpoint
Puppeteerpuppeteer.connectws_endpoint
SeleniumChrome options debuggerAddressdebugger_address
Puppeteer connects to an existing browser, so use puppeteer-core and connect rather than launch.