Визуальное тестирование с Playwright: полное руководство

Визуальное тестирование с Playwright: полное руководство

В пятницу вечером вы вливаете редизайн шапки сайта. В понедельник утром коллега сообщает, что кнопка входа сдвинулась на несколько пикселей на странице с ценами: на странице, которую вы даже не трогали. Ни один тест не поднял тревогу, потому что ни один тест не смотрел на внешний вид. Именно эту брешь закрывает визуальное тестирование.

Playwright от Microsoft с версии 1.22 включает встроенную функцию визуального тестирования: метод toHaveScreenshot(). Он позволяет делать скриншоты и автоматически сравнивать их с эталонными изображениями, без внешних плагинов. Это полностью бесплатное решение: о других бесплатных инструментах визуального тестирования читайте в нашем сравнении.

Это один из самых надёжных вариантов для команд, которые хотят добавить визуальные тесты в существующий набор. Чтобы разобраться в основах визуальной регрессии, прочтите наше полное руководство. Это руководство охватывает установку, настройку, лучшие практики и интеграцию с CI/CD, а затем то, что SDK Vision от Delta-QA меняет в этих же тестах.

Главное на одной странице: что no-code инструмент действительно автоматизирует и как он выглядит в сравнении: Автоматизация тестирования без кода.

toHaveScreenshot() всё ещё заставляет вас писать и поддерживать код? Delta-QA делает снимки и сравнивает ваши страницы, не требуя ни строки кода и банковской карты. Попробовать Delta-QA бесплатно →

Установка и первый тест

Настройка занимает немного времени, если у вас уже есть проект на Node.js:

npm install -D @playwright/test
npx playwright install

Затем создайте первый визуальный тест в tests/visual.spec.ts:

import { test, expect } from '@playwright/test';

test('homepage visual test', async ({ page }) => {
  await page.goto('https://your-site.com');
  await expect(page).toHaveScreenshot('homepage.png');
});

Первый запуск создаёт baseline (эталонное изображение). Последующие запуски сравнивают текущий снимок с этим baseline и сообщают о различиях.

# Первый раз: сгенерировать baseline
npx playwright test --update-snapshots

# Далее: сравнивать
npx playwright test

Начать так просто. Сложности появляются в реальных случаях.

Настройка допуска

По умолчанию Playwright сообщает о малейшем различии в один пиксель. На практике нужно настроить пороги допуска, чтобы избежать ложных срабатываний.

В playwright.config.ts:

import { defineConfig } from '@playwright/test';

export default defineConfig({
  expect: {
    toHaveScreenshot: {
      maxDiffPixelRatio: 0.01,  // допускается 1 % отличающихся пикселей
      animations: 'disabled',    // отключает CSS-анимации
      scale: 'device',           // учитывает экраны Retina
    },
  },
});

Можно также настраивать отдельно для каждого теста:

// Статичная страница: строгий порог
await expect(page).toHaveScreenshot('landing.png', {
  maxDiffPixelRatio: 0.001
});

// Дашборд с графиками: более мягкий порог
await expect(page).toHaveScreenshot('dashboard.png', {
  maxDiffPixelRatio: 0.05,
  mask: [page.locator('.chart')]
});

Порог - это компромисс: слишком низкий, и малейшее отклонение рендеринга роняет тест; слишком высокий, и отступ, изменившийся с 16px до 12px, проскользнёт незамеченным.

Работа с динамическим контентом

Динамический контент (даты, реклама, аватары, счётчики) - кошмар визуальных тестов. Playwright предлагает три решения:

Маскировать динамические зоны, самый распространённый метод:

await expect(page).toHaveScreenshot({
  mask: [
    page.locator('.ad-banner'),
    page.locator('.timestamp'),
    page.locator('.user-avatar')
  ]
});

Подменять контент, чтобы зафиксировать значения:

await page.evaluate(() => {
  document.querySelector('.date').textContent = '01/01/2026';
});
await expect(page).toHaveScreenshot();

Скрывать через CSS элементы, которые вообще не должны появляться:

await page.addStyleTag({
  content: '.dynamic-element { visibility: hidden !important; }'
});
await expect(page).toHaveScreenshot();

Каждое из этих решений поддерживается вручную: на странице появился новый динамический блок, значит, нужно добавить ещё один селектор.

