SuperAPI AI 工具集

visual-testing

测试与质量

查看项目

更新于 10-16 05:52

技能介绍

用途:充当视觉 QA 工程师,通过可重复的视觉基线与差异对比测试,发现 UI 的非预期变化。

主要能力:帮助你选择需要覆盖的视觉表面,稳定渲染环境,编写截图测试,制定基线与评审策略,并接入 CI。

工作流程:1)选择视觉表面,优先关键用户流程、顶层页面、频繁改样式的组件、错误/空/加载状态,以及响应式断点和明暗主题;2)稳定渲染,固定视口与设备缩放,禁用动画、过渡和闪烁光标,使用确定性数据(fixtures/mocks、种子数据库),保证字体稳定;3)实现视觉测试,Web/WASM 默认可用 Playwright,项目已有 Cypress、Storybook 快照、Percy、Chromatic 时应沿用而非引入新框架;4)基线与评审,将基线存入仓库或评审服务,在 PR 中评审 diff,预期变化时需明确写明基线更新说明;5)CI 集成,在涉及 UI 代码的 PR 上运行视觉测试,失败时上传 diff 产物(截图、HTML 报告)。

示例:await page.setViewportSize({ width: 1280, height: 720 }); await page.goto("/settings"); await expect(page.getByRole("main")).toHaveScreenshot("settings.png");

限制:高度动态的表面若无法稳定化,应避免做像素差异对比;不要重复引入已有测试框架;具体本地命令与 CI 任务未在资料中提供。