docs: release notes for v1.62 by dcrousso · Pull Request #41940 · microsoft/playwright

dcrousso · 2026-07-22T18:18:45Z

Release notes for the upcoming v1.62 release.

Highlights

New component testing model — stories & galleries with the new mount fixture
AbortSignal support on operations and web-first assertions (signal option)
WebP screenshots — store toHaveScreenshot() snapshots as .webp
Reporter.preprocess() hook for custom test filtering
Isolated retries via retryStrategy: 'isolated'

Also includes

New APIs: WebAuthn passkeys in storage state (storageState.credentials), APIResponse.timing(), Locator.waitForFunction(), functions as evaluate/addInitScript args, scroll action option
CLI/MCP: Playwright now bundles the MCP server and playwright-cli (npx playwright mcp / npx playwright cli)
HTML reporter mergeFiles config option
Announcement: Debian 11 is no longer supported
Browser versions: Chromium 151.0.7922.34, Firefox 153.0, WebKit 26.5

Validated locally with npm run doc.

dgozman · 2026-07-22T19:02:17Z

+
+- The HTML reporter gains a `mergeFiles` option to merge results from multiple files into a single grouped view.
+
+### 🛠️ Other improvements


I'd drop this whole section.

dgozman · 2026-07-22T19:02:32Z

+
+- Docker images now split browser layers and use zstd compression for faster pulls.
+- Video recording wraps frames with explicit Matroska timestamps for more accurate frame timing.
+


We should tell that Debian 11 is not supported anymore.

dgozman · 2026-07-22T19:03:15Z

+
+#### Command line & MCP
+
+- `npx playwright mcp` is now exposed, and `npx playwright cli` is unhidden.


I think this one should be a bit bigger, saying that playwright now bundles mcp and cli and link to the documenation of those.

dgozman · 2026-07-22T19:03:30Z

+#### Command line & MCP
+
+- `npx playwright mcp` is now exposed, and `npx playwright cli` is unhidden.
+- The MCP server gains a `browser_find` tool to search the page snapshot.


I'd skip this and next one though.

dgozman · 2026-07-22T19:04:51Z

+
+Providing a signal does not disable the default timeout; pass `timeout: 0` to disable it.
+
+### 🔑 WebAuthn credentials in storage state


This is minor, I'd put into under new APIs section, framing it as a new option BrowserContext.storageState.credentials.

dgozman · 2026-07-22T19:05:21Z

+
+#### Screenshots
+
+- Screenshots now support a `webp` output `type`. For WebP, quality `100` (the default) is lossless, while lower values use lossy compression.


I think this one deserves a highlight, featuring toHaveScreenshot().

yury-s · 2026-07-22T19:13:14Z

+
+#### Reporters
+
+- The HTML reporter gains a `mergeFiles` option to merge results from multiple files into a single grouped view.


we should clarify that this is a config option (as opposed to already existing ui one) and maybe include a config snippet?

yury-s · 2026-07-22T19:14:39Z

+
+#### Screenshots
+
+- Screenshots now support a `webp` output `type`. For WebP, quality `100` (the default) is lossless, while lower values use lossy compression.


include a code snippet

yury-s · 2026-07-22T19:16:46Z

 import LiteYouTube from '@site/src/components/LiteYouTube';

+## Version 1.62
+


I think we need component testing update to go first

yury-s · 2026-07-22T20:16:03Z

+
+- New `scroll` option (`"auto"` | `"none"`) on actions to opt out of Playwright's automatic scroll-into-view.
+
+#### Network


I don't see the new option added in #41294, also should we discuss it in the api review?

ooo good catch! apologies for missing that

yury-s · 2026-07-23T20:26:20Z

