diff --git a/dotnet/docs/api/class-browsertype.mdx b/dotnet/docs/api/class-browsertype.mdx
index 4727a92323..f5599e241f 100644
--- a/dotnet/docs/api/class-browsertype.mdx
+++ b/dotnet/docs/api/class-browsertype.mdx
@@ -116,6 +116,8 @@ var page = defaultContext.Pages[0];
- `endpointURL` [string] Added in: v1.11#
A CDP websocket endpoint or http url to connect to. For example `http://localhost:9222/` or `ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4`.
+
+ Alternatively, a browser channel name such as `chrome` or `msedge` to connect to a browser with remote debugging enabled in its default user data directory. On Linux, Playwright uses `CHROME_USER_DATA_DIR` when set. Otherwise, it uses `CHROME_CONFIG_HOME`, then `XDG_CONFIG_HOME`, then `~/.config` to locate that directory.
- `options` `BrowserTypeConnectOverCDPOptions?` *(optional)*
- `ArtifactsDir` [string]? *(optional)* Added in: v1.61#
diff --git a/dotnet/docs/release-notes.mdx b/dotnet/docs/release-notes.mdx
index 8e32c35380..98db0da3b5 100644
--- a/dotnet/docs/release-notes.mdx
+++ b/dotnet/docs/release-notes.mdx
@@ -9,6 +9,37 @@ import HTMLCard from '@site/src/components/HTMLCard';
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.65
+
+### 🧾 Locator code in C#
+
+A locator from [Locator.NormalizeAsync()](/api/class-locator.mdx#locator-normalize) now converts to a string as C# code. Use it with [Page.GetByRef()](/api/class-page.mdx#page-get-by-ref) to turn an element that an agent picks from a [Page.AriaSnapshotAsync()](/api/class-page.mdx#page-aria-snapshot) in the `"ai"` mode into code for your test:
+
+```csharp
+var normalized = await page.GetByRef("e2").NormalizeAsync();
+Console.WriteLine(normalized.ToString());
+// GetByRole(AriaRole.Button, new() { Name = "Submit" })
+```
+
+### New APIs
+- New option [Timeout](/api/class-cdpsession.mdx#cdp-session-send-option-timeout) in [CdpSession.SendAsync()](/api/class-cdpsession.mdx#cdp-session-send).
+
+### Breaking Changes ⚠️
+- Actions such as [Locator.ClickAsync()](/api/class-locator.mdx#locator-click), [Locator.CheckAsync()](/api/class-locator.mdx#locator-check), [Locator.TapAsync()](/api/class-locator.mdx#locator-tap), [Locator.FillAsync()](/api/class-locator.mdx#locator-fill), [Locator.ClearAsync()](/api/class-locator.mdx#locator-clear) and [Locator.SelectOptionAsync()](/api/class-locator.mdx#locator-select-option) now wait for the element to be [not inert](./actionability.mdx#not-inert). An action on an element with the `inert` attribute, or inside such an element, now times out if the element stays inert.
+- Cookie matching now follows RFC 6265. With a URL, [BrowserContext.CookiesAsync()](/api/class-browsercontext.mdx#browser-context-cookies) and [ApiRequestContext.CookiesAsync()](/api/class-apirequestcontext.mdx#api-request-context-cookies) no longer return host-only cookies for subdomains or `Path=/api` cookies for `/apiv2`, and a `Path=/foo/` cookie does not match `/foo`. [APIRequestContext] sends a cookie without a name as `Cookie: x` instead of `Cookie: =x`, and stores `Set-Cookie: token` as a cookie without a name.
+- Proxy credentials are no longer sent to websites. The credentials in the [Proxy](/api/class-browsertype.mdx#browser-type-launch-option-proxy) option now answer only proxy challenges. To authenticate on a website, use [HttpCredentials|HttpCredentialsList](/api/class-browser.mdx#browser-new-context-option-http-credentials).
+- Text that the browser does not render, such as text that is not assigned to a slot or text directly inside a closed ``, is no longer part of accessible names and aria snapshots. This can change the results of [Page.GetByRole()](/api/class-page.mdx#page-get-by-role) with a name, [Locator.AriaSnapshotAsync()](/api/class-locator.mdx#locator-aria-snapshot) and [Expect(Locator).ToMatchAriaSnapshotAsync()](/api/class-locatorassertions.mdx#locator-assertions-to-match-aria-snapshot).
+- The `ParamsString` option in [APIRequestContext] requests is now appended to the query that the URL already has, instead of replacing it.
+
+### Browser Versions
+- Chromium 158.0.8127.2
+- Mozilla Firefox 159.0
+- WebKit 27.2
+
+This version was also tested against the following stable channels:
+- Google Chrome 157
+- Microsoft Edge 156
+
## Version 1.64
### 🧰 WebMCP
diff --git a/java/docs/api/class-browsertype.mdx b/java/docs/api/class-browsertype.mdx
index b7d90f5fa5..18c5e9c70e 100644
--- a/java/docs/api/class-browsertype.mdx
+++ b/java/docs/api/class-browsertype.mdx
@@ -115,6 +115,8 @@ Page page = defaultContext.pages().get(0);
- `endpointURL` [String] Added in: v1.11#
A CDP websocket endpoint or http url to connect to. For example `http://localhost:9222/` or `ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4`.
+
+ Alternatively, a browser channel name such as `chrome` or `msedge` to connect to a browser with remote debugging enabled in its default user data directory. On Linux, Playwright uses `CHROME_USER_DATA_DIR` when set. Otherwise, it uses `CHROME_CONFIG_HOME`, then `XDG_CONFIG_HOME`, then `~/.config` to locate that directory.
- `options` `BrowserType.ConnectOverCDPOptions` *(optional)*
- `setArtifactsDir` [Path] *(optional)* Added in: v1.61#
diff --git a/java/docs/release-notes.mdx b/java/docs/release-notes.mdx
index 7606c87474..1aac53225f 100644
--- a/java/docs/release-notes.mdx
+++ b/java/docs/release-notes.mdx
@@ -9,6 +9,36 @@ import HTMLCard from '@site/src/components/HTMLCard';
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.65
+
+### 🧾 Locator code in Java
+
+A locator from [Locator.normalize()](/api/class-locator.mdx#locator-normalize) now converts to a string as Java code. Use it with [Page.getByRef()](/api/class-page.mdx#page-get-by-ref) to turn an element that an agent picks from a [Page.ariaSnapshot()](/api/class-page.mdx#page-aria-snapshot) in the `"ai"` mode into code for your test:
+
+```java
+Locator normalized = page.getByRef("e2").normalize();
+System.out.println(normalized.toString());
+// getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Submit"))
+```
+
+### New APIs
+- New option [setTimeout](/api/class-cdpsession.mdx#cdp-session-send-option-timeout) in [CDPSession.send()](/api/class-cdpsession.mdx#cdp-session-send).
+
+### Breaking Changes ⚠️
+- Actions such as [Locator.click()](/api/class-locator.mdx#locator-click), [Locator.check()](/api/class-locator.mdx#locator-check), [Locator.tap()](/api/class-locator.mdx#locator-tap), [Locator.fill()](/api/class-locator.mdx#locator-fill), [Locator.clear()](/api/class-locator.mdx#locator-clear) and [Locator.selectOption()](/api/class-locator.mdx#locator-select-option) now wait for the element to be [not inert](./actionability.mdx#not-inert). An action on an element with the `inert` attribute, or inside such an element, now times out if the element stays inert.
+- Cookie matching now follows RFC 6265. With a URL, [BrowserContext.cookies()](/api/class-browsercontext.mdx#browser-context-cookies) and [APIRequestContext.cookies()](/api/class-apirequestcontext.mdx#api-request-context-cookies) no longer return host-only cookies for subdomains or `Path=/api` cookies for `/apiv2`, and a `Path=/foo/` cookie does not match `/foo`. [APIRequestContext] sends a cookie without a name as `Cookie: x` instead of `Cookie: =x`, and stores `Set-Cookie: token` as a cookie without a name.
+- Proxy credentials are no longer sent to websites. The credentials in the [setProxy](/api/class-browsertype.mdx#browser-type-launch-option-proxy) option now answer only proxy challenges. To authenticate on a website, use [setHttpCredentials](/api/class-browser.mdx#browser-new-context-option-http-credentials).
+- Text that the browser does not render, such as text that is not assigned to a slot or text directly inside a closed ``, is no longer part of accessible names and aria snapshots. This can change the results of [Page.getByRole()](/api/class-page.mdx#page-get-by-role) with a name, [Locator.ariaSnapshot()](/api/class-locator.mdx#locator-aria-snapshot) and [assertThat(locator).matchesAriaSnapshot()](/api/class-locatorassertions.mdx#locator-assertions-to-match-aria-snapshot).
+
+### Browser Versions
+- Chromium 158.0.8127.2
+- Mozilla Firefox 159.0
+- WebKit 27.2
+
+This version was also tested against the following stable channels:
+- Google Chrome 157
+- Microsoft Edge 156
+
## Version 1.64
### 🧰 WebMCP
diff --git a/nodejs/docs/api/class-androiddevice.mdx b/nodejs/docs/api/class-androiddevice.mdx
index 38b56ed758..609c8ede4a 100644
--- a/nodejs/docs/api/class-androiddevice.mdx
+++ b/nodejs/docs/api/class-androiddevice.mdx
@@ -273,13 +273,6 @@ await androidDevice.launchBrowser(options);
- `locale` [string] *(optional)*#
Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default locale. Learn more about emulation in our [emulation guide](../emulation.mdx#locale--timezone).
- - `locatorOmitHidden` [boolean] *(optional)*#
-
- Whether locators omit hidden elements by default. Defaults to `false`. If set to `true`, each locator is resolved as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended: only the final matched element is checked for [visibility](../actionability.mdx#visible), not its intermediate ancestors. This affects actions, assertions, counts and element evaluation, but not selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
-
- Pass `omitHidden: false` when creating a locator to opt out. The override is preserved by `filter()`, `first()`, `last()`, `nth()`, `and()`, `or()` and `describe()`. Creating a descendant locator uses the context default again, unless an override is supplied for that descendant. Explicit visibility filters are never removed. Role locators still apply their accessibility matching rules; use `getByRole(..., { includeHidden: true, omitHidden: false })` to include hidden elements when this context option is enabled.
-
- With `true`, hidden elements are treated as missing by `toBeHidden()` and `waitFor({ state: 'hidden' })`. To check attachment of a hidden element, create the locator with `omitHidden: false`.
- `logger` [Logger] *(optional)*#
:::warning[Deprecated]
diff --git a/nodejs/docs/api/class-browser.mdx b/nodejs/docs/api/class-browser.mdx
index 3c5eb42deb..c939abe5c3 100644
--- a/nodejs/docs/api/class-browser.mdx
+++ b/nodejs/docs/api/class-browser.mdx
@@ -311,13 +311,6 @@ If directly using this method to create [BrowserContext]s, it is best practice t
- `locale` [string] *(optional)*#
Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default locale. Learn more about emulation in our [emulation guide](../emulation.mdx#locale--timezone).
- - `locatorOmitHidden` [boolean] *(optional)*#
-
- Whether locators omit hidden elements by default. Defaults to `false`. If set to `true`, each locator is resolved as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended: only the final matched element is checked for [visibility](../actionability.mdx#visible), not its intermediate ancestors. This affects actions, assertions, counts and element evaluation, but not selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
-
- Pass `omitHidden: false` when creating a locator to opt out. The override is preserved by `filter()`, `first()`, `last()`, `nth()`, `and()`, `or()` and `describe()`. Creating a descendant locator uses the context default again, unless an override is supplied for that descendant. Explicit visibility filters are never removed. Role locators still apply their accessibility matching rules; use `getByRole(..., { includeHidden: true, omitHidden: false })` to include hidden elements when this context option is enabled.
-
- With `true`, hidden elements are treated as missing by `toBeHidden()` and `waitFor({ state: 'hidden' })`. To check attachment of a hidden element, create the locator with `omitHidden: false`.
- `logger` [Logger] *(optional)*#
:::warning[Deprecated]
@@ -626,13 +619,6 @@ await browser.newPage(options);
- `locale` [string] *(optional)*#
Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default locale. Learn more about emulation in our [emulation guide](../emulation.mdx#locale--timezone).
- - `locatorOmitHidden` [boolean] *(optional)*#
-
- Whether locators omit hidden elements by default. Defaults to `false`. If set to `true`, each locator is resolved as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended: only the final matched element is checked for [visibility](../actionability.mdx#visible), not its intermediate ancestors. This affects actions, assertions, counts and element evaluation, but not selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
-
- Pass `omitHidden: false` when creating a locator to opt out. The override is preserved by `filter()`, `first()`, `last()`, `nth()`, `and()`, `or()` and `describe()`. Creating a descendant locator uses the context default again, unless an override is supplied for that descendant. Explicit visibility filters are never removed. Role locators still apply their accessibility matching rules; use `getByRole(..., { includeHidden: true, omitHidden: false })` to include hidden elements when this context option is enabled.
-
- With `true`, hidden elements are treated as missing by `toBeHidden()` and `waitFor({ state: 'hidden' })`. To check attachment of a hidden element, create the locator with `omitHidden: false`.
- `logger` [Logger] *(optional)*#
:::warning[Deprecated]
diff --git a/nodejs/docs/api/class-browsertype.mdx b/nodejs/docs/api/class-browsertype.mdx
index 7cd221caca..8f6a64c168 100644
--- a/nodejs/docs/api/class-browsertype.mdx
+++ b/nodejs/docs/api/class-browsertype.mdx
@@ -110,6 +110,8 @@ const page = defaultContext.pages()[0];
- `endpointURL` [string] Added in: v1.11#
A CDP websocket endpoint or http url to connect to. For example `http://localhost:9222/` or `ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4`.
+
+ Alternatively, a browser channel name such as `chrome` or `msedge` to connect to a browser with remote debugging enabled in its default user data directory. On Linux, Playwright uses `CHROME_USER_DATA_DIR` when set. Otherwise, it uses `CHROME_CONFIG_HOME`, then `XDG_CONFIG_HOME`, then `~/.config` to locate that directory.
- `options` [Object] *(optional)*
- `artifactsDir` [string] *(optional)* Added in: v1.61#
@@ -454,13 +456,6 @@ await browserType.launchPersistentContext(userDataDir, options);
- `locale` [string] *(optional)*#
Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default locale. Learn more about emulation in our [emulation guide](../emulation.mdx#locale--timezone).
- - `locatorOmitHidden` [boolean] *(optional)*#
-
- Whether locators omit hidden elements by default. Defaults to `false`. If set to `true`, each locator is resolved as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended: only the final matched element is checked for [visibility](../actionability.mdx#visible), not its intermediate ancestors. This affects actions, assertions, counts and element evaluation, but not selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
-
- Pass `omitHidden: false` when creating a locator to opt out. The override is preserved by `filter()`, `first()`, `last()`, `nth()`, `and()`, `or()` and `describe()`. Creating a descendant locator uses the context default again, unless an override is supplied for that descendant. Explicit visibility filters are never removed. Role locators still apply their accessibility matching rules; use `getByRole(..., { includeHidden: true, omitHidden: false })` to include hidden elements when this context option is enabled.
-
- With `true`, hidden elements are treated as missing by `toBeHidden()` and `waitFor({ state: 'hidden' })`. To check attachment of a hidden element, create the locator with `omitHidden: false`.
- `logger` [Logger] *(optional)*#
:::warning[Deprecated]
diff --git a/nodejs/docs/api/class-frame.mdx b/nodejs/docs/api/class-frame.mdx
index 65d9118307..cc4be9c24e 100644
--- a/nodejs/docs/api/class-frame.mdx
+++ b/nodejs/docs/api/class-frame.mdx
@@ -401,9 +401,6 @@ await page.getByAltText('Playwright logo').click();
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -439,9 +436,6 @@ await page.getByLabel('Password').fill('secret');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -478,9 +472,6 @@ await page
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -563,9 +554,6 @@ await page.getByRole('button', { name: /submit/i }).click();
Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is case-insensitive and searches for a substring, use [exact](/api/class-frame.mdx#frame-get-by-role-option-exact) to control this behavior.
Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
- `pressed` [boolean] *(optional)*#
An attribute that is usually set by `aria-pressed`.
@@ -612,10 +600,6 @@ await page.getByTestId('directions').click();
- `testId` [string] | [RegExp]#
Id to locate the element by.
-- `options` [Object] *(optional)*
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -681,9 +665,6 @@ page.getByText(/^hello$/i);
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -724,9 +705,6 @@ await expect(page.getByTitle('Issues count')).toHaveText('25 issues');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -881,9 +859,6 @@ frame.locator(selector, options);
- `hasText` [string] | [RegExp] *(optional)*#
Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches `Playwright
`.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
diff --git a/nodejs/docs/api/class-framelocator.mdx b/nodejs/docs/api/class-framelocator.mdx
index d9b6c09c6a..c42f2d175b 100644
--- a/nodejs/docs/api/class-framelocator.mdx
+++ b/nodejs/docs/api/class-framelocator.mdx
@@ -103,9 +103,6 @@ await page.getByAltText('Playwright logo').click();
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -141,9 +138,6 @@ await page.getByLabel('Password').fill('secret');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -180,9 +174,6 @@ await page
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -265,9 +256,6 @@ await page.getByRole('button', { name: /submit/i }).click();
Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is case-insensitive and searches for a substring, use [exact](/api/class-framelocator.mdx#frame-locator-get-by-role-option-exact) to control this behavior.
Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
- `pressed` [boolean] *(optional)*#
An attribute that is usually set by `aria-pressed`.
@@ -314,10 +302,6 @@ await page.getByTestId('directions').click();
- `testId` [string] | [RegExp]#
Id to locate the element by.
-- `options` [Object] *(optional)*
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -383,9 +367,6 @@ page.getByText(/^hello$/i);
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -426,9 +407,6 @@ await expect(page.getByTitle('Issues count')).toHaveText('25 issues');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -473,9 +451,6 @@ frameLocator.locator(selectorOrLocator, options);
- `hasText` [string] | [RegExp] *(optional)*#
Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches `Playwright
`.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
diff --git a/nodejs/docs/api/class-locator.mdx b/nodejs/docs/api/class-locator.mdx
index 4eaeca73f2..5ead31e794 100644
--- a/nodejs/docs/api/class-locator.mdx
+++ b/nodejs/docs/api/class-locator.mdx
@@ -1085,9 +1085,6 @@ await rowLocator
- `hasText` [string] | [RegExp] *(optional)*#
Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches `Playwright
`.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
- `visible` [boolean] *(optional)* Added in: v1.51#
Only matches visible or invisible elements. Prefer the [locator.visible()](/api/class-locator.mdx#locator-visible) shortcut when matching only visible elements.
@@ -1225,9 +1222,6 @@ await page.getByAltText('Playwright logo').click();
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1263,9 +1257,6 @@ await page.getByLabel('Password').fill('secret');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1302,9 +1293,6 @@ await page
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1387,9 +1375,6 @@ await page.getByRole('button', { name: /submit/i }).click();
Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is case-insensitive and searches for a substring, use [exact](/api/class-locator.mdx#locator-get-by-role-option-exact) to control this behavior.
Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
- `pressed` [boolean] *(optional)*#
An attribute that is usually set by `aria-pressed`.
@@ -1436,10 +1421,6 @@ await page.getByTestId('directions').click();
- `testId` [string] | [RegExp]#
Id to locate the element by.
-- `options` [Object] *(optional)*
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1505,9 +1486,6 @@ page.getByText(/^hello$/i);
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1548,9 +1526,6 @@ await expect(page.getByTitle('Issues count')).toHaveText('25 issues');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -2003,9 +1978,6 @@ locator.locator(selectorOrLocator, options);
- `hasText` [string] | [RegExp] *(optional)*#
Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches `Playwright
`.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
diff --git a/nodejs/docs/api/class-page.mdx b/nodejs/docs/api/class-page.mdx
index 6c30fd5096..4b4b2d62cd 100644
--- a/nodejs/docs/api/class-page.mdx
+++ b/nodejs/docs/api/class-page.mdx
@@ -956,9 +956,6 @@ await page.getByAltText('Playwright logo').click();
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -994,9 +991,6 @@ await page.getByLabel('Password').fill('secret');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1033,9 +1027,6 @@ await page
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1066,10 +1057,6 @@ await page.getByRef('e2').click();
- `ref` [string]#
Aria ref of the element, for example `e2` or `f1e3`.
-- `options` [Object] *(optional)*
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1152,9 +1139,6 @@ await page.getByRole('button', { name: /submit/i }).click();
Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is case-insensitive and searches for a substring, use [exact](/api/class-page.mdx#page-get-by-role-option-exact) to control this behavior.
Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
- `pressed` [boolean] *(optional)*#
An attribute that is usually set by `aria-pressed`.
@@ -1201,10 +1185,6 @@ await page.getByTestId('directions').click();
- `testId` [string] | [RegExp]#
Id to locate the element by.
-- `options` [Object] *(optional)*
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1270,9 +1250,6 @@ page.getByText(/^hello$/i);
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1313,9 +1290,6 @@ await expect(page.getByTitle('Issues count')).toHaveText('25 issues');
- `exact` [boolean] *(optional)*#
Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular expression. Note that exact match still trims whitespace.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
@@ -1534,9 +1508,6 @@ page.locator(selector, options);
- `hasText` [string] | [RegExp] *(optional)*#
Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches `Playwright
`.
- - `omitHidden` [boolean] *(optional)* Added in: v1.65#
-
- Whether to omit hidden elements, overriding the context's `locatorOmitHidden` option, which defaults to `false`. Setting this to `true` applies [locator.visible()](/api/class-locator.mdx#locator-visible) when the locator is resolved. Setting it to `false` disables the automatic visibility filter, but does not remove explicit filters or change role locators' accessibility matching rules.
**Returns**
- [Locator]#
diff --git a/nodejs/docs/api/class-testoptions.mdx b/nodejs/docs/api/class-testoptions.mdx
index e5150bb3b9..478dbc4e27 100644
--- a/nodejs/docs/api/class-testoptions.mdx
+++ b/nodejs/docs/api/class-testoptions.mdx
@@ -698,33 +698,6 @@ export default defineConfig({
---
-### locatorOmitHidden {/* #test-options-locator-omit-hidden */}
-
-Added in: v1.65testOptions.locatorOmitHidden
-
-Whether locators omit hidden elements by default. Defaults to `false`. If set to `true`, each locator is resolved as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended: only the final matched element is checked for [visibility](../actionability.mdx#visible), not its intermediate ancestors. This affects actions, assertions, counts and element evaluation, but not selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
-
-Pass `omitHidden: false` when creating a locator to opt out. The override is preserved by `filter()`, `first()`, `last()`, `nth()`, `and()`, `or()` and `describe()`. Creating a descendant locator uses the context default again, unless an override is supplied for that descendant. Explicit visibility filters are never removed. Role locators still apply their accessibility matching rules; use `getByRole(..., { includeHidden: true, omitHidden: false })` to include hidden elements when this context option is enabled.
-
-With `true`, hidden elements are treated as missing by `toBeHidden()` and `waitFor({ state: 'hidden' })`. To check attachment of a hidden element, create the locator with `omitHidden: false`.
-
-**Usage**
-
-```js title="playwright.config.ts"
-import { defineConfig } from '@playwright/test';
-
-export default defineConfig({
- use: {
- locatorOmitHidden: true,
- },
-});
-```
-
-**Type**
-- [boolean]
-
----
-
### navigationTimeout {/* #test-options-navigation-timeout */}
Added in: v1.10testOptions.navigationTimeout
diff --git a/nodejs/docs/docker.mdx b/nodejs/docs/docker.mdx
index 34ce987da1..0460f99a25 100644
--- a/nodejs/docs/docker.mdx
+++ b/nodejs/docs/docker.mdx
@@ -164,7 +164,7 @@ Browser builds for Firefox and WebKit are built for the [glibc](https://en.wikip
To run Playwright inside Docker, you need to have Node.js, [Playwright browsers](./browsers.mdx#install-browsers) and [browser system dependencies](./browsers.mdx#install-system-dependencies) installed. See the following Dockerfile:
```Dockerfile
-FROM node:20-bookworm
+FROM node:26-bookworm
RUN npx -y playwright@1.64.1 install --with-deps
```
diff --git a/nodejs/docs/release-notes.mdx b/nodejs/docs/release-notes.mdx
index 90b02cef02..b723cdb792 100644
--- a/nodejs/docs/release-notes.mdx
+++ b/nodejs/docs/release-notes.mdx
@@ -9,6 +9,98 @@ import HTMLCard from '@site/src/components/HTMLCard';
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.65
+
+### 🥟 Run tests with Bun
+
+The test runner now runs under [Bun](https://bun.com). Bun transpiles your TypeScript test files itself, so Playwright does not use Babel or its compilation cache. Pass the `--bun` flag, because without it `bunx playwright test` runs on Node.js:
+
+```bash
+bunx --bun playwright test
+```
+
+Our CI runs the test runner tests under Bun 1.4.3 on Linux. Some features work differently under Bun:
+- There is no watch mode. UI mode does not run tests again when files change, and `--only-changed` does not follow imports.
+- Bun loads modules itself, so `--tsconfig` and the JSX options in `tsconfig.json` have no effect, and custom ESM loaders are not supported.
+- Stack traces do not include async frames, and API names do not include the class name: `click` instead of `locator.click`. This changes some step locations, step titles and error messages.
+- Console output of a test does not get into the trace and UI mode.
+
+### 🚨 Reports with only failures
+
+New [`failures`](./test-reporters.mdx#failures-reporter) reporter prints failures and successful retries as they occur, followed by a summary, without progress output.
+
+New `onlyFailures` option of the HTML, JSON and JUnit reporters [keeps only](./test-reporters.mdx#report-only-failures) tests with unexpected outcomes, flaky tests and interrupted tests:
+
+```js title="playwright.config.ts"
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+ reporter: [
+ ['failures'],
+ ['html', { onlyFailures: true }],
+ ],
+});
+```
+
+### 🎯 Test runner
+- New built-in `-exclusive-` [test lock](./test-parallel.mdx#test-locks) runs a test only when no other tests are running. All other tests continue to run in parallel with each other:
+
+ ```js
+ test('restart the server', { lock: '-exclusive-' }, async () => {
+ // No other test runs while this one is running.
+ });
+ ```
+
+- [test.skip()](/api/class-test.mdx#test-skip), [test.fixme()](/api/class-test.mdx#test-fixme), [test.fail()](/api/class-test.mdx#test-fail) and [test.slow()](/api/class-test.mdx#test-slow) now accept only a description. It is recorded in the test annotation:
+
+ ```js
+ test('upload a file', async ({ page }) => {
+ test.skip('Not implemented yet');
+ });
+ ```
+
+- New `PLAYWRIGHT_TRANSFORM_CACHE_DIR` environment variable sets the directory for transpiled test files, for example on a Linux machine shared with other users.
+
+### New APIs
+- New options [timeout](/api/class-cdpsession.mdx#cdp-session-send-option-timeout) and [signal](/api/class-cdpsession.mdx#cdp-session-send-option-signal) in [cdpSession.send()](/api/class-cdpsession.mdx#cdp-session-send).
+- New [testRun.mode()](/api/class-testrun.mdx#test-run-mode) returns the execution mode of a suite during [reporter.preprocess()](/api/class-reporter.mdx#reporter-preprocess).
+
+### Breaking Changes ⚠️
+- TypeScript class fields now follow [`useDefineForClassFields`](./test-typescript.mdx#tsconfig-class-fields) from your `tsconfig.json`, the same as `tsc`. It is enabled for `ES2022` and later targets, and when `target` is not specified. A field initializer that reads a constructor parameter property now fails, because the initializer runs first:
+
+ ```js
+ class LoginPage {
+ // TypeError: Cannot read properties of undefined (reading 'getByRole')
+ readonly submit = this.page.getByRole('button', { name: 'Submit' });
+
+ constructor(private readonly page: Page) {}
+ }
+ ```
+
+ Move the initialization to the constructor, or set `"useDefineForClassFields": false` in your `tsconfig.json`.
+- Actions such as [locator.click()](/api/class-locator.mdx#locator-click), [locator.check()](/api/class-locator.mdx#locator-check), [locator.tap()](/api/class-locator.mdx#locator-tap), [locator.fill()](/api/class-locator.mdx#locator-fill), [locator.clear()](/api/class-locator.mdx#locator-clear) and [locator.selectOption()](/api/class-locator.mdx#locator-select-option) now wait for the element to be [not inert](./actionability.mdx#not-inert). An action on an element with the `inert` attribute, or inside such an element, now times out if the element stays inert.
+- A sharded run now fails with "No tests found" when no tests match across all shards. Pass `--pass-with-no-tests` to allow this. An empty shard still passes when other shards have tests.
+- Cookie matching now follows RFC 6265. With a URL, [browserContext.cookies()](/api/class-browsercontext.mdx#browser-context-cookies) and [apiRequestContext.cookies()](/api/class-apirequestcontext.mdx#api-request-context-cookies) no longer return host-only cookies for subdomains or `Path=/api` cookies for `/apiv2`, and a `Path=/foo/` cookie does not match `/foo`. [APIRequestContext] sends a cookie without a name as `Cookie: x` instead of `Cookie: =x`, and stores `Set-Cookie: token` as a cookie without a name.
+- Proxy credentials are no longer sent to websites. The credentials in the [proxy](/api/class-browsertype.mdx#browser-type-launch-option-proxy) option now answer only proxy challenges. To authenticate on a website, use [httpCredentials](/api/class-browser.mdx#browser-new-context-option-http-credentials).
+- Text that the browser does not render, such as text that is not assigned to a slot or text directly inside a closed ``, is no longer part of accessible names and aria snapshots. This can change the results of [page.getByRole()](/api/class-page.mdx#page-get-by-role) with a name, [locator.ariaSnapshot()](/api/class-locator.mdx#locator-aria-snapshot) and [expect(locator).toMatchAriaSnapshot()](/api/class-locatorassertions.mdx#locator-assertions-to-match-aria-snapshot).
+- String and `URLSearchParams` values of the `params` option in [APIRequestContext] requests are now appended to the query that the URL already has, instead of replacing it.
+- `.css`, `.less` and `.scss` imports in test files now load as empty modules instead of being removed, so the imported file must exist.
+- The blob reporter again deletes the content of its output directory before it writes the report. Playwright 1.64 kept reports with other names.
+- Test locations of imported calls such as `test(` in CommonJS output now point to the start of the callee, for example `a.spec.ts:3:7` instead of `a.spec.ts:3:11`. This is the same as in ESM.
+
+### Announcements
+* ⚠️ Playwright no longer tests on Node.js 20. Use Node.js 22, 24 or 26, as listed in the [system requirements](./intro.mdx#system-requirements).
+* 🐳 [Docker images](./docker.mdx) now include Node.js 26 instead of Node.js 24, and the latest patch of Chromium on the same branch.
+
+### Browser Versions
+- Chromium 158.0.8127.2
+- Mozilla Firefox 159.0
+- WebKit 27.2
+
+This version was also tested against the following stable channels:
+- Google Chrome 157
+- Microsoft Edge 156
+
## Version 1.64
### 🧰 WebMCP
diff --git a/python/docs/api/class-browsertype.mdx b/python/docs/api/class-browsertype.mdx
index 84306c4edd..af011def38 100644
--- a/python/docs/api/class-browsertype.mdx
+++ b/python/docs/api/class-browsertype.mdx
@@ -168,6 +168,8 @@ page = default_context.pages[0]
- `endpoint_url` [str] Added in: v1.11#
A CDP websocket endpoint or http url to connect to. For example `http://localhost:9222/` or `ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4`.
+
+ Alternatively, a browser channel name such as `chrome` or `msedge` to connect to a browser with remote debugging enabled in its default user data directory. On Linux, Playwright uses `CHROME_USER_DATA_DIR` when set. Otherwise, it uses `CHROME_CONFIG_HOME`, then `XDG_CONFIG_HOME`, then `~/.config` to locate that directory.
- `artifacts_dir` [Union]\[[str], [pathlib.Path]\] *(optional)* Added in: v1.61#
If specified, browser artifacts (such as traces and downloads) are saved into this directory.
diff --git a/python/docs/release-notes.mdx b/python/docs/release-notes.mdx
index 1b5a90ee27..0368875062 100644
--- a/python/docs/release-notes.mdx
+++ b/python/docs/release-notes.mdx
@@ -9,6 +9,37 @@ import HTMLCard from '@site/src/components/HTMLCard';
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.65
+
+### 🧾 Locator code in Python
+
+A locator from [locator.normalize()](/api/class-locator.mdx#locator-normalize) now converts to a string as Python code. Use it with [page.get_by_ref()](/api/class-page.mdx#page-get-by-ref) to turn an element that an agent picks from a [page.aria_snapshot()](/api/class-page.mdx#page-aria-snapshot) in the `"ai"` mode into code for your test:
+
+```python
+normalized = page.get_by_ref("e2").normalize()
+print(str(normalized))
+# get_by_role("button", name="Submit")
+```
+
+### New APIs
+- New option [timeout](/api/class-cdpsession.mdx#cdp-session-send-option-timeout) in [cdp_session.send()](/api/class-cdpsession.mdx#cdp-session-send).
+
+### Breaking Changes ⚠️
+- Actions such as [locator.click()](/api/class-locator.mdx#locator-click), [locator.check()](/api/class-locator.mdx#locator-check), [locator.tap()](/api/class-locator.mdx#locator-tap), [locator.fill()](/api/class-locator.mdx#locator-fill), [locator.clear()](/api/class-locator.mdx#locator-clear) and [locator.select_option()](/api/class-locator.mdx#locator-select-option) now wait for the element to be [not inert](./actionability.mdx#not-inert). An action on an element with the `inert` attribute, or inside such an element, now times out if the element stays inert.
+- Cookie matching now follows RFC 6265. With a URL, [browser_context.cookies()](/api/class-browsercontext.mdx#browser-context-cookies) and [api_request_context.cookies()](/api/class-apirequestcontext.mdx#api-request-context-cookies) no longer return host-only cookies for subdomains or `Path=/api` cookies for `/apiv2`, and a `Path=/foo/` cookie does not match `/foo`. [APIRequestContext] sends a cookie without a name as `Cookie: x` instead of `Cookie: =x`, and stores `Set-Cookie: token` as a cookie without a name.
+- Proxy credentials are no longer sent to websites. The credentials in the [proxy](/api/class-browsertype.mdx#browser-type-launch-option-proxy) option now answer only proxy challenges. To authenticate on a website, use [http_credentials](/api/class-browser.mdx#browser-new-context-option-http-credentials).
+- Text that the browser does not render, such as text that is not assigned to a slot or text directly inside a closed ``, is no longer part of accessible names and aria snapshots. This can change the results of [page.get_by_role()](/api/class-page.mdx#page-get-by-role) with a name, [locator.aria_snapshot()](/api/class-locator.mdx#locator-aria-snapshot) and [expect(locator).to_match_aria_snapshot()](/api/class-locatorassertions.mdx#locator-assertions-to-match-aria-snapshot).
+- String values of the `params` option in [APIRequestContext] requests are now appended to the query that the URL already has, instead of replacing it.
+
+### Browser Versions
+- Chromium 158.0.8127.2
+- Mozilla Firefox 159.0
+- WebKit 27.2
+
+This version was also tested against the following stable channels:
+- Google Chrome 157
+- Microsoft Edge 156
+
## Version 1.64
### 🧰 WebMCP