跳到主要内容

无障碍访问

Accessibility 类提供了检查 Chromium 无障碍功能树的方法。无障碍功能树被辅助技术使用,例如屏幕阅读器切换控制

无障碍功能是非常平台特定的。在不同的平台上,可能有不同的屏幕阅读器,它们的输出可能差异很大。

Chromium、Firefox 和 WebKit 的渲染引擎都有“无障碍功能树”的概念,然后将其转换为不同的平台特定 API。无障碍功能命名空间提供对这个无障碍功能树的访问。

当从内部浏览器 AX 树转换为平台特定的 AX 树或被辅助技术本身转换时,大部分无障碍功能树会被过滤掉。默认情况下,Playwright 尝试近似这种过滤,仅公开树的“有趣”节点。


已弃用

SnapshotAsync

在 v1.9 之前添加 accessibility.SnapshotAsync
已弃用

此方法已弃用。如果您需要测试页面无障碍功能,请使用其他库,例如 Axe。请参阅我们的 Node.js 指南,了解与 Axe 的集成。

捕获无障碍功能树的当前状态。返回的对象表示页面的根可访问节点。

注意

Chromium 无障碍功能树包含在大多数平台和大多数屏幕阅读器上未使用的节点。Playwright 也会丢弃它们,以便更容易处理树,除非 InterestingOnly 设置为 false

用法

转储整个无障碍功能树的示例

var accessibilitySnapshot = await page.Accessibility.SnapshotAsync();
Console.WriteLine(System.Text.Json.JsonSerializer.Serialize(accessibilitySnapshot));

记录焦点节点的名称的示例

var accessibilitySnapshot = await page.Accessibility.SnapshotAsync();
Console.WriteLine(System.Text.Json.JsonSerializer.Serialize(accessibilitySnapshot));

参数

  • options AccessibilitySnapshotOptions? (可选)
    • InterestingOnly bool? (可选)#

      从树中删除不感兴趣的节点。默认为 true

    • Root ElementHandle? (可选)#

      快照的根 DOM 元素。默认为整个页面。

返回值