Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

docs: release notes for v1.63 (#42552)

Yury Semikhatskyfe49b34b2377
diff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.md
index 4d7b63fdcb..a2500f6dd4 100644
--- a/docs/src/release-notes-js.md
+++ b/docs/src/release-notes-js.md
@@ -6,6 +6,130 @@ toc_max_heading_level: 2
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.63
+
+### 🔒 Test locks
+
+Tests that access a shared resource — an external service, a global account setting — can now declare a named `lock`.
+Tests that share a lock name never run concurrently, across files, workers and [projects](./test-projects.md), while
+everything else keeps running in parallel:
+
+```js
+test('update user settings', { lock: 'user-settings' }, async ({ page }) => {
+ // never runs at the same time as other tests holding 'user-settings'
+});
+```
+
+A test can hold multiple locks, and [`method: Test.describe`] accepts a `lock` for the whole group.
+Learn more about [test locks](./test-parallel.md#test-locks).
+
+### 🪟 Locate across frames
+
+[`method: Page.frameLocator`] and [`method: Frame.frameLocator`] called without a selector search in any frame of the
+subtree, so you no longer need to locate the iframe first:
+
+```js
+// Finds the button in any frame on the page.
+await page.frameLocator().getByRole('button').click();
+```
+
+The rest of the locator resolves inside a single frame, just like a regular locator, and an error is thrown when it
+matches elements in several frames.
+
+### 👁️ Visible-only locators
+
+New [`method: Locator.visible`] returns a locator that matches only visible elements. It is the recommended
+replacement for the `:visible` CSS pseudo-class:
+
+```js
+await page.locator('button').visible().click();
+```
+
+### 🧾 Step params and subtitles
+
+Steps now carry structured data for reporters. Playwright API steps report the target locator and call arguments,
+and [`method: Test.step`] accepts `subtitle` and `params` options for your own steps:
+
+```js
+await test.step('Login', async () => {
+ // ...
+}, { subtitle: 'as admin', params: { user: 'admin' } });
+```
+
+Reporters receive them via [`property: TestStep.subtitle`] and [`property: TestStep.params`]. For Playwright API
+steps, the subtitle is the locator or the navigation url — for example, `Click` with subtitle `getByRole('button')`.
+Both are rendered next to the step title in the trace viewer and the HTML report.
+
+### 🖼️ Aria and screen snapshots in traces
+
+The `snapshots` option of [`method: Tracing.start`] and the [`property: TestOptions.trace`] fixture option now accept an
+object selecting what to capture on every action:
+
+```js title="playwright.config.ts"
+export default defineConfig({
+ use: {
+ trace: {
+ mode: 'on',
+ snapshots: { dom: true, aria: true, screen: true }
+ },
+ },
+});
+```
+
+With aria and screen snapshots recorded, the new **Display Aria** mode in the trace viewer shows the action screenshot
+side by side with the aria snapshot, and hovering an aria node highlights it on the screenshot.
+
+### New APIs
+
+#### Browser and Context
+
+- [`option: Browser.newContext.httpCredentials`] now also accepts an array of credentials. The first entry matching the request origin is used, and entries without an origin match any request.
+- New option [`option: BrowserContext.storageState.opfs`] includes the [origin private file system](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) in the storage state, so it can be persisted and restored into later contexts.
+- New events [`event: Page.dialogClosed`] and [`event: BrowserContext.dialogClosed`] are emitted when a JavaScript dialog is accepted, dismissed or closed by the user.
+
+#### Locators
+
+- New [`method: Locator.ariaSnapshotJSON`] and [`method: Page.ariaSnapshotJSON`] return the aria snapshot as a JSON value instead of YAML markup, with `mode`, `depth` and `boxes` options.
+- [`method: APIRequestContext.get`] and other request methods accept a type argument that types the response `json()`:
+
+```js
+const response = await request.get<User>('/api/users/42');
+const user = await response.json(); // typed as User
+```
+
+#### Test runner
+
+- New standalone [`property: TestOptions.reducedMotion`], [`property: TestOptions.forcedColors`] and [`property: TestOptions.contrast`] options.
+- New `--add-reporter` command line option appends a reporter on top of the ones configured in `playwright.config`, instead of replacing them like `--reporter` does.
+- New `omitTags` option for the `list`, `line`, `dot`, `github` and `junit` reporters suppresses the tags that are automatically appended to test titles.
+
+#### Command line
+
+- `npx playwright install --no-remove` keeps the browsers of other Playwright installations instead of removing them.
+- `npx playwright codegen --http-credentials` records against pages behind HTTP authentication.
+
+#### Miscellaneous
+
+- New built-in [`perfetto`](./test-reporters.md#perfetto-reporter) reporter writes a Trace Event Format file for the [Perfetto UI](https://ui.perfetto.dev) or `chrome://tracing`, rendering the test run as a timeline with a lane per worker.
+- The HTML report renders a duration waterfall next to test steps.
+
+### Announcements
+
+* ⚠️ The experimental `@playwright/experimental-ct-react`, `@playwright/experimental-ct-react17` and `@playwright/experimental-ct-vue` packages will no longer be updated. Follow the [migration guide](./test-components.md#migration-from-the-experimental-packages) to move to the stories model introduced in 1.62. Story ids passed to [`method: Fixtures.mount`] can now be typed through the generated `Stories` registry.
+* ⚠️ Ubuntu 20.04 is not supported anymore.
+* 🐧 On Linux arm64, Playwright now downloads the [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) build of Chromium, the same build used on all other platforms.
+
+### Browser Versions
+
+- Chromium 153.0.8010.12
+- Mozilla Firefox 155.0
+- WebKit 26.6
+
+This version was also tested against the following stable channels:
+
+- Google Chrome 153
+- Microsoft Edge 153
+
## Version 1.62
### 🧱 New component testing model