Browser CapabilitiesEvents

page.waitForEvent

View as Markdown

page.waitForEvent 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.waitForEvent
  • Async: Yes

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 wait for.
optionsobjectNoOptional event wait settings.

Result

  • Type: unknown
  • Description: Event payload mapped into runtime event metadata.

Emitted Events

console, popup, download, dialog

SDK Example

1await runtime.page.waitForEvent('console');

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.