browser_a11y_check
Run an axe-core accessibility check on the current page to identify WCAG violations, with options to restrict scan scope, exclude regions, and filter by rule tags.
Instructions
Run an axe-core accessibility check on the current page, supporting scan-scope restriction, exclude regions, and rule-tag filtering, returning a violations summary.
中文详情:
用途:使用 axe-core 对当前页面执行可访问性检查,支持限定扫描范围、排除区域和规则标签过滤,返回 violations 摘要
何时使用:上线前 WCAG 合规检查时;可访问性自动化回归时;排查元素缺少 aria-label/alt 时;针对特定组件做 a11y 局部扫描时
输出:{ ok: boolean, url: string, total: number, violations: array, passes: number, incomplete: number, summary: string } — 每项含 { id, impact, tags, description, help, nodes: array }
参数:
selector (string, 可选):CSS 选择器;指定后只扫描该区域
excludeSelectors (array, 可选):排除扫描的 CSS 选择器列表
tags (array, 可选):axe runOnly 标签,如 wcag2a/wcag2aa/best-practice
sessionName (string, 可选):浏览器会话名称,默认当前活跃会话
错误:浏览器未启动抛出 'Browser not launched';selector 无匹配抛出 'element not found'
示例:{"selector":"main","excludeSelectors":[".ad-banner"],"tags":["wcag2a","wcag2aa"]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | axe runOnly 标签,如 wcag2a、wcag2aa、best-practice | |
| selector | No | 可选 CSS 选择器;指定后只扫描该区域 | |
| sessionName | No | 浏览器会话名称,默认当前活跃会话 | |
| excludeSelectors | No | 排除扫描的 CSS 选择器列表 |