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
docs: release notes for v1.63 Python, Java, and .NET (#42708)
Yury Semikhatsky500c9c822ce7
diff --git a/docs/src/release-notes-csharp.md b/docs/src/release-notes-csharp.mdindex 3c70e4065e..6cce97d8a0 100644--- a/docs/src/release-notes-csharp.md+++ b/docs/src/release-notes-csharp.md@@ -6,6 +6,77 @@ toc_max_heading_level: 2import LiteYouTube from '@site/src/components/LiteYouTube';+## Version 1.63++### ๐ช Locate across frames++[`method: Page.frameLocator`] and [`method: Frame.frameLocator`] called without a selector search in any frame of the+subtree, so you no longer need to locate the iframe first:++```csharp+// Finds the button in any frame on the page.+await page.FrameLocator().GetByRole(AriaRole.Button).ClickAsync();+```++The rest of the locator resolves inside a single frame, just like a regular locator, and an error is thrown when it+matches elements in several frames.++### ๐๏ธ Visible-only locators++New [`method: Locator.visible`] returns a locator that matches only visible elements. It is the recommended+replacement for the `:visible` CSS pseudo-class:++```csharp+await page.Locator("button").Visible.ClickAsync();+```++### ๐ผ๏ธ Aria and screen snapshots in traces++New [`option: Tracing.start.ariaSnapshots`] and [`option: Tracing.start.screenSnapshots`] options of+[`method: Tracing.start`] capture an aria snapshot and a screenshot of the page on every action:++```csharp+await context.Tracing.StartAsync(new()+{+ Snapshots = true,+ AriaSnapshots = true,+ ScreenSnapshots = true+});+```++With aria and screen snapshots recorded, the new **Display Aria** mode in the trace viewer shows the action screenshot+side by side with the aria snapshot, and hovering an aria node highlights it on the screenshot.++### New APIs++#### Browser and Context++- [`option: Browser.newContext.httpCredentials`] now also accepts an array of credentials. The first entry matching the request origin is used, and entries without an origin match any request.+- New option [`option: BrowserContext.storageState.opfs`] includes the [origin private file system](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) in the storage state, so it can be persisted and restored into later contexts.+- New events [`event: Page.dialogClosed`] and [`event: BrowserContext.dialogClosed`] are emitted when a JavaScript dialog is accepted, dismissed or closed by the user.++#### Command line++- `pwsh bin/Debug/netX/playwright.ps1 install --no-remove` keeps the browsers of other Playwright installations instead of removing them.+- `pwsh bin/Debug/netX/playwright.ps1 codegen --http-credentials` records against pages behind HTTP authentication.++### Announcements++* โ ๏ธ Ubuntu 20.04 is not supported anymore.+* ๐ง On Linux arm64, Playwright now downloads the [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) build of Chromium, the same build used on all other platforms.++### Browser Versions++- Chromium 153.0.8010.12+- Mozilla Firefox 155.0+- WebKit 26.6++This version was also tested against the following stable channels:++- Google Chrome 153+- Microsoft Edge 153++## Version 1.62### ๐ผ๏ธ WebP screenshotsdiff --git a/docs/src/release-notes-java.md b/docs/src/release-notes-java.mdindex b3f3f81be9..9d3170ae2f 100644--- a/docs/src/release-notes-java.md+++ b/docs/src/release-notes-java.md@@ -6,6 +6,82 @@ toc_max_heading_level: 2import LiteYouTube from '@site/src/components/LiteYouTube';+## Version 1.63++### ๐ช Locate across frames++[`method: Page.frameLocator`] and [`method: Frame.frameLocator`] called without a selector search in any frame of the+subtree, so you no longer need to locate the iframe first:++```java+// Finds the button in any frame on the page.+page.frameLocator().getByRole(AriaRole.BUTTON).click();+```++The rest of the locator resolves inside a single frame, just like a regular locator, and an error is thrown when it+matches elements in several frames.++### ๐๏ธ Visible-only locators++New [`method: Locator.visible`] returns a locator that matches only visible elements. It is the recommended+replacement for the `:visible` CSS pseudo-class:++```java+page.locator("button").visible().click();+```++### ๐ผ๏ธ Aria and screen snapshots in traces++New [`option: Tracing.start.ariaSnapshots`] and [`option: Tracing.start.screenSnapshots`] options of+[`method: Tracing.start`] capture an aria snapshot and a screenshot of the page on every action:++```java+context.tracing().start(new Tracing.StartOptions()+ .setSnapshots(true)+ .setAriaSnapshots(true)+ .setScreenSnapshots(true));+```++With aria and screen snapshots recorded, the new **Display Aria** mode in the trace viewer shows the action screenshot+side by side with the aria snapshot, and hovering an aria node highlights it on the screenshot.++### โ Nullability annotations++The public API is now annotated with [JSpecify](https://jspecify.dev) nullability annotations. The+`com.microsoft.playwright`, `com.microsoft.playwright.options` and `com.microsoft.playwright.assertions` packages are+`@NullMarked`, and values that can be absent are marked `@Nullable`, so null-checking tools such as NullAway, as well as+Kotlin code, can catch missing null checks at compile time.++### New APIs++#### Browser and Context++- [`option: Browser.newContext.httpCredentials`] now also accepts an array of credentials. The first entry matching the request origin is used, and entries without an origin match any request.+- New option [`option: BrowserContext.storageState.opfs`] includes the [origin private file system](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) in the storage state, so it can be persisted and restored into later contexts.+- New events [`event: Page.dialogClosed`] and [`event: BrowserContext.dialogClosed`] are emitted when a JavaScript dialog is accepted, dismissed or closed by the user.++#### Command line++- `mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --no-remove"` keeps the browsers of other Playwright installations instead of removing them.+- `mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen --http-credentials"` records against pages behind HTTP authentication.++### Announcements++* โ ๏ธ Ubuntu 20.04 is not supported anymore.+* ๐ง On Linux arm64, Playwright now downloads the [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) build of Chromium, the same build used on all other platforms.++### Browser Versions++- Chromium 153.0.8010.12+- Mozilla Firefox 155.0+- WebKit 26.6++This version was also tested against the following stable channels:++- Google Chrome 153+- Microsoft Edge 153++## Version 1.62### ๐ผ๏ธ WebP screenshotsdiff --git a/docs/src/release-notes-python.md b/docs/src/release-notes-python.mdindex 6a4e9e9566..497a711fde 100644--- a/docs/src/release-notes-python.md+++ b/docs/src/release-notes-python.md@@ -6,6 +6,72 @@ toc_max_heading_level: 2import LiteYouTube from '@site/src/components/LiteYouTube';+## Version 1.63++### ๐ช Locate across frames++[`method: Page.frameLocator`] and [`method: Frame.frameLocator`] called without a selector search in any frame of the+subtree, so you no longer need to locate the iframe first:++```python+# Finds the button in any frame on the page.+page.frame_locator().get_by_role("button").click()+```++The rest of the locator resolves inside a single frame, just like a regular locator, and an error is thrown when it+matches elements in several frames.++### ๐๏ธ Visible-only locators++New [`method: Locator.visible`] returns a locator that matches only visible elements. It is the recommended+replacement for the `:visible` CSS pseudo-class:++```python+page.locator("button").visible.click()+```++### ๐ผ๏ธ Aria and screen snapshots in traces++New [`option: Tracing.start.ariaSnapshots`] and [`option: Tracing.start.screenSnapshots`] options of+[`method: Tracing.start`] capture an aria snapshot and a screenshot of the page on every action:++```python+context.tracing.start(snapshots=True, aria_snapshots=True, screen_snapshots=True)+```++With aria and screen snapshots recorded, the new **Display Aria** mode in the trace viewer shows the action screenshot+side by side with the aria snapshot, and hovering an aria node highlights it on the screenshot.++### New APIs++#### Browser and Context++- [`option: Browser.newContext.httpCredentials`] now also accepts an array of credentials. The first entry matching the request origin is used, and entries without an origin match any request.+- New option [`option: BrowserContext.storageState.opfs`] includes the [origin private file system](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) in the storage state, so it can be persisted and restored into later contexts.+- New events [`event: Page.dialogClosed`] and [`event: BrowserContext.dialogClosed`] are emitted when a JavaScript dialog is accepted, dismissed or closed by the user.++#### Command line++- `playwright install --no-remove` keeps the browsers of other Playwright installations instead of removing them.+- `playwright codegen --http-credentials` records against pages behind HTTP authentication.++### Announcements++* โ ๏ธ Ubuntu 20.04 is not supported anymore.+* ๐ง On Linux arm64, Playwright now downloads the [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) build of Chromium, the same build used on all other platforms.++### Browser Versions++- Chromium 153.0.8010.12+- Mozilla Firefox 155.0+- WebKit 26.6++This version was also tested against the following stable channels:++- Google Chrome 153+- Microsoft Edge 153++## Version 1.62### ๐ผ๏ธ WebP screenshots