Browser Audit — 浏览器审计

浏览器审计 在部署前，在真实浏览器中审计渲染的页面。将Lighthouse和自动化的无障碍检查视为强烈信号，而不是完整的符合性声明。对于自动化无法可靠证明的任何内容，始终包含手动浏览器检查。

工作流程 确认范围：目标URL、视口、认证状态和关键用户流。如果未指定，则在桌面和移动宽度下审计提供的/当前页面。在浏览器中打开页面。对于localhost或预览URL，使用可用的浏览器自动化/内置浏览器工具。尽可能为每个视口捕获至少一张截图。运行自动化检查：Lighthouse类别：无障碍、SEO、最佳实践和性能（当性能风险很重要时）。浏览器控制台错误、失败的网络请求、混合内容、CSP/安全警告。DOM检查：标题、元描述、规范、机器人、视口、html[lang]、标题结构、图像alt文本、表单标签、无障碍名称、重复ID、无效/破损ARIA引用、地标存在和空/模糊链接/按钮。对于关键导航、对话框、控件、表单和重复组件进行无障碍树检查。运行手动浏览器检查：仅键盘导航：Tab、Shift+Tab、Enter、Space、Escape、箭头键用于复合部件、无不可达控件、无意外陷阱。焦点可见性和焦点管理：可见焦点、不被粘性UI遮挡、对话框捕获/恢复焦点、路由更改合理地放置焦点。对比度和视觉状态：文本、图标、边框、禁用/错误/焦点状态、悬停仅信息、活动导航。响应式UX：移动宽度、200%缩放（如果可行）、目标大小、无水平滚动、无重叠文本或控件。表单和验证：标签、必需/无效状态、错误消息、自动完成、冗余输入风险、提交反馈。关键UX：破损布局、阻塞主调用操作、加载状态永远无法解决、覆盖内容、隐私/cookie横幅阻塞键盘用户。将发现结果映射到严重性和优先级。除非问题在渲染的浏览器中得到确认或明确标记为源代码仅问题，否则不要报告仅从静态源代码检查中发现的问题。以以下格式生成结构化报告。显式标记无法完成的手动检查。

自动化指南 首选以下顺序的最强自动化：现有项目脚本或CI检查，用于Lighthouse、axe、Playwright或浏览器QA。Lighthouse CLI或Node API。典型的CLI形状：lighthouse --only-categories=accessibility,seo,best-practices,performance --output=json --output=html --chrome-flags="--headless" 使用JS代码段和无障碍树快照的浏览器自动化。Chrome DevTools Lighthouse面板或PageSpeed Insights（当CLI自动化不可用时）。如果工具不可用或需要依赖项安装/网络访问，请继续进行浏览器可见检查，并在报告中说明限制。

标准 使用以下基准：WCAG 2.2级别AA用于无障碍。包括级别A和AA问题；除可选UX改进外，不要求AAA。WAI-ARIA 1.2和ARIA编写指南，用于角色、状态、属性、无障碍名称和键盘模式。Lighthouse用于自动化无障碍、SEO、最佳实践和性能信号。当您需要详细的检查清单、严重性评级或手动检查限制时，请阅读references/audit-criteria.md。从不仅凭借此审计声称“WCAG兼容”。说“在此浏览器审计中未发现阻塞问题”或“未发现自动化失败”，除非已完成完整的正式无障碍审计。

报告格式 首先写一个简短的摘要：## 浏览器审计摘要 - 目标： - 视口：<桌面/移动/等> - 自动化检查：<运行的工具或不可用> - 手动检查：<已完成/部分/未完成> - 结论：<准备就绪/准备就绪并修复/被阻塞> 然后列出按优先级排序的发现：## 发现结果 ### <简短的问题标题> - 问题：<哪里失败以及为什么> - 严重性：<关键|高|中|低> - 优先级： - 证据：<选择器、截图说明、Lighthouse审计、控制台错误、键盘路径、视口> - 解释：<为什么它对WCAG/ARIA/SEO/Lighthouse/UX很重要> - 推荐：<具体修复> - 检查类型：<自动化|手动|混合> 如果没有发现问题，仍然包括：## 残余风险 - <未完成的手动检查、未覆盖的认证流、未测试的第三方小部件等> 严重性 严重：阻塞核心使用、购买/注册/联系、导航或法律/无障碍基线；严重的键盘陷阱；页面未被索引；严重的安全/浏览器最佳实践失败。 高：WCAG A/AA失败，影响常见使用；交互控件缺少无障碍名称；标题/表单破损；严重的SEO索引或元数据问题；可见控制台/运行时错误。 中：重要的UX或SEO降级；不明确的...