npm / @playwright/cli
@playwright/cli
What changed in @playwright/cli 0.1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
4 breaking1 security19 new APIs and options4 behavior and defaults15 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@playwright/cli 0.143 changes
Breaking changes 4
Works with Chromium 155 and later.
Adds CSS styling for the target highlight; the highlight is shown only when styled.
Adds CSS styling for action point markers; the marker is shown only when styled.
Headless sessions shut down after one hour without commands, so an unclosed session no longer holds a browser; headed browsers stay open.
Security 1
Preapproves Playwright commands only, rather than any npm or npx command.
New APIs and options 19
When a query produces too many matches,
--filenamesaves them to a file.Set filePaths to "absolute" in the config file to get absolute paths for snapshots, screenshots, console logs, and downloads.
Set PLAYWRIGHT_MCP_FILE_PATHS=absolute to get absolute paths for snapshots, screenshots, console logs, and downloads.
Set PLAYWRIGHT_MCP_WEBMCP=false to stop collecting page-registered tools.
Emulates a color scheme on the fly, letting an agent switch between light and dark during a session.
Emulates the contrast media feature on the fly.
Emulates the forced-colors media feature on the fly.
Emulates media features on the fly.
Emulates the reduced-motion media feature on the fly.
Adds CSS declarations for styling video action titles.
The --cursor option renders an animated mouse cursor that travels to each action point and stays visible between actions.
The --fps option records videos at a chosen frame rate; --fps=60 records smooth 60 fps videos instead of the default 25.
Set webmcp to false in the config file to stop collecting page-registered tools.
Sets an idle timeout for attached browsers; they are only detached when this option is set.
Sets the idle timeout for a headless session; 0 disables the timeout.
Sets the idle timeout for a headless session; 0 disables the timeout.
Configures the idle timeout for a headless session; 0 disables the timeout.
Calls tools a page registers through the WebMCP API, letting the page do the work instead of driving its UI.
Lists the tools a page registers through the WebMCP API.
Behavior and default changes 4
Scripts can use timers, fetch, URL, Buffer, crypto, AbortController, TextEncoder, and TextDecoder; require and process remain unavailable.
Page-registered WebMCP tools, descriptions, and input schemas appear at the top of the snapshot, so webmcp-call works without first running webmcp-list.
The Chromium sandbox is disabled by default on Linux for the bundled Chromium build, which lacks the setuid sandbox helper.
Session daemons exit when their control socket is deleted or replaced instead of staying alive with the browser.
Fixes and other changes 15
The session no longer crashes if the browser closes during a download.
Reports a dialog opened during page load instead of timing out.
Accepts
--no-shellinstead of failing with an unknown-option error.Reports a dialog opened during page load instead of timing out.
Quotes accessible names that look like regular expressions.
No longer runs a tool in a stale tab or frame.
Matching clear-* commands reset media feature emulation.
route ignores header lines that have no name.
Secrets shorter than 4 characters no longer rewrite the whole output with <secret> markers.
state-save bypasses service workers on the storage state page, avoiding site scripts and failures when they redirect.
A failed upload keeps the file chooser open so the upload can be retried.
When the extension does not connect, attach fails after 30 seconds with a hint instead of hanging indefinitely.
The CLI debugger works for tests that create multiple browser contexts and for every test in a worker.
Explicitly named output files in nested directories no longer fail with ENOENT.
Video chapters and screencast overlays remain visible above open dialogs and popovers.