Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

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.md
index 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: 2
import 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 screenshots
diff --git a/docs/src/release-notes-java.md b/docs/src/release-notes-java.md
index 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: 2
import 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 screenshots
diff --git a/docs/src/release-notes-python.md b/docs/src/release-notes-python.md
index 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: 2
import 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