您的测试仍使用 Playwright, Selenium 和 pytest。我们不会替换它们。我们让它们满足企业级要求,而代码、证据和历史记录始终归您所有。

无障碍测试自动化 使用 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_ENABLEDfalse在测试结束时所在的页面上运行 axe-core 审核.
NEXUS_A11Y_STANDARDwcag21aa规则集: wcag2a, wcag2aa, wcag21a, wcag21aa 或 wcag22aa.
NEXUS_A11Y_FAIL_LEVELserious判定为违规的最低影响等级: minor, moderate, serious 或 critical.
NEXUS_A11Y_STRICTfalse设为 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, 或在设置中为所有运行启用. 无障碍设置

在您自己的机器上运行。

在您自己的机器上免费试用所有功能。无需信用卡。