Cypress无障碍测试高级解决方案
对比报告
不同运行周期的无障碍测试报告可以在Cypress Cloud的分支评审区域进行对比。这使您能立即发现是否引入了新问题,并深入查看仅显示新问题的完整页面HTML和CSS快照。
以下视频展示了在Pull Request中使用分支评审的示例:
手动对比两份无障碍测试报告通常具有挑战性:
- 每份报告可能针对单个Cypress运行测试了数千个应用快照
- 每个快照测试80+条无障碍规则
- 测试了多个不同页面或组件,且可能存在变更
- 元素在不同运行周期中可能被不同方式标识
Cypress无障碍测试的分支评审功能旨在帮助您轻松浏览这组嵌 套变更并发现重要内容。您可以查看特定规则下新增的无障碍违规情况,并深入查看发生这些变更的具体视图。
使用场景
对比不同运行周期的结果在多种场景下都很有用。
主要使用场景:
- 合并前检查:了解UI代码变更是否引入了净新增问题
- 监控变更:对比夜间监控运行结果,追踪由应用底层变更导致的新问题
- 检测内容问题:有时内容编辑者会引入与代码变更无关的无障碍问题。通过可视化、上下文中的示例问题,帮助您快速判断是近期代码变更问题还是内容创作问题
- 审查AI生成的代码变更:AI生成和/或审查前端代码的增多,增加了无障碍问题进入生产环境的风险。在审查pull request时查看无障碍问题的增减情况,有助于理解变更影响
- 追踪问题引入:通过每个运行周期的下拉菜单,可以快速对比不同A/B运行,找到引入问题的具体提交
- 展示问题解决情况:确认改进效果,并与团队分享概要以加速代码变更审查
报告内容

理解运行对比报告的关键在于:变更运行是所有显示数据的焦点,而基准运行仅作为对比参考点。因此您看到的任何元素或深入查看的详细信息,都只来自变更运行。
分支评审报告分为两部分:
- 新增失败元素:变更运行中存在但在基准运行中未发现的失败元素计数。这些按视图列出,针对每个检测到新失败的无障碍规则
- 已解决元素:基准运行中检测到但变更运行中不再存在的失败元素计数。这些也按视图列出,作为各无障碍规则下的改进项
如果变更运行与Pull Request关联,且运行了与基准运行相同的整体测试套件,则报告中的变更可能由pull request中的代码变更引起。
如何对比运行
第一步是进入Cypress Cloud的分支评审区域,这里可以对比不同分支,或同一分支的不同运行(如有需要)。您可以通过点击运行关联的分支名称或其他多种方式访问该区域。了解更多对比运行的方法。
各部分详情
新增失败元素
新增失败元素指在基准运行中完全不存在,或存在但通过无障碍检查的元素。
