Playwright-dotnet v1.51.0版本发布：增强存储状态管理与元素过滤能力

Playwright-dotnet作为微软推出的跨浏览器自动化测试框架，为.NET开发者提供了强大的端到端测试能力。最新发布的v1.51.0版本带来了一系列实用的新特性，特别是在浏览器状态管理和元素定位方面有了显著增强。

核心特性解析

1. IndexedDB存储状态支持

IndexedDB是浏览器中用于存储大量结构化数据的API，许多现代Web应用（如使用Firebase认证的应用）都依赖它来保存关键数据。v1.51.0版本新增了对IndexedDB的存储状态支持，使得测试脚本能够完整保存和恢复应用状态。

开发者现在可以通过BrowserContext.StorageStateAsync方法将IndexedDB数据与cookie、localStorage等一起保存到文件中，然后在新的浏览器上下文中恢复这些数据。这一特性特别适合需要处理复杂认证流程的应用测试场景。

2. 可见元素过滤功能

在UI自动化测试中，经常需要区分页面上可见和不可见的元素。新版本为Locator.Filter方法增加了Visible选项，使开发者能够轻松筛选出当前可见的元素。

这一改进使得测试断言更加精确，避免了因隐藏元素导致的误判。例如，在测试待办事项列表时，可以只针对可见项进行计数验证，确保测试结果与实际用户可见的界面保持一致。

3. 对比度媒体特性模拟

为了提升无障碍测试能力，v1.51.0新增了对比度媒体特性的模拟支持。通过page.emulateMedia方法和Browser.NewContextAsync的Contrast选项，开发者可以测试应用在不同对比度偏好下的表现，确保应用的可访问性符合标准。

4. API请求状态码控制

对于使用APIRequestContext进行HTTP请求的场景，新增的FailOnStatusCode选项可以自动将非2xx/3xx的响应视为错误。这一特性简化了API测试中的错误处理逻辑，使测试代码更加简洁。

实际应用示例

IndexedDB状态保存与恢复

// 保存包含IndexedDB的完整状态
await context.StorageStateAsync(new()
{
    Path = "auth_state.json",
    IndexedDB = true
});

// 使用保存的状态创建新上下文
var newContext = await browser.NewContextAsync(new()
{
    StorageStatePath = "auth_state.json"
});

可见元素过滤

// 只获取可见的待办事项
var visibleTodos = page.GetByTestId("todo-item").Filter(new() { Visible = true });
await Expect(visibleTodos).ToHaveCountAsync(3);

浏览器兼容性

v1.51.0版本基于以下浏览器引擎：

• Chromium 134.0.6998.35
• Firefox 135.0
• WebKit 18.4

同时，该版本也已针对Chrome 133和Edge 133等稳定版浏览器进行了充分测试。

升级建议

对于正在使用Playwright-dotnet进行自动化测试的团队，特别是那些需要处理复杂认证状态或严格可见性验证的场景，建议尽快升级到v1.51.0版本。新特性将显著提升测试的可靠性和表达能力，同时简化测试代码的编写。

对于无障碍测试需求的团队，新的对比度模拟功能也为验证应用的可访问性提供了更全面的支持。