Cypress无障碍测试高级解决方案
运行级别报告
本指南重点介绍了在查看Cypress运行的无障碍报告时需要关注的三个主要领域,并解释了报告中使用的关键术语和定义。
运行摘要

运行摘要提供了顶层指标,用于快速概览测试运行中的无障碍情况。点击任何指标可导航至详细报告,包括每个问题的实时DOM快照。
关键指标包括:
- 总体评分: 整个运行的综合无障碍评分。
- 失败元素: 至少违反一条无障碍规则的元素总数。
- 不确定元素: 由于无障碍检查不确定而需要手动审查的元素。
- 忽略元素: 被配置忽略但仍存在失败或不确定检查的元素。
- 规则严重性图表: 显示失败规则的Axe Core®严重级别(严重、重要、中等、轻微)的迷你图表。
- 总失败规则数: 失败规则的累计计数。
下文将进一步定义每个术语以明确含义。
视图
视图代表被测应用程序的快照集合,按页面(通过URL)或组件(通过组件测试路径)分组。视图可配置,并提供对应用程序的结构化洞察。

快照
为视图捕获的快照数量。快照表示在记录测试期间应用程序在特定时刻的实时HTML和CSS状态。当测试与元素交互、修改状态或加载动态内容时,会捕获多个快照。
评分
视图的总体评分是所有快照中通过检查与失败检查的加权比率,反映了该部分应用程序的总体无障碍水平。这产生一个顶层百分比评分,指示项目的总体无障碍情况。了解更多信息,请参阅无障碍评分部分。.
元素
视图中元素的计数,分类为:
- 失败: 违反至少一条规则的元素。这些会影响您的无障碍评分。
- 不确定: 元素在运行期间被Axe Core®标记为"未完成"的检查。这些代表由于技术原因无法完成的检查,或需要手动审查以确认是否存在无障碍问题的项目。这些不会影响您的无障碍评分。
- 忽略: 通过配置中的CSS选择器排除但仍被处理的失败或未完成检查的元素。它们不会影响您的无障碍评分。
失败规则
失败规则显示带有严重性图表(严重、重要、中等、轻微)和总计数,便于快速识别问题最严重的区域。
严重性
严重性级别对应于Axe Core®对每条规则的影响级别,提供检测问题关键性的上下文。需要注意的是,这些级别是由Axe Core的创建者Deque Systems制定的,而不是Web内容无障碍指南本身的一部分。了解更多信息,请参阅Axe Core®文档。
规则
此部分列出了运行期间启用的所有Axe Core®规则,详细说明了它们的结果。

每条规则的属性包括:
- 状态图标: 表示规则总体状态的图标,可以是以下任意一种:
- 通过: 所有元素通过检查或被忽略。
- 失败: 至少一个元素失败。
- 不确定: 至少一个元素被Axe Core®标记为"未完成"并需要手动审查,但没有元素失败。
- 不适用: 未检测到适用于此规则的元素。
- 被配置忽略: 规则在项目级别被排除。
- 描述: 规则的摘要。
- 严重性: 规则的Axe Core®严重级别。
- 计数: 规则的失败、不确定和忽略元素的计数。
筛选
您可以通过以下方式筛选无障碍报告中的视图和规则:
- 规则严重性: 严重、重要、中等或轻微。
- 规则: WCAG 2.1 A、WCAG 2.1 AA或最佳实践。
- 元素状态: 失败、不确定或其他(其他包括忽略的元素和规则、100%通过的视图和规则,以及不适用的规则)。
- 名称: 搜索特定的URL或路径以筛选视图,或搜索特定名称以筛选规则。
这样可以全面了解Cypress在运行期间评估的内容,同时能够 有针对性地分析关键问题。
