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.64 Java and .NET (#43377)

Dmitry Gozman5ad202df4f48
diff --git a/docs/src/release-notes-csharp.md b/docs/src/release-notes-csharp.md
index 6cce97d8a0..31e3f1a5be 100644
--- a/docs/src/release-notes-csharp.md
+++ b/docs/src/release-notes-csharp.md
@@ -6,6 +6,119 @@ toc_max_heading_level: 2
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.64
+
+### 🧰 WebMCP
+
+New [`property: Page.webmcp`] and [`property: Frame.webmcp`] give access to the tools that a page registers through
+the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) browser API, so you can test them like
+any other part of your app:
+
+```csharp
+var browser = await playwright.Chromium.LaunchAsync(new() { Args = new[] { "--enable-features=WebMCP" } });
+var page = await browser.NewPageAsync();
+await page.GotoAsync("https://example.com");
+
+foreach (var tool in await page.Webmcp.ToolsAsync())
+ Console.WriteLine($"{tool.Name}: {tool.Description}");
+
+var result = await page.Webmcp.CallToolAsync("add", new { a = 2, b = 40 });
+Console.WriteLine(result?.GetProperty("content")[0].GetProperty("text")); // "42"
+```
+
+[Playwright MCP](./getting-started-mcp.md) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
+
+[`playwright-cli`](./getting-started-cli.md) exposes them as well:
+
+```bash
+playwright-cli webmcp-list
+playwright-cli webmcp-call search_catalog --params '{"query":"cats"}'
+```
+
+### 🎬 Better videos
+
+Videos can now be recorded at a custom frame rate, and the decorations for actions are styled with plain CSS:
+
+```csharp
+await page.Screencast.StartAsync(new()
+{
+ Path = "video.webm",
+ Size = new() { Width = 1920, Height = 1080 },
+ Fps = 60,
+});
+await page.Screencast.ShowActionsAsync(new()
+{
+ Style = new()
+ {
+ Point = "width: 20px; height: 20px; border-radius: 50%; background: red",
+ Highlight = "outline: 2px solid #333; background: rgba(0, 128, 255, .15)",
+ Title = "font-size: 16px",
+ },
+});
+```
+
+- New [`option: Browser.newContext.recordVideoFps`] option and new [`option: Screencast.start.fps`] option in
+ [`method: Screencast.start`]. Firefox and WebKit currently capture up to 25 frames per second.
+- New [`option: Screencast.showActions.style`] option takes CSS declarations for the `point` marker, the target
+ `highlight` and the action `title`. It replaces the `FontSize` option, which is now deprecated.
+- The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
+- Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better
+ quality.
+- All video options are also available in [Playwright MCP](./getting-started-mcp.md) and [`playwright-cli`](./getting-started-cli.md).
+
+### πŸͺ† Locator.within()
+
+New [`method: Locator.within`] combines two locators that you already have, reading in the natural order β€”
+"this button, within that dialog":
+
+```csharp
+var saveButton = page.GetByRole(AriaRole.Button, new() { Name = "Save" });
+var dialog = page.GetByTestId("settings-dialog");
+
+await saveButton.Within(dialog).ClickAsync();
+```
+
+Relative locators such as [`method: Locator.nth`] or [`method: Locator.first`] are resolved inside each parent
+separately, which makes column-like queries straightforward:
+
+```csharp
+// The third cell of every row, not the third cell in the table.
+var thirdColumn = page.GetByRole(AriaRole.Cell).Nth(2).Within(page.GetByRole(AriaRole.Row));
+await Expect(thirdColumn).ToHaveTextAsync(new[] { "Apple", "Banana", "Cherry" });
+```
+
+### New APIs
+
+- New [`method: Page.getByRef`] locates an element by its aria ref, such as `e2`, reported by [`method: Page.ariaSnapshot`] in the `"ai"` mode.
+- New option [`option: Page.content.includeShadow`] in [`method: Page.content`] and [`method: Frame.content`] serializes open shadow roots as [declarative shadow DOM](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM#declaratively_with_html).
+- New option [`option: Credentials.create.signCount`] sets the initial signature counter of a virtual credential. [`method: Credentials.create`] and [`method: Credentials.get`] return the current `SignCount`, and it is saved and restored together with the credentials in the storage state.
+- New [`method: APIRequestContext.addCookies`], [`method: APIRequestContext.cookies`] and [`method: APIRequestContext.clearCookies`] manage cookies of a request context, mirroring the [BrowserContext] methods:
+
+ ```csharp
+ await request.AddCookiesAsync(new[]
+ {
+ new Cookie { Name = "session-id", Value = "42", Url = "https://example.com" },
+ });
+ Console.WriteLine(await request.CookiesAsync("https://example.com"));
+ await request.ClearCookiesAsync(new() { Name = "session-id" });
+ ```
+
+### Breaking Changes ⚠️
+
+- Elements inside hidden iframes are considered hidden. Elements inside an iframe that is not visible, for example with `visibility: hidden`, are now considered hidden by actions, [`method: Locator.isVisible`] and [`method: LocatorAssertions.toBeVisible`].
+
+### Browser Versions
+
+- Chromium 156.0.8078.4
+- Mozilla Firefox 157.0
+- WebKit 27.2
+
+This version was also tested against the following stable channels:
+
+- Google Chrome 155
+- Microsoft Edge 155
+
+
## Version 1.63
### πŸͺŸ Locate across frames
diff --git a/docs/src/release-notes-java.md b/docs/src/release-notes-java.md
index 9d3170ae2f..831a6b016c 100644
--- a/docs/src/release-notes-java.md
+++ b/docs/src/release-notes-java.md
@@ -6,6 +6,112 @@ toc_max_heading_level: 2
import LiteYouTube from '@site/src/components/LiteYouTube';
+## Version 1.64
+
+### 🧰 WebMCP
+
+New [`property: Page.webmcp`] and [`property: Frame.webmcp`] give access to the tools that a page registers through
+the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) browser API, so you can test them like
+any other part of your app:
+
+```java
+Browser browser = chromium.launch(new BrowserType.LaunchOptions()
+ .setArgs(Arrays.asList("--enable-features=WebMCP")));
+Page page = browser.newPage();
+page.navigate("https://example.com");
+
+for (WebMCPTool tool : page.webmcp().tools())
+ System.out.println(tool.name + ": " + tool.description);
+
+Object result = page.webmcp().callTool("add", Map.of("a", 2, "b", 40));
+System.out.println(result); // {content=[{type=text, text=42}]}
+```
+
+[Playwright MCP](./getting-started-mcp.md) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
+
+[`playwright-cli`](./getting-started-cli.md) exposes them as well:
+
+```bash
+playwright-cli webmcp-list
+playwright-cli webmcp-call search_catalog --params '{"query":"cats"}'
+```
+
+### 🎬 Better videos
+
+Videos can now be recorded at a custom frame rate, and the decorations for actions are styled with plain CSS:
+
+```java
+page.screencast().start(new Screencast.StartOptions()
+ .setPath(Paths.get("video.webm"))
+ .setSize(1920, 1080)
+ .setFps(60));
+page.screencast().showActions(new Screencast.ShowActionsOptions()
+ .setStyle(new ScreencastActionStyle()
+ .setPoint("width: 20px; height: 20px; border-radius: 50%; background: red")
+ .setHighlight("outline: 2px solid #333; background: rgba(0, 128, 255, .15)")
+ .setTitle("font-size: 16px")));
+```
+
+- New [`option: Browser.newContext.recordVideoFps`] option and new [`option: Screencast.start.fps`] option in
+ [`method: Screencast.start`]. Firefox and WebKit currently capture up to 25 frames per second.
+- New [`option: Screencast.showActions.style`] option takes CSS declarations for the `point` marker, the target
+ `highlight` and the action `title`. It replaces the `fontSize` option, which is now deprecated.
+- The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
+- Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better
+ quality.
+- All video options are also available in [Playwright MCP](./getting-started-mcp.md) and [`playwright-cli`](./getting-started-cli.md).
+
+### πŸͺ† Locator.within()
+
+New [`method: Locator.within`] combines two locators that you already have, reading in the natural order β€”
+"this button, within that dialog":
+
+```java
+Locator saveButton = page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Save"));
+Locator dialog = page.getByTestId("settings-dialog");
+
+saveButton.within(dialog).click();
+```
+
+Relative locators such as [`method: Locator.nth`] or [`method: Locator.first`] are resolved inside each parent
+separately, which makes column-like queries straightforward:
+
+```java
+// The third cell of every row, not the third cell in the table.
+Locator thirdColumn = page.getByRole(AriaRole.CELL).nth(2).within(page.getByRole(AriaRole.ROW));
+assertThat(thirdColumn).hasText(new String[] {"Apple", "Banana", "Cherry"});
+```
+
+### New APIs
+
+- New [`method: Page.getByRef`] locates an element by its aria ref, such as `e2`, reported by [`method: Page.ariaSnapshot`] in the `"ai"` mode.
+- New option [`option: Page.content.includeShadow`] in [`method: Page.content`] and [`method: Frame.content`] serializes open shadow roots as [declarative shadow DOM](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM#declaratively_with_html).
+- New option [`option: Credentials.create.signCount`] sets the initial signature counter of a virtual credential. [`method: Credentials.create`] and [`method: Credentials.get`] return the current `signCount`, and it is saved and restored together with the credentials in the storage state.
+- New [`method: APIRequestContext.addCookies`], [`method: APIRequestContext.cookies`] and [`method: APIRequestContext.clearCookies`] manage cookies of a request context, mirroring the [BrowserContext] methods:
+
+ ```java
+ request.addCookies(Arrays.asList(
+ new Cookie("session-id", "42").setUrl("https://example.com")));
+ System.out.println(request.cookies("https://example.com"));
+ request.clearCookies(new APIRequestContext.ClearCookiesOptions().setName("session-id"));
+ ```
+
+### Breaking Changes ⚠️
+
+- Elements inside hidden iframes are considered hidden. Elements inside an iframe that is not visible, for example with `visibility: hidden`, are now considered hidden by actions, [`method: Locator.isVisible`] and [`method: LocatorAssertions.toBeVisible`].
+
+### Browser Versions
+
+- Chromium 156.0.8078.4
+- Mozilla Firefox 157.0
+- WebKit 27.2
+
+This version was also tested against the following stable channels:
+
+- Google Chrome 155
+- Microsoft Edge 155
+
+
## Version 1.63
### πŸͺŸ Locate across frames