Browser Runtimes

Browser Profiles

View as Markdown

Browser profiles are persistent browser identities. They keep cookies, local storage, and browser settings across runtime restarts. Use profiles when a runtime should remember logged-in state.

Access profiles through bctrl.browserProfiles.

List profiles

1const profiles = await bctrl.browserProfiles.list();

Create a profile

1const profile = await bctrl.browserProfiles.create({
2  handle: "sales-bot",
3  displayName: "Sales Bot",
4  config: {
5    stealth: "high",
6    humanize: true,
7  },
8});

Launch with a profile

1const runtime = await space.runtimes.browser.launch({
2  name: "crm",
3  profile: profile.handle,
4});
5
6const connection = await runtime.connections.create({
7  protocol: "cdp",
8});

When the runtime stops, profile state is saved automatically.

Update a profile

1await bctrl.browserProfiles.update(profile.handle, {
2  displayName: "Sales Bot Production",
3  config: {
4    stealth: "high",
5  },
6});

Delete a profile

1await bctrl.browserProfiles.delete(profile.handle);