Accessibility

Accessibility 类提供用于检查 Chromium 的无障碍树的方法。无障碍树由辅助技术使用，例如屏幕阅读器或开关。

无障碍是与平台高度相关的事物。在不同的平台上，有不同的屏幕阅读器，它们的输出可能截然不同。

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

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

已弃用

snapshot

添加在 v1.9 之前

accessibility.snapshot

已弃用

此方法已弃用。如果您需要测试页面无障碍性，请使用其他库，例如 Axe。有关与 Axe 集成的信息，请参阅我们的 Node.js 指南。

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

注意

Chromium 无障碍树包含在大多数平台和大多数屏幕阅读器上未使用的节点。Playwright 也会将它们丢弃以获得更易于处理的树，除非 interesting_only 设置为 false。

用法

转储整个无障碍树的示例

同步
异步

snapshot = page.accessibility.snapshot()
print(snapshot)

snapshot = await page.accessibility.snapshot()
print(snapshot)

记录焦点节点名称的示例

同步
异步

def find_focused_node(node):
    if node.get("focused"):
        return node
    for child in (node.get("children") or []):
        found_node = find_focused_node(child)
        if found_node:
            return found_node
    return None

snapshot = page.accessibility.snapshot()
node = find_focused_node(snapshot)
if node:
    print(node["name"])

def find_focused_node(node):
    if node.get("focused"):
        return node
    for child in (node.get("children") or []):
        found_node = find_focused_node(child)
        if found_node:
            return found_node
    return None

snapshot = await page.accessibility.snapshot()
node = find_focused_node(snapshot)
if node:
    print(node["name"])

参数

interesting_only bool (可选)#

从树中修剪不感兴趣的节点。默认值为 true。
root ElementHandle (可选)#

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

NoneType | Dict#
- role str
  
  该角色。
- name str
  
  节点的人类可读名称。
- value str | float
  
  节点的当前值（如果适用）。
- description str
  
  节点的额外人类可读描述（如果适用）。
- keyshortcuts str
  
  与该节点关联的键盘快捷键（如果适用）。
- roledescription str
  
  角色的人类可读替代（如果适用）。
- valuetext str
  
  当前值的描述（如果适用）。
- disabled bool
  
  节点是否被禁用（如果适用）。
- expanded bool
  
  节点是否已展开或折叠（如果适用）。
- focused bool
  
  节点是否处于焦点（如果适用）。
- modal bool
  
  节点是否为模态（如果适用）。
- multiline bool
  
  节点文本输入是否支持多行（如果适用）。
- multiselectable bool
  
  是否可以选中多个子节点（如果适用）。
- readonly bool
  
  节点是否为只读（如果适用）。
- required bool
  
  节点是否为必填（如果适用）。
- selected bool
  
  节点是否在其父节点中被选中（如果适用）。
- checked bool | "mixed"
  
  复选框是否已选中，或为“mixed”（如果适用）。
- pressed bool | "mixed"
  
  切换按钮是否已选中，或为“mixed”（如果适用）。
- level int
  
  标题的级别（如果适用）。
- valuemin float
  
  节点中的最小值（如果适用）。
- valuemax float
  
  节点中的最大值（如果适用）。
- autocomplete str
  
  控件支持的自动完成功能类型（如果适用）。
- haspopup str
  
  当前为节点显示的弹出窗口类型（如果适用）。
- invalid str
  
  节点的值是否无效以及无效的方式（如果适用）。
- orientation str
  
  节点是水平还是垂直方向（如果适用）。
- children List[Dict]
  
  子节点（如果有）（如果适用）。

已弃用​

snapshot​

已弃用

snapshot