SuperAPI AI 工具集

accessibility-test-axe

测试与质量

查看项目

更新于 10-15 21:08

技能介绍

用途:面向无障碍(a11y)自动化测试,使用 axe-core 这一 WCAG 合规检查的行业标准工具,对网页与组件进行可访问性审计。主张 shift-left,在开发早期而非发布后集成检查,并将自动扫描与人工测试结合。

主要能力:运行 axe.run 扫描并返回 violations、passes、incomplete、inapplicable 结果;按 wcag2a、wcag2aa、wcag21aa 等标签筛选规则;支持 include/exclude 指定或排除区域;可配置规则开关与选择器例外;按 impact 分级(critical、serious、moderate、minor)处理违规;提供违规趋势监控与报告。

使用方式:安装命令为 npm install axe-core @axe-core/playwright @axe-core/react。可在浏览器中调用 axe.run;在 Playwright 中用 AxeBuilder 的 withTags、include、exclude、analyze 编写断言;在 Storybook 的 test-runner.js 中通过 axe-playwright 的 injectAxe 与 checkA11y 注入检查;在 React 开发环境用 @axe-core/react 自动检测;在 GitHub Actions 中安装依赖与 Playwright 后运行 npm run test:a11y,失败时上传 a11y-results.json。

适用场景:前端组件与页面的可访问性回归测试、CI/CD 质量门禁、Storybook 组件审计、React 开发期检测。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;自动扫描无法替代人工测试,需结合使用;部分规则需按项目情况配置例外并记录原因。