SuperAPI AI 工具集

a11y-playwright-testing

测试与质量

查看项目

更新于 10-15 21:47

技能介绍

用途:面向 Web 应用的无障碍(a11y)自动化测试,覆盖 WCAG 2.2 AA(含 2.1 超集)合规校验、键盘可操作性、语义验证与无障碍回归预防。触发场景包括 WCAG 合规、axe-core 扫描、键盘导航测试、焦点管理、ARIA 校验、屏幕阅读器兼容性。

主要能力:axe-core 自动扫描(WCAG 2.2 AA);Tab/Enter/Space/Escape/方向键键盘测试;对话框、菜单与动态内容的焦点管理验证;landmark、标题与 ARIA 语义断言;表单标签、错误与说明测试;色彩对比度检查;屏幕阅读器兼容性测试模式。

用法:需 Node.js v18+、已装 @playwright/test、@axe-core/playwright 包与 TypeScript。安装命令:npm install -D @axe-core/playwright axe-core。用 AxeBuilder 的 .withTags() 指定标签(默认 wcag2a、wcag2aa、wcag21a、wcag21aa、wcag22a、wcag22aa),.include()/.exclude() 限定扫描范围,expect(results.violations).toEqual([])。常用命令:npx playwright test --grep "a11y"、npx playwright test --headed、npx playwright test --debug、PWDEBUG=1 npx playwright test。

限制:自动化仅能发现约 30-40% 的无障碍问题,完整合规仍需人工审计与辅助技术测试。不适用于 Selenium/Java 场景或编写 Playwright 功能 E2E 用例。例外处理应窄范围排除并记录影响、责任人与修复日期,避免全局禁用规则。页面未稳定前扫描会产生误报。