版本说明

版本 1.55

Codegen

• 自动 `toBeVisible()` 断言：Codegen 现在可以为常见的 UI 交互生成自动 `toBeVisible()` 断言。此功能可在 Codegen 设置 UI 中启用。

重大变更

• ⚠️ 停止支持 Chromium 扩展程序清单 v2。

杂项

• 新增对 Debian 13 "Trixie" 的支持。
• 通过 Microsoft.Playwright.Xunit.v3 添加了对 Xunit v3 的支持
• 通过 Microsoft.Playwright.MSTest.v4 添加了对 MSTest v4 的支持

浏览器版本

• Chromium 140.0.7339.16
• Mozilla Firefox 141.0
• WebKit 26.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 139
• Microsoft Edge 139

版本 1.54

亮点

• 在 BrowserContext.CookiesAsync() 和 BrowserContext.AddCookiesAsync() 中新增了 cookie 属性 PartitionKey。此属性允许保存和恢复分区 cookie。有关更多信息，请参阅 CHIPS MDN 文章。请注意，浏览器对 cookie 分区有不同的支持和默认设置。

• 多条命令中新增选项 `user-data-dir`。您可以指定相同的用户数据目录来在会话之间重用浏览状态，例如身份验证。

  pwsh bin/Debug/netX/playwright.ps1 codegen --user-data-dir=./user-data

• pwsh bin/Debug/netX/playwright.ps1 open 不再打开测试录制器。请改用 pwsh bin/Debug/netX/playwright.ps1 codegen。

浏览器版本

• Chromium 139.0.7258.5
• Mozilla Firefox 140.0.2
• WebKit 26.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 140
• Microsoft Edge 140

版本 1.53

跟踪查看器和 HTML 报告器更新

• 跟踪查看器中的新步骤：

• 新方法 Locator.Describe() 用于描述定位器。用于追踪查看器。

  var button = Page.GetByTestId("btn-sub").Describe("Subscribe button");
  await button.ClickAsync();

• pwsh bin/Debug/netX/playwright.ps1 install --list 现在将列出所有已安装的浏览器、版本和位置。

浏览器版本

• Chromium 138.0.7204.4
• Mozilla Firefox 139.0
• WebKit 18.5

此版本还针对以下稳定通道进行了测试

• Google Chrome 137
• Microsoft Edge 137

版本 1.52

亮点

• 新方法 Expect(Locator).ToContainClassAsync() 可方便地断言元素上的单个类名。

    await Expect(Page.GetByRole(AriaRole.Listitem, new() { Name = "Ship v1.52" })).ToContainClassAsync("done");

