List pages

View as Markdown

List the pages currently open in an active browser Runtime. Use the returned page IDs with Get page, Activate page, or Close page.

List pages

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

The Runtime must be active. This Tool is synchronous and does not create a separate ToolCall.

Request parameters

ParameterTypeRequiredDescription

Response

The response is a BrowserPage[] array. Each page contains:

FieldTypeAlways presentDescription
idPageIdYesPage identifier used by the other browser page Tools.
urlstringYesCurrent page URL.
titlestringYesCurrent page title.
activebooleanYesWhether the page is active for subsequent browser work.

Next