Стабилизация тестов

Визуальный тест, который сегодня проходит, а завтра без причины падает, непригоден. Вот как обеспечить стабильность:

test('stable visual test', async ({ page }) => {
  await page.goto('https://your-site.com');

  // Дождаться, пока сеть успокоится
  await page.waitForLoadState('networkidle');

  // Дождаться загрузки шрифтов
  await page.evaluate(() => document.fonts.ready);

  // Дождаться критического элемента
  await page.waitForSelector('.hero-image', { state: 'visible' });

  await expect(page).toHaveScreenshot();
});

А чтобы отключить анимации вручную, когда глобальной опции недостаточно:

await page.addStyleTag({
  content: `
    *, *::before, *::after {
      animation-duration: 0s !important;
      transition-duration: 0s !important;
    }
  `
});

Тестирование в нескольких разрешениях

Playwright упрощает тестирование в нескольких разрешениях через проекты:

// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  projects: [
    {
      name: 'Desktop',
      use: { viewport: { width: 1920, height: 1080 } },
    },
    {
      name: 'Tablet',
      use: { viewport: { width: 768, height: 1024 } },
    },
    {
      name: 'Mobile',
      use: { ...devices['iPhone 13'] },
    },
  ],
});

Каждый проект генерирует собственные baseline. Поэтому один тест выполняется трижды, в трёх разрешениях, с тремя наборами снимков, которые нужно поддерживать в актуальном состоянии.

Интеграция с CI/CD

Интеграция в GitHub Actions проста. Полную конфигурацию смотрите в нашем руководстве по регрессионным тестам в GitHub Actions или, для GitLab, в руководстве по визуальному тестированию в GitLab CI.

name: Visual Tests
on: [push, pull_request]
jobs:
  visual-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx playwright test
      - uses: actions/upload-artifact@v4
        if: failure()
        with:
          name: playwright-report
          path: playwright-report/

Когда тест падает, Playwright создаёт три изображения: baseline (ожидаемое), текущий снимок и diff с различиями красным цветом. HTML-отчёт (npx playwright show-report) показывает их рядом.

Важный момент: отрисовка шрифтов различается от системы к системе. Baseline, созданные на Mac, не совпадут со снимками, сделанными на Linux-раннере CI. Генерируйте их в CI или в официальном Docker-образе Playwright.

toHaveScreenshot() всё ещё требует писать код? Delta-QA делает снимки и сравнивает ваши страницы без кода, без банковской карты. Попробовать Delta-QA бесплатно →

Ограничения подхода Playwright

Playwright отлично подходит командам, которые пишут свои тесты, но у toHaveScreenshot() есть ограничения, о которых нужно знать:

Обязательные навыки: нужно владеть TypeScript/JavaScript, селекторами и настройкой проекта. Тестировщики, не пишущие код, не могут ни создавать, ни поддерживать такие тесты.

Нет интерфейса ревью: нет общего пространства для оценки различий. Управление baseline происходит через терминал и файловую систему. В команде это быстро усложняется.

Сравнение пикселей: diff показывает красную область, а не то, что изменилось. Различия сглаживания между браузерами, вариации отрисовки шрифтов между ОС: всё это создаёт шум, с которым приходится справляться вручную масками и порогами.

Поддержка: каждое намеренное изменение интерфейса заставляет заново генерировать baseline (--update-snapshots). В проекте с 200 визуальными тестами и 3 браузерами это 600 baseline, которыми нужно управлять и которые хранятся в репозитории. Наше руководство по управлению baseline описывает стратегии их поддержки.

Оставить Playwright, сменить сравнение: SDK Vision

Если ваши тесты Playwright уже есть, вам не нужно отказываться от них, чтобы снять часть этих ограничений. SDK Vision от Delta-QA (@delta-qa/vision) добавляет проверку Delta-QA там, где тест должен посмотреть на страницу:

import { test } from "@delta-qa/vision/fixture";

test("Checkout", async ({ page, vision }) => {
  const checkout = await vision.open(page, { id: "checkout", name: "Checkout" });
  await page.goto("https://shop.example.com/checkout");
  await checkout.check("Payment");
}); // закрывается фикстурой: неоценённое различие роняет тест

