Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
chore: add v1.52 release notes (#35633)
Max Schmittaef47744df0f
diff --git a/docs/src/release-notes-csharp.md b/docs/src/release-notes-csharp.mdindex e3759f5c0e..457356f6a9 100644--- a/docs/src/release-notes-csharp.md+++ b/docs/src/release-notes-csharp.md@@ -4,6 +4,53 @@ title: "Release notes"toc_max_heading_level: 2---+## Version 1.52++### Highlights++- New method [`method: LocatorAssertions.toContainClass`] to ergonomically assert individual class names on the element.++ ```csharp+ await Expect(Page.GetByRole(AriaRole.Listitem, new() { Name = "Ship v1.52" })).ToContainClassAsync("done");+ ```++- [Aria Snapshots](./aria-snapshots.md) got two new properties: [`/children`](./aria-snapshots.md#strict-matching) for strict matching and `/url` for links.++ ```csharp+ await Expect(locator).ToMatchAriaSnapshotAsync(@"+ - list+ - /children: equal+ - listitem: Feature A+ - listitem:+ - link ""Feature B"":+ - /url: ""https://playwright.dev""+ ");+ ```++### Miscellaneous++- New option [`option: APIRequest.newContext.maxRedirects`] in [`method: APIRequest.newContext`] to control the maximum number of redirects.+- New option [`option: Locator.ariaSnapshot.ref`] in [`method: Locator.ariaSnapshot`] to generate reference for each element in the snapshot which can later be used to locate the element.+- HTML reporter now supports *NOT filtering* via `!@my-tag` or `!my-file.spec.ts` or `!p:my-project`.++### Breaking Changes++- Base URL matching is not supported in [`method: Page.frame`] anymore. We recommend migrating to [`method: Page.frameLocator`] instead for having a more convenient API.+- Glob URL patterns in methods like [`method: Page.route`] do not support `?` and `[]` anymore. We recommend using regular expressions instead.+- Method [`method: Route.continue`] does not allow to override the `Cookie` header anymore. If a `Cookie` header is provided, it will be ignored, and the cookie will be loaded from the browser's cookie store. To set custom cookies, use [`method: BrowserContext.addCookies`].+- macOS 13 is now deprecated and will no longer receive WebKit updates. Please upgrade to a more recent macOS version to continue benefiting from the latest WebKit improvements.++### Browser Versions++- Chromium 136.0.7103.25+- Mozilla Firefox 137.0+- WebKit 18.4++This version was also tested against the following stable channels:++- Google Chrome 135+- Microsoft Edge 135+## Version 1.51### Highlightsdiff --git a/docs/src/release-notes-java.md b/docs/src/release-notes-java.mdindex 6649a1d1c8..7f27919574 100644--- a/docs/src/release-notes-java.md+++ b/docs/src/release-notes-java.md@@ -4,6 +4,53 @@ title: "Release notes"toc_max_heading_level: 2---+## Version 1.52++### Highlights++- New method [`method: LocatorAssertions.toContainClass`] to ergonomically assert individual class names on the element.++ ```java+ assertThat(page.getByRole(AriaRole.LISTITEM, new Page.GetByRoleOptions().setName("Ship v1.52"))).containsClass("done");+ ```++- [Aria Snapshots](./aria-snapshots.md) got two new properties: [`/children`](./aria-snapshots.md#strict-matching) for strict matching and `/url` for links.++ ```java+ assertThat(locator).toMatchAriaSnapshot("""+ - list+ - /children: equal+ - listitem: Feature A+ - listitem:+ - link "Feature B":+ - /url: "https://playwright.dev"+ """);+ ```++### Miscellaneous++- New option [`option: APIRequest.newContext.maxRedirects`] in [`method: APIRequest.newContext`] to control the maximum number of redirects.+- New option [`option: Locator.ariaSnapshot.ref`] in [`method: Locator.ariaSnapshot`] to generate reference for each element in the snapshot which can later be used to locate the element.+- HTML reporter now supports *NOT filtering* via `!@my-tag` or `!my-file.spec.ts` or `!p:my-project`.++### Breaking Changes++- Base URL matching is not supported in [`method: Page.frame`] anymore. We recommend migrating to [`method: Page.frameLocator`] instead for having a more convenient API.+- Glob URL patterns in methods like [`method: Page.route`] do not support `?` and `[]` anymore. We recommend using regular expressions instead.+- Method [`method: Route.continue`] does not allow to override the `Cookie` header anymore. If a `Cookie` header is provided, it will be ignored, and the cookie will be loaded from the browser's cookie store. To set custom cookies, use [`method: BrowserContext.addCookies`].+- macOS 13 is now deprecated and will no longer receive WebKit updates. Please upgrade to a more recent macOS version to continue benefiting from the latest WebKit improvements.++### Browser Versions++- Chromium 136.0.7103.25+- Mozilla Firefox 137.0+- WebKit 18.4++This version was also tested against the following stable channels:++- Google Chrome 135+- Microsoft Edge 135+## Version 1.51### Highlightsdiff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.mdindex 900c068936..b2ec57c24c 100644--- a/docs/src/release-notes-js.md+++ b/docs/src/release-notes-js.md@@ -6,6 +6,58 @@ toc_max_heading_level: 2import LiteYouTube from '@site/src/components/LiteYouTube';+## Version 1.52++### Highlights++- New method [`method: LocatorAssertions.toContainClass`] to ergonomically assert individual class names on the element.++ ```ts+ await expect(page.getByRole('listitem', { name: 'Ship v1.52' })).toContainClass('done');+ ```++- [Aria Snapshots](./aria-snapshots.md) got two new properties: [`/children`](./aria-snapshots.md#strict-matching) for strict matching and `/url` for links.++ ```ts+ await expect(locator).toMatchAriaSnapshot(`+ - list+ - /children: equal+ - listitem: Feature A+ - listitem:+ - link "Feature B":+ - /url: "https://playwright.dev"+ `);+ ```++### Test Runner++- New property [`property: TestProject.workers`] allows to specify the number of concurrent worker processes to use for a test project. The global limit of property [`property: TestConfig.workers`] still applies.+- New [`property: TestConfig.failOnFlakyTests`] option to fail the test run if any flaky tests are detected, similarly to `--fail-on-flaky-tests`. This is useful for CI/CD environments where you want to ensure that all tests are stable before deploying.+- New property [`property: TestResult.annotations`] contains annotations for each test retry.++### Miscellaneous++- New option [`option: APIRequest.newContext.maxRedirects`] in [`method: APIRequest.newContext`] to control the maximum number of redirects.+- New option [`option: Locator.ariaSnapshot.ref`] in [`method: Locator.ariaSnapshot`] to generate reference for each element in the snapshot which can later be used to locate the element.+- HTML reporter now supports *NOT filtering* via `!@my-tag` or `!my-file.spec.ts` or `!p:my-project`.++### Breaking Changes++- Glob URL patterns in methods like [`method: Page.route`] do not support `?` and `[]` anymore. We recommend using regular expressions instead.+- Method [`method: Route.continue`] does not allow to override the `Cookie` header anymore. If a `Cookie` header is provided, it will be ignored, and the cookie will be loaded from the browser's cookie store. To set custom cookies, use [`method: BrowserContext.addCookies`].+- macOS 13 is now deprecated and will no longer receive WebKit updates. Please upgrade to a more recent macOS version to continue benefiting from the latest WebKit improvements.++### Browser Versions++- Chromium 136.0.7103.25+- Mozilla Firefox 137.0+- WebKit 18.4++This version was also tested against the following stable channels:++- Google Chrome 135+- Microsoft Edge 135+## Version 1.51### StorageState for indexedDBdiff --git a/docs/src/release-notes-python.md b/docs/src/release-notes-python.mdindex c0fdc32e25..f841b81a3e 100644--- a/docs/src/release-notes-python.md+++ b/docs/src/release-notes-python.md@@ -4,6 +4,53 @@ title: "Release notes"toc_max_heading_level: 2---+## Version 1.52++### Highlights++- New method [`method: LocatorAssertions.toContainClass`] to ergonomically assert individual class names on the element.++ ```python+ expect(page.get_by_role('listitem', name='Ship v1.52')).to_contain_class('done')+ ```++- [Aria Snapshots](./aria-snapshots.md) got two new properties: [`/children`](./aria-snapshots.md#strict-matching) for strict matching and `/url` for links.++ ```python+ expect(locator).to_match_aria_snapshot("""+ - list+ - /children: equal+ - listitem: Feature A+ - listitem:+ - link "Feature B":+ - /url: "https://playwright.dev"+ """)+ ```++### Miscellaneous++- New option [`option: APIRequest.newContext.maxRedirects`] in [`method: APIRequest.newContext`] to control the maximum number of redirects.+- New option [`option: Locator.ariaSnapshot.ref`] in [`method: Locator.ariaSnapshot`] to generate reference for each element in the snapshot which can later be used to locate the element.+- HTML reporter now supports *NOT filtering* via `!@my-tag` or `!my-file.spec.ts` or `!p:my-project`.++### Breaking Changes++- Base URL matching is not supported in [`method: Page.frame`] anymore. We recommend migrating to [`method: Page.frameLocator`] instead for having a more convenient API.+- Glob URL patterns in methods like [`method: Page.route`] do not support `?` and `[]` anymore. We recommend using regular expressions instead.+- Method [`method: Route.continue`] does not allow to override the `Cookie` header anymore. If a `Cookie` header is provided, it will be ignored, and the cookie will be loaded from the browser's cookie store. To set custom cookies, use [`method: BrowserContext.addCookies`].+- macOS 13 is now deprecated and will no longer receive WebKit updates. Please upgrade to a more recent macOS version to continue benefiting from the latest WebKit improvements.++### Browser Versions++- Chromium 136.0.7103.25+- Mozilla Firefox 137.0+- WebKit 18.4++This version was also tested against the following stable channels:++- Google Chrome 135+- Microsoft Edge 135+## Version 1.51### Highlights