re:re:actable
Урок 064 минуты чтения

Визуальное регрессионное тестирование

На этой странице
Кратко

Визуальные тесты сравнивают скриншот компонента или страницы с эталоном (baseline) попиксельно и падают, если внешний вид изменился сильнее порога. Они ловят то, что не видят функциональные тесты: съехавшую вёрстку, сломанные стили после обновления CSS-библиотеки, обрезанный текст, неправильную тему, наложение элементов. Инструменты: Playwright toHaveScreenshot() (встроено, эталоны в репозитории), Vitest Browser Mode toMatchScreenshot() для компонентов, облачные сервисы Chromatic (для Storybook), Percy, Argos, Lost Pixel — с удобным ревью изменений в PR. Главная сложность — стабильность: шрифты, антиалиасинг и рендеринг различаются между ОС, поэтому эталоны снимают в том же окружении, что и CI (Docker-образ Playwright), отключают анимации, фиксируют данные и время, маскируют динамические области (даты, аватары, реклама). Визуальные тесты особенно ценны для дизайн-систем (каждый компонент во всех вариантах и темах) и ключевых страниц.

Вопрос

Что такое визуальное регрессионное тестирование, как его настроить в Playwright и как бороться с ложными срабатываниями?

Playwright toHaveScreenshot

test("карточка товара выглядит как в макете", async ({ page }) => {
  await page.goto("/product/aqua-kettle");
  await expect(page.getByRole("article", { name: "Электрический чайник Aqua" })).toHaveScreenshot("product-card.png");
});
 
test("главная страница", async ({ page }) => {
  await page.goto("/");
  await expect(page).toHaveScreenshot("home.png", {
    fullPage: true,
    mask: [page.getByTestId("promo-timer"), page.getByRole("img", { name: /аватар/i })], // динамика
    maxDiffPixelRatio: 0.01,                     // допуск 1% пикселей
  });
});
pnpm exec playwright test --update-snapshots     # создать/обновить эталоны (осознанно!)

Первый запуск создаёт эталон в *.spec.ts-snapshots/, последующие сравнивают. При падении отчёт показывает expected / actual / diff.

Стабильность снимков

Источник шумаРешение
Разные ОС и шрифтыСнимать и сравнивать в Docker-образе mcr.microsoft.com/playwright (локально и в CI одинаково)
Анимации, мигающий курсорanimations: "disabled", caret: "hide" (по умолчанию в toHaveScreenshot)
Даты, таймеры, случайные данныеpage.clock.setFixedTime, фикстуры данных, mask
Ленивые изображения и шрифтыДождаться загрузки (await page.waitForLoadState("networkidle") осторожно; лучше ждать конкретный элемент)
Внешние виджеты, рекламаБлокировать через page.route
Скроллбары, ховерыФиксированный viewport, курсор вне элементов
Мелкий антиалиасингthreshold, maxDiffPixels
// playwright.config.ts
expect: {
  toHaveScreenshot: { maxDiffPixelRatio: 0.005, animations: "disabled" },
},
use: { viewport: { width: 1280, height: 800 }, deviceScaleFactor: 1, colorScheme: "light", locale: "ru-RU" },

Отдельный стиль для тестов, скрывающий нестабильные части:

await expect(page).toHaveScreenshot({ stylePath: "e2e/screenshot.css" });
// screenshot.css: .live-chat, .ad-slot { visibility: hidden !important; }

Компоненты: Storybook + Chromatic

Storybook-истории (все варианты Button × размер × тема × состояние)
        │ push в PR
        ▼
Chromatic снимает каждую историю в облаке (несколько браузеров и вьюпортов)
        │
        ▼
PR-проверка «UI Tests: 3 changes» → дизайнер/разработчик принимает или отклоняет изменения
Эталоны в репозитории (Playwright)Облачный сервис (Chromatic, Percy, Argos)
СтоимостьБесплатноПлатно по числу снимков (есть бесплатные лимиты)
Ревью измененийДифф в отчёте, PNG в PRУдобный веб-интерфейс, согласование в PR
СтабильностьНужен Docker для одинакового рендераОкружение сервиса
Объём репозиторияРастёт из-за PNG (можно Git LFS)Не растёт
Лучше дляНебольшого числа ключевых страницДизайн-систем с сотнями компонентов

Что снимать

  • Компоненты дизайн-системы во всех вариантах, темах (light/dark), размерах и состояниях (hover, focus, disabled, error).
  • Ключевые страницы на мобильном и десктопе.
  • Сложную вёрстку: таблицы, графики, email-шаблоны, PDF/печать.
  • RTL и длинные переводы.

Не снимай всё подряд: каждая визуальная проверка — это эталон, который нужно поддерживать.

Процесс обновления эталонов

1. Изменили дизайн кнопки намеренно
2. CI падает: diff в 40 снимках
3. Разработчик просматривает diff (не обновляет вслепую!)
4. pnpm exec playwright test --update-snapshots (в Docker) → коммит новых эталонов
5. Ревьюер видит изменения PNG в PR (GitHub показывает diff изображений)

Визуальные тесты и доступность

Скриншот не проверяет доступность: визуально правильная кнопка может не иметь доступного имени. Сочетай визуальные тесты с toMatchAriaSnapshot и axe.

Что важно помнить

  • Визуальные тесты ловят регрессии вёрстки и стилей, которые не видят функциональные.
  • Эталоны снимаются в том же окружении, что и CI (Docker-образ Playwright).
  • Анимации выключены, время и данные фиксированы, динамика замаскирована.
  • Для дизайн-систем удобны Storybook + Chromatic/аналоги.
  • Обновляй эталоны только после просмотра диффа.

Мини-шпаргалка

  • await expect(page | locator).toHaveScreenshot("name.png", { mask, fullPage, maxDiffPixelRatio }).
  • --update-snapshots (в Docker).
  • page.clock.setFixedTime, stylePath, animations: "disabled".
  • Компоненты: Storybook → Chromatic / Vitest toMatchScreenshot.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам