Accessibility

Accessibility 类提供了用于检查 Chromium 辅助功能树的方法。辅助功能树由诸如 屏幕阅读器 或 开关设备 等辅助技术使用。

辅助功能是非常特定于平台的内容。在不同的平台上，不同的屏幕阅读器可能会有截然不同的输出。

Chromium、Firefox 和 WebKit 的渲染引擎都有 “辅助功能树” 的概念，然后会将其转换为不同的特定于平台的 API。Accessibility 命名空间提供了对该辅助功能树的访问。

在从内部浏览器辅助功能树转换为特定于平台的辅助功能树时，或者由辅助技术本身进行转换时，大多数辅助功能树都会被过滤掉。默认情况下，Playwright 会尝试近似这种过滤，只公开树中 “有趣” 的节点。

---

已弃用

SnapshotAsync

在 v1.9 之前添加 accessibility.SnapshotAsync

已弃用

此方法已弃用。如果需要测试页面辅助功能，请使用其他库，如 Axe。有关与 Axe 集成的信息，请参阅我们的 Node.js 指南。

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

备注

Chromium 辅助功能树包含在大多数平台和大多数屏幕阅读器中未使用的节点。除非将 InterestingOnly 设置为 false，否则 Playwright 也会丢弃这些节点，以简化要处理的树。

用法

转储整个可访问性树的示例：

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 元素。默认为整个页面。

返回值

• JsonElement?#