git checkout -b fix-39562
... make changes ...

git add <changed-files>
git commit -m "$(cat <<'EOF'
fix(proxy): handle SOCKS proxy authentication
Fixes: https://github.com/microsoft/playwright/issues/39562
EOF
)"
git push origin fix-39562
gh pr create --repo microsoft/playwright --head username:fix-39562 \
  --title "fix(proxy): handle SOCKS proxy authentication" \
  --body "$(cat <<'EOF'
Summary  Copy Chapter

- <describe the change very! briefly>
Fixes https://github.com/microsoft/playwright/issues/39562
EOF
)"

npm install -g @playwright/cli@latest
playwright-cli --help

playwright-cli install --skills

Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
Check playwright-cli --help for available commands.

Use playwright skills to test https://demo.playwright.dev/todomvc/.

  Take screenshots for all successful and failing scenarios.

playwright-cli open https://demo.playwright.dev/todomvc/ --headed
playwright-cli type "Buy groceries"
playwright-cli press Enter
playwright-cli type "Water flowers"
playwright-cli press Enter
playwright-cli check e21
playwright-cli check e35
playwright-cli screenshot

playwright-cli open https://playwright.dev --headed

playwright-cli open https://playwright.dev
playwright-cli -s=example open https://example.com --persistent
playwright-cli list

PLAYWRIGHT_CLI_SESSION=todo-app claude .

playwright-cli list                     # list all sessions
playwright-cli close-all                # close all browsers
playwright-cli kill-all                 # forcefully kill all browser processes

playwright-cli show

playwright-cli open [url]               # open browser, optionally navigate to url
playwright-cli goto <url>               # navigate to a url
playwright-cli close                    # close the page
playwright-cli type <text>              # type text into editable element
playwright-cli click <ref> [button]     # perform click on a web page
playwright-cli dblclick <ref> [button]  # perform double click on a web page
playwright-cli fill <ref> <text>        # fill text into editable element
playwright-cli fill <ref> <text> --submit # fill and press Enter
playwright-cli drag <startRef> <endRef> # perform drag and drop between two elements
playwright-cli hover <ref>              # hover over element on page
playwright-cli select <ref> <val>       # select an option in a dropdown
playwright-cli upload <file>            # upload one or multiple files
playwright-cli check <ref>              # check a checkbox or radio button
playwright-cli uncheck <ref>            # uncheck a checkbox or radio button
playwright-cli snapshot                 # capture page snapshot to obtain element ref
playwright-cli snapshot --filename=f    # save snapshot to specific file
playwright-cli snapshot <ref>           # snapshot a specific element
playwright-cli snapshot --depth=N       # limit snapshot depth for efficiency
playwright-cli eval <func> [ref]        # evaluate javascript expression on page or element
playwright-cli dialog-accept [prompt]   # accept a dialog
playwright-cli dialog-dismiss           # dismiss a dialog
playwright-cli resize <w> <h>           # resize the browser window

playwright-cli go-back                  # go back to the previous page
playwright-cli go-forward               # go forward to the next page
playwright-cli reload                   # reload the current page

playwright-cli press <key>              # press a key on the keyboard, a, arrowleft
playwright-cli keydown <key>            # press a key down on the keyboard
playwright-cli keyup <key>              # press a key up on the keyboard

playwright-cli mousemove <x> <y>        # move mouse to a given position
playwright-cli mousedown [button]       # press mouse down
playwright-cli mouseup [button]         # press mouse up
playwright-cli mousewheel <dx> <dy>     # scroll mouse wheel

playwright-cli screenshot [ref]         # screenshot of the current page or element
playwright-cli screenshot --filename=f  # save screenshot with specific filename
playwright-cli pdf                      # save page as pdf
playwright-cli pdf --filename=page.pdf  # save pdf with specific filename

playwright-cli tab-list                 # list all tabs
playwright-cli tab-new [url]            # create a new tab
playwright-cli tab-close [index]        # close a browser tab
playwright-cli tab-select <index>       # select a browser tab

playwright-cli state-save [filename]    # save storage state
playwright-cli state-load <filename>    # load storage state
Cookies

playwright-cli cookie-list [--domain]   # list cookies
playwright-cli cookie-get <name>        # get a cookie
playwright-cli cookie-set <name> <val>  # set a cookie
playwright-cli cookie-delete <name>     # delete a cookie
playwright-cli cookie-clear             # clear all cookies
LocalStorage

playwright-cli localstorage-list        # list localStorage entries
playwright-cli localstorage-get <key>   # get localStorage value
playwright-cli localstorage-set <k> <v> # set localStorage value
playwright-cli localstorage-delete <k>  # delete localStorage entry
playwright-cli localstorage-clear       # clear all localStorage
SessionStorage

playwright-cli sessionstorage-list      # list sessionStorage entries
playwright-cli sessionstorage-get <k>   # get sessionStorage value
playwright-cli sessionstorage-set <k> <v> # set sessionStorage value
playwright-cli sessionstorage-delete <k>  # delete sessionStorage entry
playwright-cli sessionstorage-clear     # clear all sessionStorage

playwright-cli route <pattern> [opts]   # mock network requests
playwright-cli route-list               # list active routes
playwright-cli unroute [pattern]        # remove route(s)

