✨ Highlights
- 🗂️ Identify and resume your extension sessions (#496) —
playwright-cli attach --extension=chrome --session=docs-review --session-color=bluelabels the tab group with your session name instead of a truncated product name. Disconnected groups remain available to select on the next connection. Use--no-tab-groupto leave your existing tab organization alone. (microsoft/playwright#44047) - 🧹 Close an agent's tabs when its work is done —
playwright-cli -s=docs-review detach --close-tabscloses that extension session's tabs before disconnecting. Plaindetachstill leaves the tabs open for later. (microsoft/playwright#44084) - 🖥️ Install stable Chrome on Linux ARM64 (microsoft/playwright#43998) —
playwright-cli install-browser chromenow installs Google's ARM64 Debian package instead of rejecting the architecture. (microsoft/playwright#44020)
🐛 Fixes
fix(server): do not reveal the endpoint path over HTTP— attaching to a Playwright browser server with--endpointnow requires its fullws://orwss://endpoint, including the path; HTTP endpoint discovery has been removed. HTTP URLs for--cdpare unaffected. (microsoft/playwright#44190)fix(mcp): do not wait for busy pages longer than 10s when connecting over CDP— a busy existing tab no longer blocksplaywright-cli attach --cdp=http://localhost:9222indefinitely. Pages that cannot initialize within 10 seconds are made available later when they respond. (microsoft/playwright#44052, microsoft/playwright#44105)fix(cli): suggest matching ffmpeg installer for video recording— whenvideo-startneeds ffmpeg, its error now recommendsplaywright-cli install-browser ffmpeg, which installs the revision used by the CLI. (#540, microsoft/playwright#44088)fix(mcp): validate run-code input—playwright-cli run-codewithout code or--filenamereports a clear input error instead of an internalTypeError. (microsoft/playwright#44080, microsoft/playwright#44087)fix(locator): select among visible elements in first/last/nth with locateOnlyVisible— withbrowser.contextOptions.locateOnlyVisibleenabled, locators used inrun-codeapplyfirst(),last()andnth()to visible matches instead of selecting a hidden element and finding nothing. Explicit visibility filters still take precedence. (microsoft/playwright#43855, microsoft/playwright#44083)fix(chromium): apply timezone to service workers— Chromium service workers honorbrowser.contextOptions.timezoneIdfrom their first statement, keeping date handling consistent with pages. (microsoft/playwright#43983, microsoft/playwright#44021)fix(tracing): hold dropped screencast frames while throttling— recording withplaywright-cli tracing-startuses less browser CPU on idle animated pages without changing the frames kept in the trace. (microsoft/playwright#44053, microsoft/playwright#44068)fix(trace-viewer): harden snapshot rendering— Trace Viewer blocks navigation and form submission from recorded snapshots. Trace-file routes also reject frame navigations, and its server checks WebSocket origins. (microsoft/playwright#44177, microsoft/playwright#44178)
📦 Upgrading
Node.js 20 or newer is required.
npm install -g @playwright/cli@0.1.25