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