microsoft · playwrightmachine · Mar 11, 2025 · Mar 11, 2025
diff --git a/dotnet/docs/api/class-locator.mdx b/dotnet/docs/api/class-locator.mdx
@@ -125,6 +125,9 @@ await page.GetByRole(AriaRole.Link).AriaSnapshotAsync();
 
 **Arguments**
 - `options` `LocatorAriaSnapshotOptions?` *(optional)*
+  - `Ref` [bool]? *(optional)* <font size="2">Added in: v1.52</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-ref"/><a href="#locator-aria-snapshot-option-ref" class="list-anchor">#</a>
+
+    Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the snapshot to perform actions on the element.
   - `Timeout` [float]? *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-timeout"/><a href="#locator-aria-snapshot-option-timeout" class="list-anchor">#</a>
 
     Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.SetDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout) or [Page.SetDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods.

diff --git a/dotnet/docs/debug.mdx b/dotnet/docs/debug.mdx
@@ -96,7 +96,7 @@ Playwright [Trace Viewer](/trace-viewer.mdx) is a GUI tool that lets you explore
 
 <video width="100%" height="100%" controls muted>
 
-<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" /> Your browser does not support the video tag.
+<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" />
 
 </video>
 

diff --git a/dotnet/docs/intro.mdx b/dotnet/docs/intro.mdx
@@ -222,7 +222,7 @@ See our doc on [Running and Debugging Tests](./running-tests.mdx) to learn more
 ## System requirements
 - Playwright is distributed as a .NET Standard 2.0 library. We recommend .NET 8.
 - Windows 10+, Windows Server 2016+ or Windows Subsystem for Linux (WSL).
-- macOS 13 Ventura, or later.
+- macOS 14 Ventura, or later.
 - Debian 12, Ubuntu 22.04, Ubuntu 24.04, on x86-64 and arm64 architecture.
 
 ## What's next

diff --git a/java/docs/api/class-locator.mdx b/java/docs/api/class-locator.mdx
@@ -125,6 +125,9 @@ page.getByRole(AriaRole.LINK).ariaSnapshot();
 
 **Arguments**
 - `options` `Locator.AriaSnapshotOptions` *(optional)*
+  - `setRef` [boolean] *(optional)* <font size="2">Added in: v1.52</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-ref"/><a href="#locator-aria-snapshot-option-ref" class="list-anchor">#</a>
+
+    Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the snapshot to perform actions on the element.
   - `setTimeout` [double] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-timeout"/><a href="#locator-aria-snapshot-option-timeout" class="list-anchor">#</a>
 
     Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.setDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout) or [Page.setDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods.

diff --git a/java/docs/debug.mdx b/java/docs/debug.mdx
@@ -105,7 +105,7 @@ Playwright [Trace Viewer](/trace-viewer.mdx) is a GUI tool that lets you explore
 
 <video width="100%" height="100%" controls muted>
 
-<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" /> Your browser does not support the video tag.
+<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" />
 
 </video>
 

diff --git a/java/docs/intro.mdx b/java/docs/intro.mdx
@@ -129,7 +129,7 @@ By default browsers launched with Playwright run headless, meaning no browser UI
 ## System requirements
 - Java 8 or higher.
 - Windows 10+, Windows Server 2016+ or Windows Subsystem for Linux (WSL).
-- macOS 13 Ventura, or later.
+- macOS 14 Ventura, or later.
 - Debian 12, Ubuntu 22.04, Ubuntu 24.04, on x86-64 and arm64 architecture.
 
 ## What's next

diff --git a/nodejs/docs/api/class-locator.mdx b/nodejs/docs/api/class-locator.mdx
@@ -125,6 +125,9 @@ await page.getByRole('link').ariaSnapshot();
 
 **Arguments**
 - `options` [Object] *(optional)*
+  - `ref` [boolean] *(optional)* <font size="2">Added in: v1.52</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-ref"/><a href="#locator-aria-snapshot-option-ref" class="list-anchor">#</a>
+
+    Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the snapshot to perform actions on the element.
   - `timeout` [number] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-timeout"/><a href="#locator-aria-snapshot-option-timeout" class="list-anchor">#</a>
 
     Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout` option in the config, or by using the [browserContext.setDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout) or [page.setDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods.

diff --git a/nodejs/docs/api/class-testconfig.mdx b/nodejs/docs/api/class-testconfig.mdx
@@ -1006,12 +1006,14 @@ export default defineConfig({
     {
       command: 'npm run start',
       url: 'http://localhost:3000',
+      name: 'Frontend',
       timeout: 120 * 1000,
       reuseExistingServer: !process.env.CI,
     },
     {
       command: 'npm run backend',
       url: 'http://localhost:3333',
+      name: 'Backend',
       timeout: 120 * 1000,
       reuseExistingServer: !process.env.CI,
     }
@@ -1062,6 +1064,9 @@ export default defineConfig({
   - `url` [string] *(optional)*
 
     The url on your http server that is expected to return a 2xx, 3xx, 400, 401, 402, or 403 status code when the server is ready to accept connections. Redirects (3xx status codes) are being followed and the new location is checked. Either `port` or `url` should be specified.
+  - `name` [string] *(optional)*
+
+    Specifies a custom name for the web server. This name will be prefixed to log messages. Defaults to `[WebServer]`.
 
 **Details**
 

diff --git a/nodejs/docs/debug.mdx b/nodejs/docs/debug.mdx
@@ -148,7 +148,7 @@ Playwright [Trace Viewer](/trace-viewer.mdx) is a GUI tool that lets you explore
 
 <video width="100%" height="100%" controls muted>
 
-<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" /> Your browser does not support the video tag.
+<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" />
 
 </video>
 

diff --git a/nodejs/docs/intro.mdx b/nodejs/docs/intro.mdx
@@ -247,7 +247,7 @@ pnpm exec playwright --version
 ## System requirements
 - Latest version of Node.js 18, 20 or 22.
 - Windows 10+, Windows Server 2016+ or Windows Subsystem for Linux (WSL).
-- macOS 13 Ventura, or later.
+- macOS 14 Ventura, or later.
 - Debian 12, Ubuntu 22.04, Ubuntu 24.04, on x86-64 and arm64 architecture.
 
 ## What's next

diff --git a/nodejs/docs/test-webserver.mdx b/nodejs/docs/test-webserver.mdx
@@ -41,6 +41,7 @@ export default defineConfig({
 | `stderr` | Whether to pipe the stderr of the command to the process stderr or ignore it. Defaults to `"pipe"`. |
 | `timeout` | How long to wait for the process to start up and be available in milliseconds. Defaults to 60000. |
 | `gracefulShutdown` | How to shut down the process. If unspecified, the process group is forcefully `SIGKILL`ed. If set to `{ signal: 'SIGTERM', timeout: 500 }`, the process group is sent a `SIGTERM` signal, followed by `SIGKILL` if it doesn't exit within 500ms. You can also use `SIGINT` as the signal instead. A `0` timeout means no `SIGKILL` will be sent. Windows doesn't support `SIGTERM` and `SIGINT` signals, so this option is ignored on Windows. Note that shutting down a Docker container requires `SIGTERM`. |
+| `name` | Specifies a custom name for the web server. This name will be prefixed to log messages. Defaults to `[WebServer]`. |
 
 ## Adding a server timeout
 
@@ -109,12 +110,14 @@ export default defineConfig({
     {
       command: 'npm run start',
       url: 'http://localhost:3000',
+      name: 'Frontend',
       timeout: 120 * 1000,
       reuseExistingServer: !process.env.CI,
     },
     {
       command: 'npm run backend',
       url: 'http://localhost:3333',
+      name: 'Backend',
       timeout: 120 * 1000,
       reuseExistingServer: !process.env.CI,
     }

diff --git a/python/docs/api/class-locator.mdx b/python/docs/api/class-locator.mdx
@@ -225,6 +225,9 @@ await page.get_by_role("link").aria_snapshot()
 </Tabs>
 
 **Arguments**
+- `ref` [bool] *(optional)* <font size="2">Added in: v1.52</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-ref"/><a href="#locator-aria-snapshot-option-ref" class="list-anchor">#</a>
+
+  Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the snapshot to perform actions on the element.
 - `timeout` [float] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="locator-aria-snapshot-option-timeout"/><a href="#locator-aria-snapshot-option-timeout" class="list-anchor">#</a>
 
   Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can be changed by using the [browser_context.set_default_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout) or [page.set_default_timeout()](/api/class-page.mdx#page-set-default-timeout) methods.

diff --git a/python/docs/debug.mdx b/python/docs/debug.mdx
@@ -116,7 +116,7 @@ Playwright [Trace Viewer](/trace-viewer.mdx) is a GUI tool that lets you explore
 
 <video width="100%" height="100%" controls muted>
 
-<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" /> Your browser does not support the video tag.
+<source src="https://user-images.githubusercontent.com/13063165/219132713-17b9d75b-71e3-42c4-a43f-3f9e2e15f834.mp4" type="video/mp4" />
 
 </video>
 

diff --git a/python/docs/intro.mdx b/python/docs/intro.mdx
@@ -99,7 +99,7 @@ pip install pytest-playwright playwright -U
 ## System requirements
 - Python 3.8 or higher.
 - Windows 10+, Windows Server 2016+ or Windows Subsystem for Linux (WSL).
-- macOS 13 Ventura, or later.
+- macOS 14 Ventura, or later.
 - Debian 12, Ubuntu 22.04, Ubuntu 24.04, on x86-64 and arm64 architecture.
 
 ## What's next