Puppeteer 中文文档v25.8.0

Accessibility 类

Accessibility 类提供了检查浏览器无障碍树的方法。无障碍树被辅助技术使用,例如屏幕阅读器开关控制

签名

export declare class Accessibility

备注

无障碍是一个高度依赖平台的问题。在不同的平台上,有不同的屏幕阅读器,它们的输出可能差异巨大。

Blink(Chrome 的渲染引擎)有一个"无障碍树"的概念,它会被转换为不同平台特定的 API。Accessibility 命名空间使用户能够访问 Blink 无障碍树。

在从 Blink AX 树转换为平台特定的 AX 树时,或者由辅助技术本身处理时,无障碍树的大部分内容会被过滤掉。默认情况下,Puppeteer 会尝试近似这种过滤,只暴露树中"有趣"的节点。

此类的构造函数被标记为内部。第三方代码不应直接调用构造函数,也不应创建扩展 Accessibility 类的子类。

方法

方法

修饰符

说明

snapshot(options)

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

备注:

注意 Chrome 无障碍树包含在许多平台和大多数屏幕阅读器上都不会用到的节点。Puppeteer 也会丢弃它们,以便更轻松地处理树,除非将 interestingOnly 设置为 false