SuperAPI AI 工具集

accessibility-auditor

测试与质量

查看项目

更新于 10-16 01:39

技能介绍

用途:为 Web 应用编写、审查或调试可访问性(辅助功能)测试,目标为 WCAG 2.1 AA 合规。适用于公开面向用户的 Web 应用,资料强调该标准在多地属于法律要求(ADA、Section 508、EN 301 549、EAA)。

主要能力:结合自动化 axe-core 扫描与手动交互测试。自动扫描覆盖结构性问题(缺少 alt 文本、对比度不足、缺少标签等),资料指出其只能发现约 30%-40% 的问题;手动部分覆盖键盘导航、焦点管理、ARIA 与实时区域就绪检查;屏幕阅读器完整验证仍为人工步骤。

使用方式:基于 Playwright 与 @axe-core/playwright,提供 AxeHelper(scanPage、scanComponent、getCriticalViolations、formatViolationReport)、KeyboardNavigator(Tab/Shift+Tab 导航、获取焦点元素与完整 Tab 顺序、Enter/Space/Escape/方向键)、FocusTracker(跟踪 focusin/focusout、检测焦点丢失)以及自定义 test fixture(axe、keyboard、focusTracker、assertNoA11yViolations)。建议测试目录按 automated、keyboard、semantic、visual、interactive、media 分组。默认 axe 标签为 wcag2a、wcag2aa、wcag21a、wcag21aa。

适用场景:整页与组件级扫描、动态内容更新后的可访问性回归、键盘可操作性、焦点管理、表单标签、标题层级、地标区域、颜色对比、200% 缩放重排、动效偏好、模态与下拉等交互组件。

限制:资料未提供具体安装命令、版本要求、定价、平台支持范围或运行环境细节;只给出上述接口与结构,完整屏幕阅读器验证需人工完成。