Close page

Close a page in an active browser Runtime. Closing a page removes it from the Runtime; use Open page to create a new one.

Close a page

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

The Runtime must be active. If you close the active page, choose another page with Activate page before sending the next page-specific action.

Request parameters

Response

The response contains the last known page state:

Run asynchronously

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

Next

• List pages — inspect remaining pages
• Open page — create a new page
• Runtimes — manage the browser session