跳转到主要内容

Accessibility

已废弃

此类别已废弃。如果您需要测试页面可访问性，请使用其他库，如 Axe。有关与 Axe 集成的信息，请参阅我们的 Node.js 指南。

Accessibility 类提供了检查 Chromium 可访问性树的方法。可访问性树被辅助技术使用，例如 屏幕阅读器 或 开关。

可访问性是一个与平台高度相关的问题。在不同的平台上，可能有截然不同的屏幕阅读器，它们可能会产生截然不同的输出。

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

在从内部浏览器 AX 树转换为特定平台 AX 树或由辅助技术本身进行转换时，大部分可访问性树会被过滤掉。默认情况下，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 元素。默认为整个页面。

返回