SDK читает API-ключ из переменной DELTAQA_API_KEY. Без фикстуры open(page, { … }) из @delta-qa/vision открывает тот же тест, а close() закрывает его в afterEach.

Что меняется по сравнению с toHaveScreenshot():

  • Отчёт называет изменившийся элемент. Никакой красной области, которую нужно расшифровывать: отчёт сообщает, какой элемент изменился, например кнопка «Оплатить», из синей ставшая зелёной.
  • Эталоны больше не хранятся в репозитории. При первом запуске каждая проверка становится эталоном. Затем неоценённое различие роняет тест, а журнал CI содержит ссылку на отчёт. Там вы оцениваете каждое различие: «Намеренно» или «Баг».
  • Один эталон на ветку. Тест передаёт свою ветку и базовую ветку (branch, baseBranch): новая ветка с первого запуска сравнивается со своей базовой веткой, а «Намеренно» применяется только к веткам, которые вы отметите.
  • Остальной тест не меняется. Проекты из playwright.config.ts продолжают действовать: у каждого размера экрана свой эталон. Единственное условие — плотность экрана 1 (deviceScaleFactor: 1).

SDK охватывает Playwright на TypeScript и JavaScript, на Chromium. Сначала он предлагается в предварительном доступе: доступ запрашивается на его странице.

А для тех, кто не пишет тесты

Тесты Playwright остаются кодом. Чтобы тестировщики, product owner или дизайнеры тоже могли проверять внешний вид приложения, no-code решения вроде Delta-QA предлагают другой путь: вы записываете сценарий в браузере, Delta-QA воспроизводит его при каждой версии и сравнивает каждый шаг с эталоном. Эти сценарии и проверки SDK Vision оцениваются в одном пространстве Delta-QA, с одним и тем же отчётом.

Хотите тестировать без строки TypeScript и без единого baseline, который нужно перегенерировать? Сравните свои страницы с Delta-QA прямо сейчас, бесплатно и без банковской карты. Попробовать Delta-QA бесплатно →

FAQ

Playwright бесплатен для визуальных тестов?

Да, полностью. toHaveScreenshot() встроен в Playwright, который имеет открытый исходный код и поддерживается Microsoft. Ни лицензии, ни лимита скриншотов.

Сколько времени занимает настройка визуальных тестов Playwright?

Если вы уже владеете Playwright, рассчитывайте на несколько часов для настройки и написания первых тестов. Если вы начинаете с нуля (установка, изучение TypeScript, настройка CI), рассчитывайте на 2-3 дня.

Playwright или Cypress для визуальных тестов?

Преимущество Playwright в том, что визуальное тестирование встроено (toHaveScreenshot()), тогда как Cypress требует внешнего плагина. Playwright также поддерживает три браузерных движка (Chromium, Firefox, WebKit), а Cypress поддерживает браузеры Chromium и Firefox, WebKit остаётся экспериментальным. Подробности смотрите в нашем сравнении Playwright и Cypress или Playwright и Selenium, если вы выбираете между этими двумя фреймворками.

Можно ли использовать Playwright и Delta-QA вместе?

Да, и в одном и том же тесте. С SDK Vision вы добавляете vision.check() на шагах, где нужно проверить страницу: Playwright управляет браузером и вашими функциональными проверками, Delta-QA сравнивает страницу с эталоном. Сценарии, записанные командой QA без кода, оцениваются в том же пространстве.

Нужно ли удалять мои toHaveScreenshot(), чтобы использовать SDK Vision?

Нет. Оба подхода могут сосуществовать в одном наборе: можно добавить vision.check() на нескольких страницах, сравнить результаты, а затем решить для каждой страницы, что оставить.


Playwright даёт прочную основу для автоматизированных визуальных тестов. Для команд, пишущих тесты на TypeScript, toHaveScreenshot() - вероятно, лучший open source вариант, доступный в 2026 году, при условии грамотной настройки порогов и стабилизации тестов с самого начала. Когда попиксельный diff и baseline в репозитории становятся основной нагрузкой, SDK Vision сохраняет ваши тесты и меняет сравнение. Чтобы сопоставить Playwright с другими инструментами, смотрите наше сравнение инструментов регрессионного тестирования.