用途:在持续集成/持续交付中强制执行无障碍(WCAG)标准,对每次 Pull Request 自动运行无障碍检查并产出详细报告。
主要能力:支持两种工具——@axe-core/playwright(与既有 Playwright E2E 测试集成、可测动态与需登录页面、违规信息详细)和 pa11y-ci(基于 URL 的独立扫描、配置简单、可扫多 URL)。可生成含执行摘要、按严重级别(critical/serious/moderate/minor)统计、违规详情(规则 ID、WCAG 条款、影响级别、受影响元素、修复建议)与历史对比的 Markdown 报告;支持质量门禁阈值、忽略规则与选择器、自定义报告模板,以及历史数据存储与趋势分析。
使用方式:安装依赖 npm install -D @axe-core/playwright 或 npm install -D pa11y-ci;创建测试文件或 pa11y 配置;在 GitHub Actions 或 GitLab CI 中接入模板;通过 python scripts/generate_a11y_report.py --input test-results/a11y-results.json --output accessibility-report.md --format github 生成报告;可在 package.json 添加 test:a11y 等脚本。
适用场景:已有 Playwright 测试的项目、需扫描多个公开页面的站点、要求无障碍质量门禁与长期指标追踪的团队。
限制:具体许可、费用、平台兼容范围与效果未提供;忽略规则需定期复评;报告内容取决于所用工具与配置。