Skip to content

视觉回归测试

一句话解释

视觉回归测试截取 UI 截图并与基线比较——自动捕获意外视觉变更。

用大白话说

视觉回归测试捕获功能测试遗漏的视觉 bug。它截取 UI 截图并逐像素与基线(已知正确)截图比较。视觉回归捕获什么:

  • CSS 变更导致的布局偏移
  • 主题更新导致的颜色变更
  • 缺失或错位的元素
  • 不同视口尺寸下的响应式布局破坏
  • 字体渲染差异
  • 溢出或裁剪问题工作原理:1. 基线——截取当前(正确)UI 的截图
  1. 变更后——截取新截图
  2. 比较——逐像素差异,高亮不同
  3. 审查——人工审查差异(有些变更是有意的)
  4. 更新基线——如果变更有意,更新基线挑战:
  • 假阳性——抗锯齿、字体、跨浏览器渲染差异
  • 动态内容——日期、广告、随机数据导致假差异(mock 它们)
  • 维护——UI 有意变更时基线需更新工具:Percy、Chromatic、Applitools、Storybook + playwright、reg-suit。

示例

javascript
// Playwright visual regression test
import { test, expect } from '@playwright/test';

test('homepage looks correct', async ({ page }) => {
  await page.goto('https://example.com');
  await expect(page).toHaveScreenshot('homepage.png', {
    maxDiffPixelRatio: 0.01, // allow 1% pixel difference
    threshold: 0.2,          // per-pixel tolerance
  });
});

test('product card renders correctly', async ({ page }) => {
  await page.goto('https://example.com/product/1');
  const card = page.locator('.product-card');
  await expect(card).toHaveScreenshot('product-card.png');
});

// First run: creates baseline screenshots
// Subsequent runs: compares to baseline
// If diff > threshold: test FAILS with visual diff shown
// To update baseline: npx playwright test --update-snapshots

Playwright 截图并与基线比较。如果像素差异超阈值,测试失败显示视觉差异。变更有意时用 --update-snapshots 更新基线。

常见混淆

  • 容易混淆的对象: snapshot testing

    关键区别: 快照测试(Jest)将组件输出序列化为文本/JSON 字符串并比较——检查结构/属性,不是像素。视觉回归测试比较实际渲染截图逐像素——检查用户看到什么。快照测试快但遗漏视觉问题(CSS、布局);视觉测试慢但捕获真实视觉 bug。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表