sincecutoff.com
← all changes

wrangler browser manages Browser Rendering sessions

Introduced 2026-04-13 · score 0.98

HOW TO USE IT

When your workflow needs a Browser Rendering DevTools session, use `wrangler browser create`, `close`, `list`, or `view` with the options below. Use `--json` for programmatic output; use `--no-open` to print the DevTools URL without opening it.

wrangler browser create [--lab] [--keepAlive <seconds>] [--open] [--json]
wrangler browser close <sessionId> [--json]
wrangler browser list [--json]

WHY THIS HELPS

Create, inspect, list, or close Browser Rendering DevTools sessions from a development workflow or script.

REQUIREMENTS AND LIMITATIONS

  • Version: 4.82.0
  • `<sessionId>` (required): Session to close.
  • `[sessionId]`: Session to view; optional when only one session exists. `view` prompts when multiple sessions are available.
  • `--lab`: Enable a lab browser session.
  • `--keepAlive <seconds>`: Set session keep-alive duration; the 4.82.0 changelog documents an example of 300 seconds.
  • `--open` / `--no-open`: Control whether DevTools opens in a browser; `--no-open` prints the DevTools URL. Default is true interactively and false in CI/scripts.
  • `--target <selector>`: Select a target for `view`.
  • `--json`: Return programmatic JSON output.
  • Prerequisite: `wrangler login` adds the `browser:write` OAuth scope.
  • Prerequisite: The Cloudflare changelog says Wrangler handles authentication, so API tokens need not be passed in the commands.
  • The default for `--open` is true in interactive mode and false in CI/scripts.
  • When multiple sessions exist, `view` prompts for selection.
  • Docs conflict: The current Wrangler command docs describe Browser Run and omit `--no-open`; they also document `--keepAlive` as 60–600 seconds. These docs were last updated after Wrangler 4.82.0, so those details are not applied here: https://developers.cloudflare.com/workers/wrangler/commands/browser/

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card