SuperAPI AI 工具集

a11y-checker-ci

测试与质量

查看项目

更新于 10-15 22:14

技能介绍

用途:把无障碍(WCAG)合规检查自动化接入持续集成,在构建与拉取请求阶段发现违规并生成报告。

主要能力:支持两种工具——@axe-core/playwright 适合已用 Playwright 的端到端测试、需测试动态或需登录页面;pa11y-ci 适合基于 URL 的简单扫描与静态或公开页面。可生成含执行摘要、按严重级别(critical、serious、moderate、minor)统计、违规详情(规则 ID、WCAG 条款、影响、受影响元素与修复建议)及历史趋势对比的 Markdown 报告。支持质量门禁阈值、允许违规与忽略选择器、自定义规则、按页面与认证页面测试,以及 GitHub Actions、GitLab CI 工作流模板,报告可输出到 GitHub、GitLab、Slack、HTML,并保存历史数据用于趋势分析。

使用方式:安装依赖,如 npm install -D @axe-core/playwright 或 npm install -D pa11y-ci;创建测试或配置后运行报告脚本,例如 python scripts/generate_a11y_report.py --input test-results/a11y-results.json --output accessibility-report.md --format github;在 CI 中配置 npm run test:a11y 并按模板设置工作流。

适用场景:已有 Playwright 或 CI 流程的项目、需要为拉取请求提供无障碍报告、设置基于无障碍的合并质量门禁、持续跟踪无障碍改善。

限制:资料未提供价格、支持平台范围、运行环境要求以外的细节,也未说明对非 Node/Python 技术栈的适配情况;部分脚本、模板与配置文件需按项目自行调整,忽略规则与阈值应定期复核。