Tags · microsoft/playwright-cli

v0.1.21

chore: mark v0.1.21 (#469)

## ✨ Highlights

- **🎬 Smooth 60 fps, styleable videos** — `video-start --fps=60` records
smooth 60 fps videos instead of the default 25, and `video-start
--cursor` renders an animated mouse cursor that travels to each action
point and stays visible between actions. `video-show-actions` takes
`--point-style`, `--highlight-style` and `--title-style` CSS
declarations; the action point marker and the target highlight are now
only shown when styled.
([microsoft/playwright#42752](microsoft/playwright#42752),
[microsoft/playwright#42758](microsoft/playwright#42758))
- **🧰 WebMCP tools show up in the snapshot** — the tools a page
registers are listed at the top of the page snapshot with their
descriptions and input schemas, so `webmcp-call` can be used without
running `webmcp-list` first. Set `webmcp: false` in the config file (env
`PLAYWRIGHT_MCP_WEBMCP=false`) to stop collecting page-registered tools.
([microsoft/playwright#42671](microsoft/playwright#42671))
- **🌗 Switch between light and dark color scheme**
([microsoft/playwright#42243](microsoft/playwright#42243))
— an agent working on a dark theme had no way to see it mid-session. New
`set-color-scheme`, `set-reduced-motion`, `set-forced-colors`,
`set-contrast` and `set-media` commands emulate media features on the
fly, and the matching `clear-*` commands reset them.
([microsoft/playwright#42668](microsoft/playwright#42668))
- **📁 Absolute paths in results**
([microsoft/playwright#42497](microsoft/playwright#42497))
— links to snapshots, screenshots, console logs and downloads are
relative to the working directory, which a consumer without one cannot
resolve. Set `filePaths: "absolute"` in the config file (env
`PLAYWRIGHT_MCP_FILE_PATHS=absolute`) to get absolute paths instead.
([microsoft/playwright#42673](microsoft/playwright#42673))

## 🐛 Fixes

- `fix(chromium): bypass service workers on the storage state page` —
`state-save` no longer runs the site's own scripts, or fails when they
redirect, for origins with an active service worker
([microsoft/playwright#42656](microsoft/playwright#42656)).
([#42664](microsoft/playwright#42664),
[#42741](microsoft/playwright#42741))
- `fix(mcp): keep upload modal, skip short secrets and bad headers` — a
failed `upload` keeps the file chooser open so it can be retried,
secrets shorter than 4 characters no longer rewrite the whole output
with `<secret>` markers, and `route` ignores header lines that have no
name. ([#42713](microsoft/playwright#42713))

## 📦 Upgrading

```bash
npm install -g @playwright/cli@0.1.21
```

Sep 18, 2026
74354ec
zip
tar.gz
Notes

v0.1.20

chore: mark v0.1.20 (#467)

## What's New

### 🎉 New Commands

- **`webmcp-list` / `webmcp-call`** — List and call the tools a page
registers through the
[WebMCP](https://webmachinelearning.github.io/webmcp/) API, letting the
page do the work instead of driving its UI. When a page has WebMCP
tools, the page status reports how many are available
([#42613](microsoft/playwright#42613)). WebMCP
is experimental, see [WebMCP in
Chrome](https://developer.chrome.com/docs/ai/webmcp) for how to enable
it.

### Other Changes

- Headless sessions now shut down after one hour without commands, so a
session an agent never closed no longer holds a browser; run `open`
again to start a new one. Use `open --idle-timeout <ms>` (config
`timeouts.idle`, env `PLAYWRIGHT_MCP_IDLE_TIMEOUT`) to change the
timeout, `0` disables it. Headed browsers stay open, and attached
browsers are only detached when `attach --idle-timeout <ms>` is set
([#42676](microsoft/playwright#42676))
- The skill includes a guide for attaching screenshots and videos to
pull requests with `gh --attach`
([#42645](microsoft/playwright#42645))

## Bug Fixes

- Session daemons exit when their control socket is deleted or replaced,
instead of staying alive with the browser
([#42454](microsoft/playwright#42454))
- Explicitly named output files in a nested directory (e.g. `screenshot
--filename=sub/shot.png`) no longer fail with `ENOENT`
([#42540](microsoft/playwright#42540))
- Video chapters and screencast overlays are no longer hidden behind
open dialogs and popovers
([#42642](microsoft/playwright#42642))
- `npx playwright test --debug=cli` works for tests that create more
than one browser context and for every test in a worker, not just the
first ([#42503](microsoft/playwright#42503))
- With `PLAYWRIGHT_MCP_EXTENSION_TOKEN` set, `attach --extension` fails
after 30 seconds with a hint when the extension never connects (e.g. the
token belongs to another Chrome profile) instead of hanging forever
([#42525](microsoft/playwright#42525))
- Disable the Chromium sandbox by default on Linux for the bundled
Chromium build, which lacks the setuid sandbox helper
([#42490](microsoft/playwright#42490))

## Upgrading

```bash
npm install -g @playwright/cli@0.1.20
```