Automate browser tabs (alias for playwright-cli).

Synopsis

puppeteer <command> [args...]

Description

Automates real browser tabs: navigate, click, type, snapshot the accessibility tree, screenshot, and evaluate JavaScript. Most commands operate on a tab and require --tab=<targetId>; there is no implicit current tab, so run 'playwright-cli tab-list' (or the equivalent tab-list command) to get tab IDs first. This name is an alias; behavior is identical to playwright-cli.

Options

open [url|/vfs/path] [--foreground|--fg] [--runtime=<id>] [--discover] [--mobile] Open a new tab, in the background by default.

goto|navigate <url> --tab=<id> [--discover] Navigate a tab to a URL.

click <ref> --tab=<id> Click an element by ref (e.g. e5).

type <text> --tab=<id> [--submit] Type text into the focused element.

fill <ref> <text> --tab=<id> [--submit] Fill an input by ref with text.

snapshot --tab=<id> [--frame=<frameId>] [--depth=<n>] [--boxes] Print the tab's accessibility tree.

screenshot [ref] --tab=<id> [--filename=path] [--fullPage] Take a screenshot.

eval <expression> --tab=<id> Evaluate JavaScript in a tab or frame.

Examples

$ puppeteer open https://example.com --foreground

Open a tab and bring it to the front.

$ puppeteer eval 'document.title' --tab=T1

Evaluate JavaScript in tab T1.

Notes

Despite the name, this does not use the real Puppeteer library — it is an alias for the same tool as playwright-cli, named for discoverability. See playwright-cli --help for the full command list.

See Also

playwright-cli, playwright