Skip to main content
Cypress无障碍测试高级解决方案

Axe Core® 配置

Axe-Core® 规则的配置需通过客户经理获取。我们很乐意与您电话沟通,协助调整报告配置以确保获得最有价值的报告,实践证明这种对接方式非常高效。

多数情况下,无需专门配置 Cypress Cloud 中运行的这些规则,因为关于"构建失败"标准的策略实施可通过 无障碍测试结果 API 完全掌控。您可自由解析结果数据并决定需要响应的规则。在 Cypress Cloud 中保留完整结果有助于全面了解无障碍信息,即使只有部分结果会被视为阻塞性问题。

注意 部分 Axe Core® 规则默认关闭。以下是当前被配置忽略或无法检测结果的规则:

  • 元素必须满足最小色彩对比度阈值
    • 默认关闭。这是 Axe Core® 规则集中执行最慢的规则,也是误报率或未完成检查可能性最高的规则。
    • 该规则在许多项目中表现完美,如有需要,我们可为您开启以查看结果。
  • <video> 或 <audio> 元素禁止自动播放
    • 因测试回放功能尚未捕获相关元数据而被忽略
  • 延迟刷新时间必须小于20小时
    • 因测试回放功能未收集相关元数据而被忽略

组件测试

Cypress 无障碍测试完美支持组件测试。除默认关闭的规则外,"页面级"规则不会在组件测试中运行,因为组件通常挂载在空白页面中,不应包含标题或main元素等页面级结构。

Axe Core® 库更新

Axe Core® 库每年会发布多次更新。虽然 Cypress 不承诺在特定时间范围内更新内部使用的 Axe Core® 版本,但我们始终会保持至少30天的延迟更新策略。 由于某些更新可能引入新规则或修复影响问题检测方式的错误,这个缓冲期旨在为您留出时间,以便必要时调整 结果 API 的使用策略。Axe Core® 的版本发布可通过 GitHub 跟踪。

Cypress Cloud 中每次运行所使用的具体 Axe Core® 版本可在运行记录的 Properties 标签页查看,同时也包含在结果 API 的返回数据中。