ARIA 快照

概述

在 Playwright 中,ARIA 快照提供了页面可访问性树的 YAML 表示。这些快照可以存储并在后续进行比较,以验证页面结构是否保持一致或是否符合预期。

YAML 格式描述了页面上可访问元素的层次结构,详细列出了 角色属性文本内容。该结构遵循类似树的语法,其中每个节点表示一个可访问元素,缩进表示嵌套元素。

以下是 playwright.dev 主页的一个简单 aria 快照示例:

- banner:
  - heading /Playwright enables reliable/ [level=1]
  - link "Get started"
  - link "Star microsoft/playwright on GitHub"
- main:
  - img "Browsers (Chromium, Firefox, WebKit)"
  - heading "Any browser • Any platform • One API"

树中的每个可访问元素都表示为一个 YAML 节点:

- role "name" [attribute=value]
  • role: 指定元素的 ARIA 或 HTML 角色(例如,heading、list、listitem、button)。

  • "name": 元素的可访问名称。引用的字符串表示精确值,/patterns/ 用于正则表达式。

  • [attribute=value]: 用方括号表示的属性和值,代表特定的 ARIA 属性,例如 checkeddisabledexpandedlevelpressedselected。这些值来自 ARIA 属性或基于 HTML 语义计算得出。

要检查页面的可访问性树结构,可以使用 Chrome 开发者工具中的可访问性面板(Accessibility Pane)。

截图匹配

部分匹配

使用正则表达式匹配

生成截图

可访问性树示例