playwright-cli console [min-level]      # list console messages
playwright-cli network                  # list all network requests since loading the page
playwright-cli run-code <code>          # run playwright code snippet
playwright-cli run-code --filename=f    # run playwright code from a file
playwright-cli tracing-start            # start trace recording
playwright-cli tracing-stop             # stop trace recording
playwright-cli video-start [filename]   # start video recording
playwright-cli video-chapter <title>    # add a chapter marker to the video
playwright-cli video-stop               # stop video recording

playwright-cli open --browser=chrome    # use specific browser
playwright-cli attach --extension       # connect via browser extension
playwright-cli attach --cdp=chrome      # attach to running Chrome/Edge by channel
playwright-cli attach --cdp=<url>       # attach via CDP endpoint
playwright-cli open --persistent        # use persistent profile
playwright-cli open --profile=<path>    # use custom profile directory
playwright-cli open --config=file.json  # use config file
playwright-cli close                    # close the browser
playwright-cli delete-data              # delete user data for default session

playwright-cli goto https://example.com

Page  Copy Section

- Page URL: https://example.com/
- Page Title: Example Domain
Snapshot  Copy Section

Snapshot

default - save to a file with timestamp-based name

playwright-cli snapshot
save to file, use when snapshot is a part of the workflow result

playwright-cli snapshot --filename=after-click.yaml
snapshot an element instead of the whole page

playwright-cli snapshot "#main"
limit snapshot depth for efficiency, take a partial snapshot afterwards

playwright-cli snapshot --depth=4
playwright-cli snapshot e34

get snapshot with refs

playwright-cli snapshot
interact using a ref

playwright-cli click e15

css selector

playwright-cli click "#main > button.submit"
role locator

playwright-cli click "getByRole('button', { name: 'Submit' })"
test id

playwright-cli click "getByTestId('submit-button')"

playwright-cli -s=name <cmd>            # run command in named session
playwright-cli -s=name close            # stop a named browser
playwright-cli -s=name delete-data      # delete user data for named browser
playwright-cli list                     # list all sessions
playwright-cli close-all                # close all browsers
playwright-cli kill-all                 # forcefully kill all browser processes

npx --no-install playwright-cli --version

npm install -g @playwright/cli@latest

playwright-cli --config path/to/config.json open example.com

{
  /
   * The browser to use.
   */
  browser?: {
    /
     * The type of browser to use.
     */
    browserName?: 'chromium' | 'firefox' | 'webkit';
    /
     * Keep the browser profile in memory, do not save it to disk.
     */
    isolated?: boolean;
    /
     * Path to a user data directory for browser profile persistence.
     * Temporary directory is created by default.
     */
    userDataDir?: string;
    /
     * Launch options passed to
     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
     *
     * This is useful for settings options like channel, headless, executablePath, etc.
     */
    launchOptions?: playwright.LaunchOptions;
    /
     * Context options for the browser context.
     *
     * This is useful for settings options like viewport.
     */
    contextOptions?: playwright.BrowserContextOptions;
    /
     * Chrome DevTools Protocol endpoint to connect to an existing browser instance in case of Chromium family browsers.
     */
    cdpEndpoint?: string;
    /
     * CDP headers to send with the connect request.
     */
    cdpHeaders?: Record<string, string>;
    /
     * Timeout in milliseconds for connecting to CDP endpoint. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
     */
    cdpTimeout?: number;
    /
     * Remote endpoint to connect to an existing Playwright server.
     */
    remoteEndpoint?: string;
    /
     * Paths to TypeScript files to add as initialization scripts for Playwright page.
     */
    initPage?: string[];
    /
     * Paths to JavaScript files to add as initialization scripts.
     * The scripts will be evaluated in every page before any of the page's scripts.
     */
    initScript?: string[];
  },
  /
   * If specified, saves the Playwright video of the session into the output directory.
   */
  saveVideo?: {
    width: number;
    height: number;
  };
  /
   * The directory to save output files.
   */
  outputDir?: string;
  /
   * Whether to save snapshots, console messages, network logs and other session logs to a file or to the standard output. Defaults to "stdout".
   */
  outputMode?: 'file' | 'stdout';
  console?: {
    /
     * The level of console messages to return. Each level includes the messages of more severe levels. Defaults to "info".
     */
    level?: 'error' | 'warning' | 'info' | 'debug';
  },
  network?: {
    /
     * List of origins to allow the browser to request. Default is to allow all. Origins matching both allowedOrigins and blockedOrigins will be blocked.
     */
    allowedOrigins?: string[];
    /
     * List of origins to block the browser to request. Origins matching both allowedOrigins and blockedOrigins will be blocked.
     */
    blockedOrigins?: string[];
  };
  /
   * Specify the attribute to use for test ids, defaults to "data-testid".
   */
  testIdAttribute?: string;
  timeouts?: {
    /*
     * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
     */
    action?: number;
    /*
     * Configures default navigation timeout: https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout. Defaults to 60000ms.
     */
    navigation?: number;
  };
  /
   * Whether to allow file uploads from anywhere on the file system.
   * By default (false), file uploads are restricted to paths within the MCP roots only.
   */
  allowUnrestrictedFileAccess?: boolean;
  /
   * Specify the language to use for code generation.
   */
  codegen?: 'typescript' | 'none';
}