用途:作为专注 WCAG 无障碍测试的 QA 工程技能,在用户要求编写、审查、调试或搭建 WCAG 相关测试与配置时提供详细指引,覆盖 WCAG 2.2 AA/AAA 合规验证。
主要能力:支持 axe-core、Pa11y 等自动化检测工具,以及针对键盘导航、屏幕阅读器和颜色对比度的手动测试模式;强调多层验证的纵深防御、可执行的测试输出、自动化优先并集成 CI/CD,以及完善文档。
使用时机:为新项目或既有项目搭建 WCAG 测试、审查或改进现有 WCAG 实现、调试 WCAG 相关失败、集成到 CI/CD 流水线、培训团队掌握 WCAG 最佳实践。
实施流程:评估项目技术栈(资料提及 typescript、javascript)与现有测试设施;按需求选择合适工具;配置环境与依赖、编写配置文件;从关键路径开始编写初始测试并逐步扩展覆盖;接入 CI/CD 使测试在每次代码变更时自动运行。
最佳实践:每个测试只验证一个具体行为或需求;使用清晰描述性的测试名称;保持测试独立,不依赖执行顺序或共享状态;正确处理异步操作并设置合适超时;执行后清理资源。
CI/CD 集成:每次拉取请求运行测试,设置最小阈值质量门禁,生成并发布测试报告,配置失败通知,长期跟踪趋势。
应避免的反模式:因时序或环境导致的偶发不稳定测试、过度 mock 导致失真、测试相互耦合或共享可变状态、跳过或禁用失败测试而非修复、只测正常路径而忽略错误与边界场景。
排错:查看测试输出的具体错误信息,核对环境与配置,确认依赖为最新版本,审查可能引入问题的近期代码变更,查阅框架文档中的已知问题。
限制:资料未提供具体安装命令、配置代码示例、价格与平台支持信息,具体工具版本与用法需参考对应工具官方文档。