Не принимайте новый baseline, если вокруг каждой буквы появился равномерный шум или весь абзац внезапно стал шире. Сначала откройте один упавший тест, найдите текстовый элемент и зафиксируйте три факта: какое значение вернул getComputedStyle, ответил ли запрос WOFF2 кодом 200 и считает ли браузер нужный шрифт загруженным. Такой diff чаще говорит о fallback-шрифте или другом растеризаторе, а не об изменении интерфейса.

Playwright предупреждает, что снимки различаются из-за ОС, версии браузера, настроек, оборудования, режима headless и даже состояния питания. Поэтому эталон имеет смысл только внутри воспроизводимого окружения. Фраза «на моём ноутбуке совпадает» не опровергает CI: ноутбук и контейнер могут строить одни и те же CSS-правила разными системными библиотеками.

Форма расхождения быстро сужает круг причин

Что видно на diffЧто вероятнее всего произошлоПервая проверка
Сдвинулись переносы во всём абзацеПодставился fallback с другой шириной глифовComputed font и font request
Контуры букв отличаются на один пиксельДругая ОС или rasterizerОбраз CI и платформа baseline
Появились квадраты вместо символовВ файле нет нужного glyph rangeunicode-range и фактический текст
Только первая загрузка нестабильнаСнимок сделан до готовности fontsdocument.fonts.status и ready
Отличаются emojiИспользован системный цветной шрифтОС и набор emoji fonts
Шрифт 404 только в CIНеверный base URL или регистр путиNetwork log и response headers

Проверяйте не только имя семейства. CSS может вернуть ожидаемый font-family, но браузер возьмёт следующий шрифт из списка, если файл недоступен или в нём нет конкретного символа. Полезно сравнить ширину контрольной строки через canvas или bounding box: это превращает подозрение в измеряемый сигнал.

Снимок делается после явного барьера загрузки

await page.goto(url, { waitUntil: 'networkidle' });
await page.evaluate(() => document.fonts.ready);

const fontState = await page.evaluate(() => ({
  status: document.fonts.status,
  interLoaded: document.fonts.check('16px Inter'),
  width: document.querySelector('[data-test=card]').getBoundingClientRect().width
}));
expect(fontState.interLoaded).toBe(true);
await expect(page).toHaveScreenshot('card.png', { maxDiffPixels: 40 });

networkidle сам по себе не гарантирует, что CSS Font Loading API завершил обработку. document.fonts.ready даёт отдельный барьер, а document.fonts.check помогает упасть с понятным сообщением ещё до сравнения пикселей. Если приложение подгружает начертание после действия пользователя, барьер ставят после этого действия, а не только после page.goto.

Baseline должен иметь адрес и владельца

  • Генерируйте эталоны в том же контейнере или runner image, где идёт проверка, и закрепляйте версию Playwright и браузера.
  • Храните лицензированные WOFF2 в контролируемом источнике либо используйте версионированный CDN URL с проверяемой целостностью.
  • Не смешивайте эталоны Chromium на Linux и WebKit на macOS: Playwright включает браузер и платформу в путь snapshot не случайно.
  • Отключайте анимацию и маскируйте только действительно динамические области; текстовый diff не лечится маской всего компонента.
  • Назначьте review изменениям snapshots: автор объясняет, почему изменились метрики, а ревьюер видит ожидаемый макет рядом с diff.

Параметр stylePath удобен для часов, caret и рекламных виджетов, но он не должен переписывать типографику тестируемого продукта. Иначе тест подтверждает специально подготовленную картинку, а не страницу пользователя. По той же причине слишком большой maxDiffPixels опасен: реальная смена font-weight растворится в разрешённом шуме.

Минимальный эксперимент отделяет файл от рендерера

  1. Запустите один тест в CI дважды без изменений: нестабильный результат указывает на момент загрузки или динамику.
  2. Сохраните HAR или список font-ответов и убедитесь, что content-type, CORS и cache headers ожидаемы.
  3. Выведите document.fonts.status, check для конкретного family и computed font-weight проблемного узла.
  4. Сгенерируйте baseline в том же image и повторите сравнение; исчезновение diff подтверждает расхождение окружений.
  5. Затем намеренно поменяйте размер шрифта на один пиксель и убедитесь, что тест действительно краснеет.

Последний шаг нужен против ложной стабильности. После исправления окружения тест должен ловить контролируемую регрессию, иначе допуск, маска или CSS для тестов уже скрыли полезный сигнал. Готовый результат выглядит скучно: одинаковый image digest, одинаковые browser binaries, успешная проверка font-файла и снимок после явного барьера.

Проверенные источники