Open page

Open a new page in an active browser Runtime. The returned page.id is the pageId used by the other browser page Tools and by Stagehand.

Open a page

1
const page = await bctrl.tools.call("browser.pages.open", {
2
  url: "https://example.com/checkout",
3
}, { runtimeId: runtime.id });
4
5
console.log(page.id, page.url, page.title);

url is optional. If omitted, the Runtime opens a blank page. The Runtime must be active and use the browser runtime type.

Request parameters

Response

Run asynchronously

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

Use bctrl.toolCalls.get(call.id) to inspect progress or bctrl.toolCalls.cancel(call.id) to cancel an active call.

Next

• List pages — find pages in the Runtime
• Activate page — choose the active page
• Stagehand act — automate the page semantically