Skip to main content
Browser handles expose resource helpers for the things a real browser session produces: files, downloads, dialogs, permissions, recordings, events, pages, and blockers.

Files

Use files to stage host-provided bytes for browser-side upload workflows.
When browser code or an agent run needs the staged file, resolve it inside browser execution with files.path(fileId) before calling an upload control such as locator.setInputFiles(...). For agent runs against an existing browser, use an agent without browser.policy; the browser owns policy.
CreateBrowserFileOptions fields:

Downloads

BrowserDownloadSaveOptions:

Dialogs

Permissions

Use permission helpers when a workflow needs explicit browser permissions such as geolocation.

Recordings

Recording methods are useful only for browsers created with recording: true.
RecordingDownloadResult contains segmentId, outputDir, manifestPath, eventsPath, and framePaths.

Events

BrowserEventsOptions fields: BrowserEventStreamOptions also accepts pollIntervalMs.

Pages

browser.pages(options?) returns page summaries with:

CAPTCHA and blockers

BrowserCaptchaResolveOptions accepts resolver options plus signal.