Визуальное регрессионное тестирование
На этой странице
Визуальные тесты сравнивают скриншот компонента или страницы с эталоном (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.