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