Browser CapabilitiesEvents

page.on

View as Markdown

page.on is a browser runtime capability in the page namespace.

Availability

  • Runtime: browser
  • Kind: event
  • Category: events
  • Supported drivers: Playwright, Puppeteer, Stagehand

SDK Surface

  • SDK path: runtime.page.on
  • Async: No

HTTP Surface

  • Transport: resource route
  • Route: POST /workspaces/{id}/runtimes/{alias}/events/wait
  • Long-running: No

Reference Semantics

  • Requires refs: page

Arguments

ArgumentTypeRequiredDescription
eventNamestringYesEvent name to subscribe to.
listenerfunctionYesLocal SDK listener invoked on matching events.

Result

  • Type: runtime listener
  • Description: Registers a local SDK listener backed by runtime events.

Emitted Events

console, popup, download, dialog

SDK Example

1runtime.page.on('console', (event) => {
2  console.log(event);
3});

HTTP Example

1POST /workspaces/{id}/runtimes/{alias}/events/wait

Notes

  • This is an SDK convenience layer over runtime event list/wait APIs, not a standalone HTTP execute capability.