Не принимайте новый baseline, если вокруг каждой буквы появился равномерный шум или весь абзац внезапно стал шире. Сначала откройте один упавший тест, найдите текстовый элемент и зафиксируйте три факта: какое значение вернул getComputedStyle, ответил ли запрос WOFF2 кодом 200 и считает ли браузер нужный шрифт загруженным. Такой diff чаще говорит о fallback-шрифте или другом растеризаторе, а не об изменении интерфейса.
Playwright предупреждает, что снимки различаются из-за ОС, версии браузера, настроек, оборудования, режима headless и даже состояния питания. Поэтому эталон имеет смысл только внутри воспроизводимого окружения. Фраза «на моём ноутбуке совпадает» не опровергает CI: ноутбук и контейнер могут строить одни и те же CSS-правила разными системными библиотеками.
Форма расхождения быстро сужает круг причин
| Что видно на diff | Что вероятнее всего произошло | Первая проверка |
|---|---|---|
| Сдвинулись переносы во всём абзаце | Подставился fallback с другой шириной глифов | Computed font и font request |
| Контуры букв отличаются на один пиксель | Другая ОС или rasterizer | Образ CI и платформа baseline |
| Появились квадраты вместо символов | В файле нет нужного glyph range | unicode-range и фактический текст |
| Только первая загрузка нестабильна | Снимок сделан до готовности fonts | document.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 растворится в разрешённом шуме.
Минимальный эксперимент отделяет файл от рендерера
- Запустите один тест в CI дважды без изменений: нестабильный результат указывает на момент загрузки или динамику.
- Сохраните HAR или список font-ответов и убедитесь, что content-type, CORS и cache headers ожидаемы.
- Выведите document.fonts.status, check для конкретного family и computed font-weight проблемного узла.
- Сгенерируйте baseline в том же image и повторите сравнение; исчезновение diff подтверждает расхождение окружений.
- Затем намеренно поменяйте размер шрифта на один пиксель и убедитесь, что тест действительно краснеет.
Последний шаг нужен против ложной стабильности. После исправления окружения тест должен ловить контролируемую регрессию, иначе допуск, маска или CSS для тестов уже скрыли полезный сигнал. Готовый результат выглядит скучно: одинаковый image digest, одинаковые browser binaries, успешная проверка font-файла и снимок после явного барьера.