Activate page

Make a page the active page for browser Tools and Agent actions. A Runtime can have several pages, but only one page is active at a time.

Activate a page

1
const page = await bctrl.tools.call("browser.pages.activate", {
2
  pageId,
3
}, { runtimeId: runtime.id });
4
5
console.log(page.id, page.active);

The Runtime must be active. The page must already exist in that Runtime.

Request parameters

Response

Run asynchronously

1
const call = await bctrl.tools.start("browser.pages.activate", {
2
  pageId,
3
}, { runtimeId: runtime.id });
4
5
const page = await bctrl.toolCalls.result(call.id, {
6
  waitSeconds: 30,
7
});

Next

• List pages — find page IDs
• Get page — inspect a page
• Stagehand act — act on the active page