无障碍测试自动化 使用 axe-core 和 WCAG.
Nexus StudioQA 中的无障碍测试自动化会在测试结束时针对当前页面运行 axe-core, 并列出每条被触发的 WCAG 规则及其影响程度和涉及的元素. 默认情况下, 结果仅供参考. 在严格模式下, 已通过的测试如果存在严重或更高等级的违规, 则会显示 A11Y_VIOLATION. 自动检查只能发现部分无障碍问题, 因此不能替代人工审查.
作者:Verdict System LLC 的 Nexus StudioQA 团队。
最后更新: .
检查内容及启用方式
检查默认关闭, 需手动启用: 使用 --a11y 可为单次运行启用, 使用 NEXUS_A11Y_ENABLED=true 可为每次运行启用. 此功能需要 @axe-core/playwright 附加组件; 如果未安装, 报告会显示 “未测量”, 且不会影响测试.
| 设置 | 默认 | 功能 |
|---|---|---|
NEXUS_A11Y_ENABLED | false | 在测试结束时所在的页面上运行 axe-core 审核. |
NEXUS_A11Y_STANDARD | wcag21aa | 规则集: wcag2a, wcag2aa, wcag21a, wcag21aa 或 wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | 判定为违规的最低影响等级: minor, moderate, serious 或 critical. |
NEXUS_A11Y_STRICT | false | 设为 true 时, 达到或超过失败阈值的违规会将已通过的测试标记为 A11Y_VIOLATION. |
评分与结果判定方式
A11Y_VIOLATION 是 15 种判定结果之一. 它仅适用于已通过的测试, 在 CI 中退出码为 0, 报告和历史记录会显示这项保留意见. 已失败的测试不会升级判定, 混沌测试运行期间则会跳过审核. 对于模拟或真实的触摸屏, 还会按照 WCAG 2.2 AA 进行审核, 其中新增了目标尺寸要求.
| Impact | 评分权重 |
|---|---|
| 极严重 | 每条违规规则扣 25 分 |
| 严重 | 每条违规规则扣 10 分 |
| 中等 | 每条违规规则扣 4 分 |
| 轻微 | 每条违规规则扣 1 分 |
报告内容
分数与等级
分数为 100 减去上述权重, 每条违规规则仅计一次, 不按元素数量累计. 90 分及以上为 A, 75 分起为 B, 60 分起为 C, 40 分起为 D, 低于 40 分为 F. 这是我们对单个页面的自定义总结, 并非 WCAG 符合性等级.
被触发的规则
最多列出 15 条规则, 按严重程度从高到低排列, 每条包含影响程度, WCAG 标签, 规则帮助页面的链接以及最多 5 个示例元素. 此部分会添加到 report.md 中.
需人工处理的检查项数量
当 axe-core 无法作出判断时, 会将部分检查项标记为未完成. 报告会统计这些检查项, 并注明需要人工审查.
自动检查无法发现的问题
自动检查只能发现页面上的部分无障碍问题. 未发现问题并不意味着页面已实现无障碍, Nexus StudioQA 也不提供 WCAG 符合性认证.
不仅要检查标记, 还要理解含义
规则可以检查图片是否有替代文本. 但它无法判断该文本是否准确描述了图片, 也无法判断链接的文字在脱离上下文后是否仍然有意义.
使用键盘或屏幕阅读器
阅读顺序是否合理, 以及能否仅使用键盘或借助屏幕阅读器操作页面, 都需要人工实际测试.
每次测试仅检查一种页面状态
审核在测试结束时所在的页面上运行. 测试从未访问过的页面, 或在结束前已关闭的状态, 都不会接受审核.
常见问题
自动化测试能否替代人工无障碍审核?
不能. 它会检测机器能够判定的规则, 并将其余检查项列为需要审查. 应用它来防止两次人工审核之间出现功能回退, 而不是替代人工审核.
无障碍问题会导致构建失败吗?
默认不会. 问题会列在报告中. 设置
NEXUS_A11Y_STRICT=true后, 如果已通过的测试存在达到或超过失败阈值的违规, 则会显示 A11Y_VIOLATION, 但在 CI 中退出码仍为 0.它按照哪个 WCAG 版本进行测试?
默认采用 WCAG 2.1 AA. 设置中可选择 2.0 和 2.1 的 A 级与 AA 级, 以及 2.2 AA. 在触摸屏上, 还会加入 WCAG 2.2 AA.
能与我现有的测试配合使用吗?
可以. 对于通过 Nexus StudioQA 运行的 Playwright, Selenium 或 pytest 测试, 它会与测试断言一同运行. 可在单次运行时加上
--a11y, 或在设置中为所有运行启用. 无障碍设置