+snapshots are lossless like PNG, but noticeably smaller, which keeps your snapshot directory lean:
+
+```js
+// Visual comparisons store the golden snapshot as lossless WebP (smaller than PNG).


Suggested change

// Visual comparisons store the golden snapshot as lossless WebP (smaller than PNG).

// Visual comparisons store the golden snapshot as lossless WebP.

Dmitry was asking me to remove similar assertions from the docs, let the users decide if they need it.

yury-s · 2026-07-23T20:31:37Z

+
+### 🧱 New component testing model
+
+Component testing moves to a **stories and galleries** model. A **story** wraps your component


We need a link to the guide. Also we should say more about the new approach not depending on the bundler integration and supporting more frameworks. I think it makes sense to also mention that this new api is stable (unlike previous experimental api that we want to drop).

Release notes for the upcoming **v1.62** release. ### Highlights - **New component testing model** — stories & galleries with the new `mount` fixture - **AbortSignal** support on operations and web-first assertions (`signal` option) - **WebP screenshots** — store `toHaveScreenshot()` snapshots as `.webp` - **`Reporter.preprocess()`** hook for custom test filtering - **Isolated retries** via `retryStrategy: 'isolated'` ### Also includes - New APIs: WebAuthn passkeys in storage state (`storageState.credentials`), `APIResponse.timing()`, `Locator.waitForFunction()`, functions as `evaluate`/`addInitScript` args, `scroll` action option - CLI/MCP: Playwright now bundles the MCP server and `playwright-cli` (`npx playwright mcp` / `npx playwright cli`) - HTML reporter `mergeFiles` config option - Announcement: Debian 11 is no longer supported - Browser versions: Chromium 151.0.7922.34, Firefox 153.0, WebKit 26.5 Validated locally with `npm run doc`.

dgozman reviewed Jul 22, 2026

View reviewed changes

yury-s reviewed Jul 22, 2026

View reviewed changes

dcrousso force-pushed the release-notes-1.62 branch from 11da5ae to c6364c8 Compare July 22, 2026 19:41

dcrousso requested review from dgozman and yury-s July 22, 2026 20:03

yury-s reviewed Jul 22, 2026

View reviewed changes

dcrousso force-pushed the release-notes-1.62 branch 2 times, most recently from 1f5a9e0 to c273255 Compare July 23, 2026 20:07

dcrousso requested a review from yury-s July 23, 2026 20:08

yury-s approved these changes Jul 23, 2026

View reviewed changes

dcrousso force-pushed the release-notes-1.62 branch 3 times, most recently from 0bcd067 to 0112ba9 Compare July 23, 2026 21:16

docs: release notes for v1.62

53db670

dcrousso force-pushed the release-notes-1.62 branch from 0112ba9 to 53db670 Compare July 23, 2026 21:30

dcrousso merged commit 28e8676 into microsoft:main Jul 23, 2026
3 checks passed

dcrousso deleted the release-notes-1.62 branch July 23, 2026 21:35


		- The HTML reporter gains a `mergeFiles` option to merge results from multiple files into a single grouped view.

		### 🛠️ Other improvements


		- Docker images now split browser layers and use zstd compression for faster pulls.
		- Video recording wraps frames with explicit Matroska timestamps for more accurate frame timing.


		#### Command line & MCP

		- `npx playwright mcp` is now exposed, and `npx playwright cli` is unhidden.


		Providing a signal does not disable the default timeout; pass `timeout: 0` to disable it.

		### 🔑 WebAuthn credentials in storage state


		#### Screenshots

		- Screenshots now support a `webp` output `type`. For WebP, quality `100` (the default) is lossless, while lower values use lossy compression.


		#### Reporters

		- The HTML reporter gains a `mergeFiles` option to merge results from multiple files into a single grouped view.

		import LiteYouTube from '@site/src/components/LiteYouTube';

		## Version 1.62


		- New `scroll` option (`"auto"` \| `"none"`) on actions to opt out of Playwright's automatic scroll-into-view.

		#### Network

	// Visual comparisons store the golden snapshot as lossless WebP (smaller than PNG).
	// Visual comparisons store the golden snapshot as lossless WebP.


		### 🧱 New component testing model

		Component testing moves to a stories and galleries model. A story wraps your component

Uh oh!

Conversation

dcrousso commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Highlights

Also includes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

dcrousso commented Jul 22, 2026 •

edited

Loading