SuperAPI AI 工具集

common-web-visual-testing

测试与质量

查看项目

更新于 10-15 22:13

技能介绍

用途:为 Web 应用提供标准化的视觉审计、响应式设计与行为测试方法,用于验证 UI 修复效果或跨浏览器行为。属于 P1(高优先级)方法论层技能,涉及响应式、无障碍(WCAG)与浏览器引擎差异等领域。后端 API 测试不在其范围内。

主要能力:以“对比审计”循环为核心——先采集基线(Before)快照(--aria 与截图,prod/main),再采集实现后(After)快照(本地/特性分支),然后对比状态,检查回归、CLS(布局偏移)与 Aria 漂移。回复需标注两次采集为 Before/After(或 Baseline/Fixed),并包含差异与相邻元素副作用检查。

场景矩阵:CSS/布局对应响应式审计、悬停与 CLS 检查;表单/输入对应校验消息、焦点状态与错误边界;导航对应 URL 同步、粘性头部与后退按钮保持;资源/字体对应懒加载、图标检查与 LCP 审计;无障碍对应 Tab 顺序、Aria 快照与颜色对比度。

使用方式:使用 playwright-cli 的 snapshot --aria 在完成前验证状态;动态内容(时间戳、余额)必须通过 --mask 或 JS(opacity: 0)遮蔽,避免误报回归;第三方依赖(聊天、分析)需 mock 或绕过以防不稳定。

限制与反模式:不要只验证桌面端,需检查移动端(375px)与平板(768px);不要忽略布局偏移,需检查加载态(骨架屏)无页面跳动;避免未遮蔽动态内容导致的“假回归”;避免盲目断言;避免依赖外部服务。相关参考包括 playwright-cli、diagnostic-decoder、dom-snapshot-vs-screenshot、login-and-test-data 与 scenarios。