Browser Extensions

Browser extensions can be loaded into runtimes to add capabilities — ad blockers, captcha solvers, or custom tools. Upload extension binaries or import from a URL, then reference them when launching runtimes.

Access via bctrl.browserExtensions.

list()

List all uploaded extensions.

1
const extensions = await bctrl.browserExtensions.list();

Returns ExtensionMetadata[]

upload(request)

Upload an extension binary (.crx or .zip).

1
import { readFileSync } from "fs";
2
3
const ext = await bctrl.browserExtensions.upload({
4
  file: readFileSync("./captcha-solver.crx"),
5
  filename: "captcha-solver.crx",
6
});
7
console.log(ext.id);

Returns ExtensionMetadata

importFromUrl(request)

Import an extension from a URL.

1
const ext = await bctrl.browserExtensions.importFromUrl({
2
  url: "https://example.com/extension.crx",
3
});

Returns ExtensionMetadata

get(id)

Get a specific extension by ID.

1
const ext = await bctrl.browserExtensions.get("ext_abc123");

Returns ExtensionMetadata

delete(id)

Delete an extension.

1
await bctrl.browserExtensions.delete("ext_abc123");

Usage with runtimes

Load extensions when launching an ephemeral runtime:

1
const runtime = await workspace.runtimes.browser("main").playwright({
2
  mode: "ephemeral",
3
  extensionIds: ["ext_abc123"],
4
});