无障碍访问

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

无障碍访问是一个非常依赖平台的功能。在不同的平台上，存在不同的屏幕阅读器，它们可能产生截然不同的输出。

Chromium、Firefox和WebKit的渲染引擎都有一个"可访问性树"的概念，随后会被转换为不同平台特定的API。可访问性命名空间提供了对这个可访问性树的访问。

在从内部浏览器AX树转换为平台特定的AX树或由辅助技术本身处理时，大部分可访问性树会被过滤掉。默认情况下，Playwright尝试近似这种过滤，仅暴露树中"有趣"的节点。

已弃用​

SnapshotAsync​

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

用法

一个转储整个无障碍树的示例：

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? (optional)

  • InterestingOnly bool? (可选)#

    从树中修剪掉无趣的节点。默认为 true。

  • Root ElementHandle? (可选)#

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

返回

• JsonElement?#