• Aria 快照 获得了两个新属性：用于严格匹配的 /children 和用于链接的 /url。

  await Expect(locator).ToMatchAriaSnapshotAsync(@"
    - list
      - /children: equal
      - listitem: Feature A
      - listitem:
        - link ""Feature B"":
          - /url: ""https://playwright.net.cn""
  ");

杂项

• 在 ApiRequest.NewContextAsync() 中新增选项 MaxRedirects，用于控制最大重定向次数。

重大变更

• 在 Page.RouteAsync() 等方法中的全局 URL 模式不再支持 ? 和 []。我们建议改用正则表达式。
• 方法 Route.ContinueAsync() 不再允许覆盖 Cookie 头。如果提供了 Cookie 头，它将被忽略，cookie 将从浏览器的 cookie 存储中加载。要设置自定义 cookie，请使用 BrowserContext.AddCookiesAsync()。
• macOS 13 已弃用，将不再接收 WebKit 更新。请升级到更新的 macOS 版本以继续受益于最新的 WebKit 改进。

浏览器版本

• Chromium 136.0.7103.25
• Mozilla Firefox 137.0
• WebKit 18.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 135
• Microsoft Edge 135

版本 1.51

亮点

• BrowserContext.StorageStateAsync() 的新选项 IndexedDB 允许保存和恢复 IndexedDB 内容。当您的应用程序使用 IndexedDB API 存储身份验证令牌（如 Firebase 身份验证）时非常有用。

  以下是遵循 身份验证指南 的示例

  // Save storage state into the file. Make sure to include IndexedDB.
  await context.StorageStateAsync(new()
  {
      Path = "../../../playwright/.auth/state.json",
      IndexedDB = true
  });
  
  // Create a new context with the saved storage state.
  var context = await browser.NewContextAsync(new()
  {
      StorageStatePath = "../../../playwright/.auth/state.json"
  });

• Locator.Filter() 的新选项 Visible 允许仅匹配可见元素。

  // Ignore invisible todo items.
  var todoItems = Page.GetByTestId("todo-item").Filter(new() { Visible = true });
  // Check there are exactly 3 visible ones.
  await Expect(todoItems).ToHaveCountAsync(3);

• 在 Page.EmulateMediaAsync() 和 Browser.NewContextAsync() 方法中新增 Contrast 选项，允许模拟 prefers-contrast 媒体特性。

• 新选项 FailOnStatusCode 使通过 APIRequestContext 发出的所有 fetch 请求在响应代码非 2xx 和 3xx 时抛出异常。

浏览器版本

• Chromium 134.0.6998.35
• Mozilla Firefox 135.0
• WebKit 18.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 133
• Microsoft Edge 133

版本 1.50

支持 Xunit

• 通过 Microsoft.Playwright.Xunit 支持 xUnit 2.8+。遵循我们的 入门 指南了解更多信息。

杂项

• 添加了方法 Expect(Locator).ToHaveAccessibleErrorMessageAsync()，用于断言 Locator 指向的元素具有给定的 aria 错误消息。

UI 更新

• Codegen 中新增按钮，用于选择元素以生成 aria 快照。
• 现在在跟踪中，除了操作 API 调用外，还显示附加详细信息（例如按下的键）。
• 在跟踪中显示 `canvas` 内容容易出错。现在默认禁用显示，可通过 `Display canvas content` UI 设置启用。
• “调用”和“网络”面板现在显示额外的计时信息。

重大变更

• Expect(Locator).ToBeEditableAsync() 和 Locator.IsEditableAsync() 现在在目标元素不是 <input>、<select> 或其他一些可编辑元素时会抛出错误。

浏览器版本

• Chromium 133.0.6943.16
• Mozilla Firefox 134.0
• WebKit 18.2

此版本还针对以下稳定通道进行了测试

• Google Chrome 132
• Microsoft Edge 132

版本 1.49

Aria 快照

新的断言 Expect(Locator).ToMatchAriaSnapshotAsync() 通过与预期的可访问性树（表示为 YAML）进行比较来验证页面结构。

await page.GotoAsync("https://playwright.net.cn");
await Expect(page.Locator("body")).ToMatchAriaSnapshotAsync(@"
  - banner:
    - heading /Playwright enables reliable/ [level=1]
    - link ""Get started""
    - link ""Star microsoft/playwright on GitHub""
  - main:
    - img ""Browsers (Chromium, Firefox, WebKit)""
    - heading ""Any browser • Any platform • One API""
");

您可以使用 测试生成器 或调用 Locator.AriaSnapshotAsync() 来生成此断言。

在 aria 快照指南 中了解更多信息。

跟踪组

新方法 Tracing.GroupAsync() 允许您在追踪查看器中对操作进行视觉分组。

// All actions between GroupAsync and GroupEndAsync
// will be shown in the trace viewer as a group.
await Page.Context.Tracing.GroupAsync("Open Playwright.dev > API");
await Page.GotoAsync("https://playwright.net.cn/");
await Page.GetByRole(AriaRole.Link, new() { Name = "API" }).ClickAsync();
await Page.Context.Tracing.GroupEndAsync();

破坏性变更：chrome 和 msedge 频道切换到新的无头模式

如果您在 `playwright.config.ts` 中使用以下通道之一，此更改会影响您

• `chrome`, `chrome-dev`, `chrome-beta`, 或 `chrome-canary`
• `msedge`, `msedge-dev`, `msedge-beta`, 或 `msedge-canary`

更新到 Playwright v1.49 后，运行您的测试套件。如果仍然通过，则一切正常。如果不能，您可能需要更新快照，并调整一些关于 PDF 查看器和扩展的测试代码。有关更多详细信息，请参阅 问题 #33566。

尝试新的 Chromium 无头模式

您可以使用 `'chromium'` 通道选择加入新的无头模式。正如 Chrome 官方文档所述

另一方面，新的无头模式是真正的 Chrome 浏览器，因此更真实、可靠，并提供更多功能。这使其更适合高精度端到端 Web 应用测试或浏览器扩展测试。

有关您可能遇到的破坏性变更列表以及 Chromium 无头模式的更多详细信息，请参阅 问题 #33566。如果您选择加入后遇到任何问题，请提交问题。

runsettings.xml

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <Playwright>
    <BrowserName>chromium</BrowserName>
    <LaunchOptions>
      <Channel>chromium</Channel>
    </LaunchOptions>
  </Playwright>
</RunSettings>

dotnet test -- Playwright.BrowserName=chromium Playwright.LaunchOptions.Channel=chromium

杂项

• Ubuntu 20.04 和 Debian 11 上的 WebKit 不再有更新。我们建议您将操作系统更新到更高版本。
• 快照中的 `` 元素现在会绘制预览。

浏览器版本

• Chromium 131.0.6778.33
• Mozilla Firefox 132.0
• WebKit 18.2

此版本还针对以下稳定通道进行了测试

• Google Chrome 130
• Microsoft Edge 130

版本 1.48

WebSocket 路由

新方法 Page.RouteWebSocketAsync() 和 BrowserContext.RouteWebSocketAsync() 允许拦截、修改和模拟页面中启动的 WebSocket 连接。下面是一个简单的示例，通过响应 "request" 与 "response" 来模拟 WebSocket 通信。

await page.RouteWebSocketAsync("/ws", ws => {
  ws.OnMessage(frame => {
    if (frame.Text == "request")
      ws.Send("response");
  });
});

有关更多详细信息，请参阅 WebSocketRoute。

UI 更新

• HTML 报告中新增了用于注解和测试位置的“复制”按钮。
• Route.FulfillAsync() 等路由方法调用不再显示在报告和追踪查看器中。您可以在网络选项卡中查看哪些网络请求被路由。
• 网络选项卡中请求的新“复制为 cURL”和“复制为 fetch”按钮。

杂项

• 新方法 Page.RequestGCAsync() 可能有助于检测内存泄漏。
• 通过 APIRequestContext 发出的请求现在在 HAR 中记录详细的计时和安全信息。

浏览器版本

• Chromium 130.0.6723.19
• Mozilla Firefox 130.0
• WebKit 18.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 129
• Microsoft Edge 129

版本 1.47

网络选项卡改进

跟踪查看器中的“网络”选项卡有几项不错的改进

• 按资产类型和 URL 筛选
• 更好地显示查询字符串参数
• 字体资产预览

杂项

• mcr.microsoft.com/playwright/dotnet:v1.47.0 现在提供基于 Ubuntu 24.04 Noble 的 Playwright 镜像。要使用基于 22.04 jammy 的镜像，请改用 mcr.microsoft.com/playwright/dotnet:v1.47.0-jammy。
• Playwright Docker 镜像的 :latest/:focal/:jammy 标签不再发布。请锁定到特定版本以获得更好的稳定性和可重现性。
• 现在可以通过将 ClientCertificates.Cert 和 ClientCertificates.Key 作为字节数组而不是文件路径传递，从内存中传递 TLS 客户端证书。
• Locator.SelectOptionAsync() 中的 NoWaitAfter 已弃用。
• 我们发现 GitHub Actions `macos-13` 上 WebGL 在 Webkit 中表现异常的报告。我们建议将 GitHub Actions 升级到 `macos-14`。

浏览器版本

• Chromium 129.0.6668.29
• Mozilla Firefox 130.0
• WebKit 18.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 128
• Microsoft Edge 128

版本 1.46

TLS 客户端证书

Playwright 现在允许提供客户端证书，以便服务器可以按照 TLS 客户端身份验证的规定进行验证。

您可以将客户端证书作为 Browser.NewContextAsync() 和 ApiRequest.NewContextAsync() 的参数提供。以下代码片段为 https://example.com 设置客户端证书。

var context = await Browser.NewContextAsync(new() {
  ClientCertificates = [
    new() {
      Origin = "https://example.com",
      CertPath = "client-certificates/cert.pem",
      KeyPath = "client-certificates/key.pem",
    }
  ]
});

跟踪查看器更新

• 文本附件的内容现在在附件窗格中内联呈现。
• 新设置，用于显示/隐藏路由操作，例如 Route.ContinueAsync()。
• 请求方法和状态显示在网络详细信息选项卡中。
• 新按钮用于将源文件位置复制到剪贴板。
• 元数据窗格现在显示 BaseURL。

杂项

• ApiRequestContext.FetchAsync() 中新增 maxRetries 选项，用于在 ECONNRESET 网络错误时进行重试。

浏览器版本

• Chromium 128.0.6613.18
• Mozilla Firefox 128.0
• WebKit 18.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 127
• Microsoft Edge 127

版本 1.45

时钟

利用新的 Clock API 允许在测试中操纵和控制时间以验证与时间相关的行为。此 API 涵盖了许多常见场景，包括

• 使用预定义时间进行测试；
• 保持一致的时间和计时器；
• 监控不活动；
• 手动逐时推进时间。

// Initialize clock with some time before the test time and let the page load naturally.
// `Date.now` will progress as the timers fire.
await Page.Clock.InstallAsync(new()
{
  TimeDate = new DateTime(2024, 2, 2, 8, 0, 0)
});
await Page.GotoAsync("https://:3333");

// Pretend that the user closed the laptop lid and opened it again at 10am.
// Pause the time once reached that point.
await Page.Clock.PauseAtAsync(new DateTime(2024, 2, 2, 10, 0, 0));

// Assert the page state.
await Expect(Page.GetByTestId("current-time")).ToHaveTextAsync("2/2/2024, 10:00:00 AM");

// Close the laptop lid again and open it at 10:30am.
await Page.Clock.FastForwardAsync("30:00");
await Expect(Page.GetByTestId("current-time")).ToHaveTextAsync("2/2/2024, 10:30:00 AM");

有关更多详细信息，请参阅 时钟指南。

杂项

• 方法 Locator.SetInputFilesAsync() 现在支持为 <input type=file webkitdirectory> 元素上传目录。

  await page.GetByLabel("Upload directory").SetInputFilesAsync("mydir");

• 多个方法，如 Locator.ClickAsync() 或 Locator.PressAsync() 现在支持 ControlOrMeta 修饰键。此键在 macOS 上映射到 Meta，在 Windows 和 Linux 上映射到 Control。

  // Press the common keyboard shortcut Control+S or Meta+S to trigger a "Save" operation.
  await page.Keyboard.PressAsync("ControlOrMeta+S");

• ApiRequest.NewContextAsync() 中新增 httpCredentials.send 属性，允许始终发送 Authorization 头，或仅在响应 401 Unauthorized 时发送。

• Playwright 现在支持 Ubuntu 24.04 上的 Chromium、Firefox 和 WebKit。

• v1.45 是 macOS 12 Monterey 接收 WebKit 更新的最后一个版本。请更新 macOS 以继续使用最新的 WebKit。

浏览器版本

• Chromium 127.0.6533.5
• Mozilla Firefox 127.0
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 126
• Microsoft Edge 126

版本 1.44

新 API

可访问性断言

• Expect(Locator).ToHaveAccessibleNameAsync() 检查元素是否具有指定的辅助功能名称。

  var locator = Page.GetByRole(AriaRole.Button);
  await Expect(locator).ToHaveAccessibleNameAsync("Submit");

• Expect(Locator).ToHaveAccessibleDescriptionAsync() 检查元素是否具有指定的辅助功能描述。

  var locator = Page.GetByRole(AriaRole.Button);
  await Expect(locator).ToHaveAccessibleDescriptionAsync("Upload a photo");

• Expect(Locator).ToHaveRoleAsync() 检查元素是否具有指定的 ARIA 角色。

  var locator = Page.GetByTestId("save-button");
  await Expect(locator).ToHaveRoleAsync(AriaRole.Button);

定位器处理程序

• 执行通过 Page.AddLocatorHandlerAsync() 添加的处理程序后，Playwright 现在将等待触发处理程序的覆盖层不再可见。您可以使用新的 NoWaitAfter 选项退出此行为。
• 您可以使用 Page.AddLocatorHandlerAsync() 中的新 Times 选项来指定处理程序应运行的最大次数。
• Page.AddLocatorHandlerAsync() 中的处理程序现在接受定位器作为参数。
• 新的 Page.RemoveLocatorHandlerAsync() 方法用于移除之前添加的定位器处理程序。

var locator = Page.GetByText("This interstitial covers the button");
await Page.AddLocatorHandlerAsync(locator, async (overlay) =>
{
    await overlay.Locator("#close").ClickAsync();
}, new() { Times = 3, NoWaitAfter = true });
// Run your tests that can be interrupted by the overlay.
// ...
await Page.RemoveLocatorHandlerAsync(locator);

杂项选项

• 新方法 FormData.Append() 允许在 APIRequestContext.FetchAsync() 的 Multipart 选项中指定具有相同名称的重复字段。

  var formData = Context.APIRequest.CreateFormData();
  formData.Append("file", new FilePayload()
  {
      Name = "f1.js",
      MimeType = "text/javascript",
      Buffer = System.Text.Encoding.UTF8.GetBytes("var x = 2024;")
  });
  formData.Append("file", new FilePayload()
  {
      Name = "f2.txt",
      MimeType = "text/plain",
      Buffer = System.Text.Encoding.UTF8.GetBytes("hello")
  });
  var response = await Context.APIRequest.PostAsync("https://example.com/uploadFiles", new() { Multipart = formData });

• Expect(Page).ToHaveURLAsync() 现在支持 IgnoreCase 选项。

浏览器版本

• Chromium 125.0.6422.14
• Mozilla Firefox 125.0.1
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 124
• Microsoft Edge 124

版本 1.43

新 API

• 方法 BrowserContext.ClearCookiesAsync() 现在支持过滤器以仅移除部分 cookie。

  // Clear all cookies.
  await Context.ClearCookiesAsync();
  // New: clear cookies with a particular name.
  await Context.ClearCookiesAsync(new() { Name = "session-id" });
  // New: clear cookies for a particular domain.
  await Context.ClearCookiesAsync(new() { Domain = "my-origin.com" });

• 新属性 Locator.ContentFrame 将 Locator 对象转换为 FrameLocator。当您在某处获取了 Locator 对象，然后想与框架内的内容进行交互时，这可能很有用。

  var locator = Page.Locator("iframe[name='embedded']");
  // ...
  var frameLocator = locator.ContentFrame;
  await frameLocator.GetByRole(AriaRole.Button).ClickAsync();

• 新属性 FrameLocator.Owner 将 FrameLocator 对象转换为 Locator。当您在某处获取了 FrameLocator 对象，然后想与 iframe 元素进行交互时，这可能很有用。

  var frameLocator = page.FrameLocator("iframe[name='embedded']");
  // ...
  var locator = frameLocator.Owner;
  await Expect(locator).ToBeVisibleAsync();

浏览器版本

• Chromium 124.0.6367.8
• Mozilla Firefox 124.0
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 123
• Microsoft Edge 123

版本 1.42

新的定位器处理程序

新方法 Page.AddLocatorHandlerAsync() 注册一个回调，当指定元素可见并可能阻塞 Playwright 操作时，该回调将被调用。回调可以移除覆盖层。这是一个关闭 cookie 对话框（当它出现时）的示例。

// Setup the handler.
await Page.AddLocatorHandlerAsync(
    Page.GetByRole(AriaRole.Heading, new() { Name = "Hej! You are in control of your cookies." }),
    async () =>
    {
        await Page.GetByRole(AriaRole.Button, new() { Name = "Accept all" }).ClickAsync();
    });
// Write the test as usual.
await Page.GotoAsync("https://www.ikea.com/");
await Page.GetByRole(AriaRole.Link, new() { Name = "Collection of blue and white" }).ClickAsync();
await Expect(Page.GetByRole(AriaRole.Heading, new() { Name = "Light and easy" })).ToBeVisibleAsync();

新 API

• Page.PdfAsync() 接受两个新选项 Tagged 和 Outline。

公告

• ⚠️ Ubuntu 18 不再受支持。

浏览器版本

• Chromium 123.0.6312.4
• Mozilla Firefox 123.0
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 122
• Microsoft Edge 123

版本 1.41

新 API

• 新方法 Page.UnrouteAllAsync() 移除所有通过 Page.RouteAsync() 和 Page.RouteFromHARAsync() 注册的路由。可选择等待正在进行的路由完成，或忽略它们产生的任何错误。
• 新方法 BrowserContext.UnrouteAllAsync() 移除所有通过 BrowserContext.RouteAsync() 和 BrowserContext.RouteFromHARAsync() 注册的路由。可选择等待正在进行的路由完成，或忽略它们产生的任何错误。
• 在 Page.ScreenshotAsync() 中新增 Style 选项，以及在 Locator.ScreenshotAsync() 中新增 Style 选项，用于在截图前向页面添加自定义 CSS。

浏览器版本

• Chromium 121.0.6167.57
• Mozilla Firefox 121.0
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 120
• Microsoft Edge 120

版本 1.40

测试生成器更新

生成断言的新工具

• “断言可见性”工具生成 Expect(Locator).ToBeVisibleAsync()。
• “断言值”工具生成 Expect(Locator).ToHaveValueAsync()。
• “断言文本”工具生成 Expect(Locator).ToContainTextAsync()。

这是一个带有断言的生成测试示例

await Page.GotoAsync("https://playwright.net.cn/");
await Page.GetByRole(AriaRole.Link, new() { Name = "Get started" }).ClickAsync();
await Expect(Page.GetByLabel("Breadcrumbs").GetByRole(AriaRole.List)).ToContainTextAsync("Installation");
await Expect(Page.GetByLabel("Search")).ToBeVisibleAsync();
await Page.GetByLabel("Search").ClickAsync();
await Page.GetByPlaceholder("Search docs").FillAsync("locator");
await Expect(Page.GetByPlaceholder("Search docs")).ToHaveValueAsync("locator");

新 API

• 在 Page.CloseAsync() 中新增 Reason 选项，在 BrowserContext.CloseAsync() 中新增 Reason 选项，在 Browser.CloseAsync() 中新增 Reason 选项。关闭原因会报告所有被关闭中断的操作。
• 在 BrowserType.LaunchPersistentContextAsync() 中新增 FirefoxUserPrefs 选项。

其他变更

• 方法 Download.PathAsync() 和 Download.CreateReadStreamAsync() 对失败和取消的下载抛出错误。
• Playwright docker 镜像 现在附带 .NET 8 (新的 LTS)。

浏览器版本

• Chromium 120.0.6099.28
• Mozilla Firefox 119.0
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 119
• Microsoft Edge 119

版本 1.39

Evergreen 浏览器更新。

浏览器版本

• Chromium 119.0.6045.9
• Mozilla Firefox 118.0.1
• WebKit 17.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 118
• Microsoft Edge 118

版本 1.38

跟踪查看器更新

1. 缩放时间范围。
2. 网络面板重新设计。

新 API

• BrowserContext.WebError
• Locator.PressSequentiallyAsync()

弃用

• 以下方法已弃用：Page.TypeAsync()、Frame.TypeAsync()、Locator.TypeAsync() 和 ElementHandle.TypeAsync()。请改用 Locator.FillAsync()，它更快。仅当页面上有特殊的键盘处理并且您需要逐个按键时，才使用 Locator.PressSequentiallyAsync()。

浏览器版本

• Chromium 117.0.5938.62
• Mozilla Firefox 117.0
• WebKit 17.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 116
• Microsoft Edge 116

版本 1.37

📚 Debian 12 Bookworm 支持

Playwright 现在支持 Debian 12 Bookworm 上的 x86_64 和 arm64 的 Chromium、Firefox 和 WebKit。如果您遇到任何问题，请告诉我们！

Linux 支持如下所示

	Ubuntu 20.04	Ubuntu 22.04	Debian 11	Debian 12
Chromium	✅	✅	✅	✅
WebKit	✅	✅	✅	✅
Firefox	✅	✅	✅	✅

浏览器版本

• Chromium 116.0.5845.82
• Mozilla Firefox 115.0
• WebKit 17.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 115
• Microsoft Edge 115

版本 1.36

🏝️ 夏季维护版本。

浏览器版本

• Chromium 115.0.5790.75
• Mozilla Firefox 115.0
• WebKit 17.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 114
• Microsoft Edge 114

版本 1.35

亮点

• 在 Page.ScreenshotAsync() 和 Locator.ScreenshotAsync() 方法中新增 MaskColor 选项，用于更改默认遮罩颜色。

• 新的 `uninstall` CLI 命令用于卸载浏览器二进制文件。

  $ pwsh bin/Debug/netX/playwright.ps1 uninstall # remove browsers installed by this installation
  $ pwsh bin/Debug/netX/playwright.ps1 uninstall --all # remove all ever-install Playwright browsers

浏览器版本

• Chromium 115.0.5790.13
• Mozilla Firefox 113.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 114
• Microsoft Edge 114

版本 1.34

亮点

• 新的 Locator.And() 用于创建同时匹配两个定位器的定位器。

  var button = page.GetByRole(AriaRole.BUTTON).And(page.GetByTitle("Subscribe"));

• 新的事件 BrowserContext.Console 和 BrowserContext.Dialog 用于订阅给定浏览器上下文中的任何页面的任何对话框和控制台消息。使用新方法 ConsoleMessage.Page 和 Dialog.Page 来精确定位事件源。

浏览器版本

• Chromium 114.0.5735.26
• Mozilla Firefox 113.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 113
• Microsoft Edge 113

版本 1.33

定位器更新

• 使用 Locator.Or() 创建一个匹配两个定位器中任何一个的定位器。考虑一种场景，您想点击“新邮件”按钮，但有时会出现安全设置对话框。在这种情况下，您可以等待“新邮件”按钮或对话框，并相应地操作。

  var newEmail = Page.GetByRole(AriaRole.Button, new() { Name = "New email" });
  var dialog = Page.GetByText("Confirm security settings");
  await Expect(newEmail.Or(dialog)).ToBeVisibleAsync();
  if (await dialog.IsVisibleAsync())
    await Page.GetByRole(AriaRole.Button, new() { Name = "Dismiss" }).ClickAsync();
  await newEmail.ClickAsync();

• 在 Locator.Filter() 中使用新选项 HasNot 和 HasNotText|HasNotTextRegex 来查找**不匹配**某些条件的元素。

  var rowLocator = Page.Locator("tr");
  await rowLocator
      .Filter(new() { HasNotText = "text in column 1" })
      .Filter(new() { HasNot = Page.GetByRole(AriaRole.Button, new() { Name = "column 2 button" })})
      .ScreenshotAsync();

• 使用新的 web-first 断言 Expect(Locator).ToBeAttachedAsync() 确保元素存在于页面 DOM 中。不要与 Expect(Locator).ToBeVisibleAsync() 混淆，后者确保元素既附加又可见。

新 API

• Locator.Or()
• Locator.Filter() 中新增选项 HasNot
• Locator.Filter() 中新增选项 HasNotText|HasNotTextRegex
• Expect(Locator).ToBeAttachedAsync()
• Route.FetchAsync() 中新增选项 Timeout

⚠️ 重大变更

• mcr.microsoft.com/playwright/dotnet:v1.33.0 现在提供基于 Ubuntu Jammy 的 Playwright 镜像。要使用基于 focal 的镜像，请改用 mcr.microsoft.com/playwright/dotnet:v1.33.0-focal。

浏览器版本

• Chromium 113.0.5672.53
• Mozilla Firefox 112.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 112
• Microsoft Edge 112

版本 1.32

新 API

• 在 Page.RouteFromHARAsync() 和 BrowserContext.RouteFromHARAsync() 中新增 UpdateMode 和 UpdateContent 选项。
• 链接现有的定位器对象，详见 定位器文档。
• 在方法 Tracing.StartChunkAsync() 中新增选项 Name。

浏览器版本

• Chromium 112.0.5615.29
• Mozilla Firefox 111.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 111
• Microsoft Edge 111

版本 1.31

新 API

• 新断言 Expect(Locator).ToBeInViewportAsync() 确保定位器指向与视口相交的元素，根据 Intersection Observer API。

  var locator = Page.GetByRole(AriaRole.Button);
  
  // Make sure at least some part of element intersects viewport.
  await Expect(locator).ToBeInViewportAsync();
  
  // Make sure element is fully outside of viewport.
  await Expect(locator).Not.ToBeInViewportAsync();
  
  // Make sure that at least half of the element intersects viewport.
  await Expect(locator).ToBeInViewportAsync(new() { Ratio = 0.5 });

• 新方法 BrowserContext.NewCDPSessionAsync() 和 Browser.NewBrowserCDPSessionAsync() 分别为页面和浏览器创建 Chrome DevTools Protocol 会话。

杂项

• 跟踪查看器中的 DOM 快照现在可以在单独的窗口中打开。
• 方法 Route.FetchAsync() 的新选项 MaxRedirects。
• Playwright 现在支持 Debian 11 arm64。
• 官方 docker 镜像 现在包含 Node 18 而不是 Node 16。

浏览器版本

• Chromium 111.0.5563.19
• Mozilla Firefox 109.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 110
• Microsoft Edge 110

版本 1.30

浏览器版本

• Chromium 110.0.5481.38
• Mozilla Firefox 108.0.2
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 109
• Microsoft Edge 109

版本 1.29

新 API

• 新方法 Route.FetchAsync() 和 Route.FulfillAsync() 的新选项 Json

  await Page.RouteAsync("**/api/settings", async route => {
    // Fetch original settings.
    var response = await route.FetchAsync();
  
    // Force settings theme to a predefined value.
    var json = await response.JsonAsync<MyDataType>();
    json.Theme = "Solarized";
  
    // Fulfill with modified data.
    await route.FulfillAsync(new() {
      Json = json
    });
  });

• 新方法 Locator.AllAsync()，用于迭代所有匹配元素。

  // Check all checkboxes!
  var checkboxes = Page.GetByRole(AriaRole.Checkbox);
  foreach (var checkbox in await checkboxes.AllAsync())
    await checkbox.CheckAsync();

• Locator.SelectOptionAsync() 现在按值或标签匹配。

  <select multiple>
    <option value="red">Red</option>
    <option value="green">Green</option>
    <option value="blue">Blue</option>
  </select>

  await element.SelectOptionAsync("Red");

浏览器版本

• Chromium 109.0.5414.46
• Mozilla Firefox 107.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 108
• Microsoft Edge 108

版本 1.28

Playwright 工具

• **Codegen 中的实时定位器。** 使用“探索”工具为页面上的任何元素生成定位器。

新 API

• Locator.BlurAsync()
• Locator.ClearAsync()

浏览器版本

• Chromium 108.0.5359.29
• Mozilla Firefox 106.0
• WebKit 16.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 107
• Microsoft Edge 107

版本 1.27

定位器

有了这些新的 API，编写定位器变得轻而易举。

• Page.GetByText() 按文本内容定位。
• Page.GetByRole() 按 ARIA 角色、ARIA 属性 和 可访问名称 定位。
• Page.GetByLabel() 按相关标签文本定位表单控件。
• Page.GetByTestId() 根据元素的 data-testid 属性（其他属性可配置）定位元素。
• Page.GetByPlaceholder() 按占位符定位输入。
• Page.GetByAltText() 按其文本替代方案定位元素，通常是图像。
• Page.GetByTitle() 按其标题定位元素。

await page.GetByLabel("User Name").FillAsync("John");

await page.GetByLabel("Password").FillAsync("secret-password");

await page.GetByRole(AriaRole.Button, new() { NameString = "Sign in" }).ClickAsync();

await Expect(Page.GetByText("Welcome, John!")).ToBeVisibleAsync();

所有相同的方法也适用于 Locator、FrameLocator 和 Frame 类。

其他亮点

• 正如 v1.25 中宣布的，Ubuntu 18 从 2022 年 12 月起将不再受支持。此外，从下一个 Playwright 版本开始，Ubuntu 18 上将不再有 WebKit 更新。

行为变更

• Expect(Locator).ToHaveAttributeAsync() 带有空值不再匹配缺失属性。例如，当 button 没有 disabled 属性时，以下代码片段将成功。

  await Expect(Page.GetByRole(AriaRole.Button)).ToHaveAttributeAsync("disabled", "");

浏览器版本

• Chromium 107.0.5304.18
• Mozilla Firefox 105.0.1
• WebKit 16.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 106
• Microsoft Edge 106

版本 1.26

断言

• Expect(Locator).ToBeEnabledAsync() 的新选项 Enabled。
• Expect(Locator).ToHaveTextAsync() 现在会穿透开放的 Shadow DOM。
• Expect(Locator).ToBeEditableAsync() 的新选项 Editable。
• Expect(Locator).ToBeVisibleAsync() 的新选项 Visible。
• Expect(Response).ToBeOKAsync() 现已可用。

其他亮点

• 新选项 MaxRedirects 用于 ApiRequestContext.GetAsync() 和其他方法，以限制重定向计数。
• Codegen 现在支持 MSTest 和 NUnit 框架。
• 现在支持 ASP .NET。

行为变更

Playwright 的许多 API 已经支持 WaitUntil: WaitUntilState.DOMContentLoaded 选项。例如

await Page.GotoAsync("https://playwright.net.cn", new() { WaitUntil = WaitUntilState.DOMContentLoaded });

在 1.26 之前，这将等待所有 iframe 触发 DOMContentLoaded 事件。

为了与 Web 规范保持一致，WaitUntilState.DOMContentLoaded 值仅等待目标框架触发 'DOMContentLoaded' 事件。使用 WaitUntil: WaitUntilState.Load 等待所有 iframe。

浏览器版本

• Chromium 106.0.5249.30
• Mozilla Firefox 104.0
• WebKit 16.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 105
• Microsoft Edge 105

版本 1.25

新增 .runsettings 文件支持

Microsoft.Playwright.NUnit 和 Microsoft.Playwright.MSTest 现在在运行端到端测试时将考虑 .runsettings 文件和通过 CLI 传递的设置。请参阅文档以获取支持设置的完整列表。

以下现在有效

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <!-- Playwright -->
  <Playwright>
    <BrowserName>chromium</BrowserName>
    <ExpectTimeout>5000</ExpectTimeout>
    <LaunchOptions>
      <Headless>true</Headless>
      <Channel>msedge</Channel>
    </LaunchOptions>
  </Playwright>
  <!-- General run configuration -->
  <RunConfiguration>
    <EnvironmentVariables>
      <!-- For debugging selectors, it's recommend to set the following environment variable -->
      <DEBUG>pw:api</DEBUG>
    </EnvironmentVariables>
  </RunConfiguration>
</RunSettings>

公告

• 🪦 这是最后一个支持 macOS 10.15 的版本（自 1.21 起已弃用）。
• ⚠️ Ubuntu 18 现已弃用，从 2022 年 12 月起将不再支持。

浏览器版本

• Chromium 105.0.5195.19
• Mozilla Firefox 103.0
• WebKit 16.0

此版本还针对以下稳定通道进行了测试

• Google Chrome 104
• Microsoft Edge 104

版本 1.24

🐂 Debian 11 Bullseye 支持

Playwright 现在支持 x86_64 上的 Debian 11 Bullseye，适用于 Chromium、Firefox 和 WebKit。如果您遇到任何问题，请告诉我们！

Linux 支持如下所示

| | Ubuntu 20.04 | Ubuntu 22.04 | Debian 11 | :--- | :---: | :---: | :---: | | Chromium | ✅ | ✅ | ✅ | | WebKit | ✅ | ✅ | ✅ | | Firefox | ✅ | ✅ | ✅ |

新入门文档

我们重写了入门文档，使其更侧重于端到端测试。在 playwright.dev 上查看它们。

版本 1.23

API 测试

Playwright for .NET 1.23 引入了新的 API 测试，允许您直接从 .NET 向服务器发送请求！现在您可以

• 测试您的服务器 API
• 在测试中访问 Web 应用程序之前准备服务器端状态
• 在浏览器中运行一些操作后验证服务器端后置条件

要代表 Playwright 页面发出请求，请使用 新 Page.APIRequest API

// Do a GET request on behalf of page
var response = await Page.APIRequest.GetAsync("http://example.com/foo.json");
Console.WriteLine(response.Status);
Console.WriteLine(response.StatusText);
Console.WriteLine(response.Ok);
Console.WriteLine(response.Headers["Content-Type"]);
Console.WriteLine(await response.TextAsync());
Console.WriteLine((await response.JsonAsync())?.GetProperty("foo").GetString());

在我们的 API 测试指南 中了解更多信息。

网络重放

现在您可以将网络流量录制到 HAR 文件中，并在测试中重新使用此流量。

将网络录制到 HAR 文件中

pwsh bin/Debug/netX/playwright.ps1 open --save-har=example.har --save-har-glob="**/api/**" https://example.com

或者，您可以以编程方式录制 HAR

var context = await browser.NewContextAsync(new()
{
  RecordHarPath = harPath,
  RecordHarUrlFilterString = "**/api/**",
});

// ... Perform actions ...

// Close context to ensure HAR is saved to disk.
context.CloseAsync();

使用新方法 Page.RouteFromHARAsync() 或 BrowserContext.RouteFromHARAsync() 从 HAR 文件提供匹配的响应

await context.RouteFromHARAsync("example.har");

在我们的文档中阅读更多内容。

高级路由

您现在可以使用 Route.FallbackAsync() 将路由推迟到其他处理程序。

请看以下示例

// Remove a header from all requests.
await page.RouteAsync("**/*", async route =>
{
    var headers = route.Request.Headers;
    headers.Remove("X-Secret");
    await route.ContinueAsync(new() { Headers = headers });
});

// Abort all images.
await page.RouteAsync("**/*", async route =>
{
    if (route.Request.ResourceType == "image")
    {
        await route.AbortAsync();
    }
    else
    {
        await route.FallbackAsync();
    }
});

请注意，新方法 Page.RouteFromHARAsync() 和 BrowserContext.RouteFromHARAsync() 也参与路由，并且可能会被推迟。

Web-First 断言更新

• 新方法 Expect(Locator).ToHaveValuesAsync() 断言 <select multiple> 元素的所有选定值。
• 方法 Expect(Locator).ToContainTextAsync() 和 Expect(Locator).ToHaveTextAsync() 现在接受 ignoreCase 选项。

杂项

• 如果有一个服务工作线程妨碍了您，您现在可以使用新的上下文选项 serviceWorkers 轻松禁用它

  var context = await Browser.NewContextAsync(new()
  {
      ServiceWorkers = ServiceWorkerPolicy.Block
  });

• 为 recordHar 上下文选项使用 .zip 路径会自动压缩生成的 HAR

  var context = await Browser.NewContextAsync(new() { RecordHarPath = "example.har.zip" });

• 如果您打算手动编辑 HAR，请考虑使用 "minimal" HAR 录制模式，该模式仅录制重放所需的信息

  var context = await Browser.NewContextAsync(new() { RecordHarPath = "example.har", RecordHarMode = HarMode.Minimal });

• Playwright 现在可以在 Ubuntu 22 amd64 和 Ubuntu 22 arm64 上运行。

• Playwright for .NET 现在支持 linux-arm64，并为其提供 arm64 Ubuntu 20.04 Docker 镜像。

版本 1.22

亮点

• 角色选择器，允许通过元素的 ARIA 角色、ARIA 属性 和 可访问名称 来选择元素。

  // Click a button with accessible name "log in"
  await page.Locator("role=button[name='log in']").ClickAsync();

  在 我们的文档 中阅读更多信息。

• 新的 Locator.Filter() API，用于过滤现有定位器

  var buttons = page.Locator("role=button");
  // ...
  var submitLocator = buttons.Filter(new() { HasText = "Sign up" });
  await submitLocator.ClickAsync();

版本 1.21

亮点

• 新的角色选择器允许通过元素的 ARIA 角色、ARIA 属性 和 可访问名称 来选择元素。

  // Click a button with accessible name "log in"
  await page.Locator("role=button[name='log in']").ClickAsync();

  在 我们的文档 中阅读更多信息。

• Page.ScreenshotAsync() 中的新 scale 选项，用于更小的截图。

• Page.ScreenshotAsync() 中的新 caret 选项，用于控制文本插入符。默认为 "hide"。

• 我们现在发布了一个指定的 .NET Docker 镜像 mcr.microsoft.com/playwright/dotnet。在 我们的文档 中阅读更多信息。

行为变更

• Playwright 现在通过 Locator.SetInputFilesAsync() API 支持大文件上传（数百兆字节）。

浏览器版本

• Chromium 101.0.4951.26
• Mozilla Firefox 98.0.2
• WebKit 15.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 100
• Microsoft Edge 100

版本 1.20

Web-First 断言

Playwright for .NET 1.20 引入了 Web-First 断言。

请看以下示例

using System.Threading.Tasks;
using Microsoft.Playwright.NUnit;
using NUnit.Framework;

namespace PlaywrightTests;

[TestFixture]
public class ExampleTests : PageTest
{
    [Test]
    public async Task StatusBecomesSubmitted()
    {
        await Expect(Page.Locator(".status")).ToHaveTextAsync("Submitted");
    }
}

Playwright 将不断重新测试选择器为 .status 的节点，直到获取到的节点包含文本 "Submitted"。它将反复重新获取节点并检查，直到满足条件或达到超时。

在 我们的文档 中阅读更多信息。

其他更新

• Page.ScreenshotAsync()、Locator.ScreenshotAsync() 和 ElementHandle.ScreenshotAsync() 方法的新选项。
  • 选项 ScreenshotAnimations.Disabled 将所有 CSS 动画和过渡倒回一致状态。
  • 选项 mask: Locator[] 遮罩给定元素，用粉红色 #FF00FF 方框覆盖它们。
• Locator.HighlightAsync() 视觉上显示元素，以便于调试。

公告

• v1.20 是 macOS 10.15 Catalina 接收 WebKit 更新的最后一个版本。请更新 macOS 以继续使用最新最好的 WebKit！

浏览器版本

• Chromium 101.0.4921.0
• Mozilla Firefox 97.0.1
• WebKit 15.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 99
• Microsoft Edge 99

版本 1.19

亮点

• Locator 现在支持 has 选项，确保它内部包含另一个定位器

  await Page.Locator("article", new() { Has = Page.Locator(".highlight") }).ClickAsync();

  在 定位器文档 中阅读更多信息。

• 新的 Locator.Page

• Page.ScreenshotAsync() 和 Locator.ScreenshotAsync() 现在会自动隐藏闪烁的插入符。

• Playwright Codegen 现在生成定位器和帧定位器

浏览器版本

• Chromium 100.0.4863.0
• Mozilla Firefox 96.0.1
• WebKit 15.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 98
• Microsoft Edge 98

版本 1.18

定位器改进

• Locator.DragToAsync()

• 现在每个定位器都可以选择通过它包含的文本进行过滤

  await Page.Locator("li", new() { HasTextString = "My Item" })
            .Locator("button").click();

  在 定位器文档 中阅读更多信息。

新 API 和变更

• AcceptDownloads 选项现在默认为 true。
• Sources 选项用于将源嵌入到跟踪中。

浏览器版本

• Chromium 99.0.4812.0
• Mozilla Firefox 95.0
• WebKit 15.4

此版本还针对以下稳定通道进行了测试

• Google Chrome 97
• Microsoft Edge 97

版本 1.17

帧定位器

Playwright 1.17 引入了 框架定位器 - 页面上 iframe 的定位器。框架定位器捕获足以检索 iframe 并定位该 iframe 中元素的逻辑。框架定位器默认是严格的，会等待 iframe 出现，并且可以在 Web-First 断言中使用。

框架定位器可以使用 Page.FrameLocator() 或 Locator.FrameLocator() 方法创建。

var locator = page.FrameLocator("#my-frame").Locator("text=Submit");
await locator.ClickAsync();

在 我们的文档 中阅读更多信息。

Trace Viewer 更新

Playwright 追踪查看器现在 在线可用，地址是 https://trace.playwright.dev！只需将您的 trace.zip 文件拖放到那里即可检查其内容。

注意：追踪文件不会上传到任何地方；trace.playwright.dev 是一个 渐进式 Web 应用程序，它在本地处理追踪。

• Playwright Test 跟踪现在默认包含源（可以通过跟踪选项关闭）
• Trace Viewer 现在显示测试名称
• 新的跟踪元数据选项卡，包含浏览器详细信息
• 快照现在有 URL 栏

HTML 报告更新

• HTML 报告现在支持动态过滤
• 报告现在是一个单个静态 HTML 文件，可以通过电子邮件或作为 slack 附件发送。

Ubuntu ARM64 支持 + 更多

• Playwright 现在支持 Ubuntu 20.04 ARM64。您现在可以在 Apple M1 和 Raspberry Pi 上 Docker 内运行 Playwright 测试。

• 您现在可以使用 Playwright 在 Linux 上安装稳定版 Edge

  pwsh bin/Debug/netX/playwright.ps1 install msedge

新 API

• 追踪现在支持 'title' 选项。
• 页面导航支持新的 'commit' 等待选项。

版本 1.16

🎭 Playwright 库

Locator.WaitForAsync

等待定位器解析为具有给定状态的单个元素。默认为 state: 'visible'。

var orderSent = page.Locator("#order-sent");
orderSent.WaitForAsync();

了解更多关于 Locator.WaitForAsync() 的信息。

🎭 Playwright 跟踪查看器

• 运行追踪查看器：pwsh bin/Debug/netX/playwright.ps1 show-trace，然后将追踪文件拖放到追踪查看器 PWA 中
• 更好的操作目标视觉归因

了解更多关于 Trace Viewer 的信息。

浏览器版本

• Chromium 97.0.4666.0
• Mozilla Firefox 93.0
• WebKit 15.4

此版本的 Playwright 也针对以下稳定通道进行了测试

• Google Chrome 94
• Microsoft Edge 94

版本 1.15

🖱️ 鼠标滚轮

通过使用 Mouse.WheelAsync()，您现在可以垂直或水平滚动。

📜 新的 Headers API

以前无法获取响应的多个 header 值。现在这成为可能，并且提供了额外的辅助函数

• Request.AllHeadersAsync()
• Request.HeadersArrayAsync()
• Request.HeaderValueAsync()
• Response.AllHeadersAsync()
• Response.HeadersArrayAsync()
• Response.HeaderValueAsync()
• Response.HeaderValuesAsync()

🌈 强制颜色模拟

现在可以通过在 Browser.NewContextAsync() 中传递或调用 Page.EmulateMediaAsync() 来模拟 forced-colors CSS 媒体特性。

新 API

• Page.RouteAsync() 接受新的 times 选项来指定此路由应该匹配的次数。
• 引入了 Page.SetCheckedAsync() 和 Locator.SetCheckedAsync()，用于设置复选框的选中状态。
• Request.SizesAsync() 返回给定 HTTP 请求的资源大小信息。
• Tracing.StartChunkAsync() - 开始一个新的追踪块。
• Tracing.StopChunkAsync() - 停止一个新的追踪块。

重要 ⚠

• ⬆ 对于我们的 CLI 工具，不再支持 .NET Core Apps 2.1。截至 2021 年 8 月 31 日，.NET Core 2.1 不再受支持，也不会收到任何安全更新。我们决定将 CLI 推向未来，最低要求 .NET Core 3.1。

浏览器版本

• Chromium 96.0.4641.0
• Mozilla Firefox 92.0
• WebKit 15.0

版本 1.14

⚡️ 新的“严格”模式

选择器歧义是自动化测试中的常见问题。“严格”模式确保您的选择器指向单个元素，否则会抛出错误。

在您的操作调用中设置 setStrict(true) 以选择加入。

// This will throw if you have more than one button!
await page.Locator("button", new() { Strict = true });

📍 新 定位器 API

Locator 表示页面上的元素视图。它捕获了足以在任何给定时刻检索元素的逻辑。

Locator 和 ElementHandle 之间的区别在于，后者指向特定元素，而 Locator 捕获了如何检索该元素的逻辑。

此外，定位器默认是“严格”的！

var locator = page.Locator("button");
await locator.ClickAsync();

在 文档 中了解更多信息。

🧩 实验性 React 和 Vue 选择器引擎

React 和 Vue 选择器允许通过其组件名称和/或属性值选择元素。语法与 属性选择器 非常相似，并支持所有属性选择器运算符。

await page.Locator("_react=SubmitButton[enabled=true]").ClickAsync();
await page.Locator("_vue=submit-button[enabled=true]").ClickAsync();

在 react 选择器文档 和 vue 选择器文档 中了解更多信息。

✨ 新 nth 和 visible 选择器引擎

• nth 选择器引擎等效于 :nth-match 伪类，但可以与其他选择器引擎结合使用。
• visible 选择器引擎等效于 :visible 伪类，但可以与其他选择器引擎结合使用。

// select the first button among all buttons
await button.ClickAsync("button >> nth=0");
// or if you are using locators, you can use First, Nth() and Last
await page.Locator("button").First.ClickAsync();

// click a visible button
await button.ClickAsync("button >> visible=true");

浏览器版本

• Chromium 94.0.4595.0
• Mozilla Firefox 91.0
• WebKit 15.0

版本 1.13

Playwright

• 🖖 通过 Page.DragAndDropAsync() API 支持程序化拖放。
• 🔎 增强的 HAR，带有请求和响应的主体大小。通过 Browser.NewContextAsync() 中的 recordHar 选项使用。

工具

• Playwright Trace Viewer 现在显示参数、返回值和 console.log() 调用。

新的和 overhauled 指南

• 介绍
• 身份验证

浏览器版本

• Chromium 93.0.4576.0
• Mozilla Firefox 90.0
• WebKit 14.2

新的 Playwright API

• 在 Browser.NewContextAsync() 和 Browser.NewPageAsync() 中新增 baseURL 选项。
• Response.SecurityDetailsAsync() 和 Response.ServerAddrAsync()
• Page.DragAndDropAsync() 和 Frame.DragAndDropAsync()
• Download.CancelAsync()
• Page.InputValueAsync()、Frame.InputValueAsync() 和 ElementHandle.InputValueAsync()
• 在 Page.FillAsync()、Frame.FillAsync() 和 ElementHandle.FillAsync() 中新增 force 选项。
• 在 Page.SelectOptionAsync()、Frame.SelectOptionAsync() 和 ElementHandle.SelectOptionAsync() 中新增 force 选项。

版本 1.12

亮点

• Playwright for .NET v1.12 现已稳定！
• 开箱即用，附带 codegen 和 trace viewer 工具。

浏览器版本

• Chromium 93.0.4530.0
• Mozilla Firefox 89.0
• WebKit 14.2

此版本的 Playwright 也针对以下稳定通道进行了测试

• Google Chrome 91
• Microsoft Edge 91