使用 pa11y 和 axe 进行无障碍测试

Pa11y 和 axe-core 是用于自动化执行符合 WCAG 的无障碍测试的开源工具。两者都会解析页面，针对 DOM 运行规则，并报告违规项。自动捕获大多数无障碍问题；其余问题留给人工测试。

axe-core 是一个 JavaScript 库，为 Chrome DevTools、Lighthouse、Jest、Cypress、Playwright 以及许多其他工具中的无障碍审计提供支持。它是自动化无障碍测试的事实标准，具有广泛的规则覆盖范围和较低的误报率。

axe DevTools 浏览器扩展（Chrome、Firefox、Edge）会在 DevTools 中添加“无障碍”标签页。点击“扫描所有页面”后，它会列出每个违规项、受影响的元素、严重程度和修复指导。它最适合在开发过程中进行一次性审计。

Pa11y 是一个 Node.js 命令行工具：npx pa11y https://example.com 会审计一个网址。它会将问题列表输出到终端。可将它用于快速审计、Shell 脚本或低开销的持续集成。

将 axe-core 与 Playwright 结合，用于端到端无障碍测试：const results = await new AxeBuilder({ page }).analyze()。断言 results.violations.length === 0。这样可以在回归问题到达生产环境前发现它们。

jest-axe 会在 Jest 测试中针对渲染后的组件运行 axe。使用 React Testing Library 渲染组件，并将容器传给 axe：expect(await axe(container)).toHaveNoViolations()。现在，每个组件测试都包含无障碍检查。

这两个工具都允许您按项目禁用或修改规则：关闭与有意设计决策冲突的规则，并提高已知关键规则的严格程度。请通过注释说明每条被禁用规则的原因，为未来的开发者保留他们需要的上下文。

自动化工具只能捕获约 30% 至 40% 的 WCAG 问题。其余问题（有意义的焦点顺序、易于理解的替代文本、符合语义的标题层级，以及能反映实际用户界面行为的 ARIA 用法）需要人工审查。自动化对于无障碍是必要的，但并不充分。

请在 Windows 上使用 NVDA，在 Mac 上使用 VoiceOver，并针对企业受众使用 JAWS 进行测试。真实的屏幕阅读器测试可以发现自动化无法发现的问题——令人困惑的播报、失效的地标和不合逻辑的焦点顺序。每个主要 SR 在每次发布时测试一次，是一个合理的基线。

最有价值的无障碍验证，来自残障用户使用实际产品时提供的反馈。您可以通过无障碍咨询机构、大学残障服务部门或 UserTesting.com 等测试平台招募参与者。他们的真实反馈可以发现任何自动化工具都无法呈现的问题。

应因无障碍回归（新出现的违规项）阻止 PR，但不要因旧有违规项（已有基线）阻止 PR。这样既能不断提高标准，又不会阻碍发布。随着时间推移跟踪违规项总数，将其作为整体无障碍健康状况的先行指标。

请使用多个工具：用 axe 进行全面的自动化检查，用 Pa11y 提供第二种意见，再通过人工屏幕阅读器测试弥补定性方面的不足。它们之间的重叠很小；组合使用时，覆盖的问题会多于任何单个工具。

像 axe 和 Pa11y 这样的自动化工具，能够可靠捕获多少比例的 WCAG 无障碍问题？

axe-core 为大多数无障碍审计提供支持；浏览器扩展适合一次性检查，jest-axe 和 Playwright 集成适合持续测试。Pa11y 是一种互补的命令行工具。自动化可以捕获约 30% 至 40% 的问题；要实现完整覆盖，还应结合人工屏幕阅读器测试（NVDA、VoiceOver）和真实残障用户测试。在持续集成中阻止新的回归，但不要因旧有基线而阻止发布。