@suitecut/browser-control

One API for Chromium, Firefox and the suitecut engine.

npm package 2.1.0

@suitecut/browser-control, explained. Recorded, narrated and rendered by suitecut.

How it works

browser-control is a TypeScript SDK for three kinds of browser: the suitecut engine, an installed Chrome, Edge or Brave, and Firefox.

It talks to each browser over a private pipe, so there is no open debugging port.

If you have used Playwright it will read the same: contexts, pages, locators, routing, downloads and tracing, across 31 feature families. On the suitecut engine a live viewer lets a person take control from an agent and hand it back.

your Nodeprogrambrowser-controlone APIsuitecut enginebinary pipeChrome, EdgeCDP, private pipeFirefoxWebDriver BiDiviewertake control

Your Node program uses browser-control, which drives the suitecut engine over a binary pipe, Chrome over a private CDP pipe, or Firefox over WebDriver BiDi. The suitecut engine also has a live viewer where a person can take control.

Quick start

Terminal
npm install @suitecut/browser-control

Open a page in Chrome

TypeScript
import { launchBrowser } from '@suitecut/browser-control'

const browser = await launchBrowser({
  backend: 'cdp',
  executablePath: '/path/to/chrome',
})
const page = await (await browser.newContext()).newPage()
await page.goto('https://example.com')
await page.getByRole('link', { name: 'More information' }).click()
await browser.close()

What you get

  • Backends suitecut engine, Chrome, Edge or Brave over CDP, Firefox over WebDriver BiDi
  • Transport Private pipes; nothing listens on a port
  • API Contexts, pages, frames, locators, routing, HAR, storage and tracing
  • Viewer Watch live, take control, then resume the agent
  • Remote Attach to a running browser, with headers and TLS client certificates
  • Size About 320 KiB packed, no browser-automation dependencies

Limits

  • Does not download browsers. Point it at one you have installed, or the suitecut runtime.
  • Feature support differs by backend; unsupported calls fail with a clear error.

Read more

Other packages

Next: @suitecut/shared-browser