На главную

DF-ВЕБ-044 · Контент и сайты

«Не воспроизводится»: проверка интерфейса с моками без ложного зелёного

Редакция Deskforge · 20 ноября 2026 · 5 мин чтения
«Не воспроизводится»: проверка интерфейса с моками без ложного зелёного
Из статьи вы узнаете
  • Чем проверка на моках отличается от проверки на реальном бэкенде
  • Где HAR-воспроизведение молча не срабатывает на POST-запросах
  • Почему WebSocket и service worker требуют отдельной проверки
  • Чек-лист решений: что подменять и как убедиться, что сбой не скрыт

Тест зелёный, интерфейс отрисовал список, кнопка нажалась. А на проде пользователь видит пустой экран. Знакомая развилка: прогон прошёл, но прошёл он на подставленных данных, и что именно он доказал — ещё вопрос.

Подмена сети — рабочий инструмент. Playwright позволяет перехватывать и подменять HTTP- и HTTPS-запросы страницы, включая XHR и fetch. Но инструмент отвечает только за то, что вы ему поручили. Если мок вернул красивый ответ, тест проверит отрисовку этого ответа, а не то, что реальный бэкенд такой ответ вообще отдаёт.

Ниже — порядок решений: какие ответы подменять, что оставлять на реальном бэкенде и где подмена молча не срабатывает. Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему стеку и вашим правилам. Смежная тема — сценарные проверки сайта вместо одной страницы, а работы по сайтам и кабинетам собраны на странице контента и сайтов.

Почему зелёный прогон на моках не доказывает работу сценария

Когда вы подменяете ответ через page.route с fulfill, запрос к API не выполняется вовсе. Тест переходит на адрес, который использует подменённый маршрут, и проверяет, что подставленные данные появились на странице. Это ровно то поведение, которое описано в документации Playwright, и оно полезно: вы проверяете интерфейс без зависимости от сети.

Проблема в том, что такой тест не касается бэкенда. Он не узнает, что поле переименовали, что код ответа изменился с 200 на 422, что обязательный параметр теперь другой. Интерфейс на моке останется зелёным, а реальный запрос будет падать.

Поэтому первый вопрос к любому зелёному прогону: что в этом тесте было настоящим? Если ответ подставлен целиком, тест доказывает работу отрисовки, и только её. Это не мало, но это не проверка сценария целиком.

Что подменять моками, а что оставлять на реальном бэкенде

Разделяйте два случая. Первый: ответ нужен только для того, чтобы интерфейс перешёл в нужное состояние — показал ошибку, пустой список, длинный текст. Здесь подмена уместна, и запрос к API можно не отправлять.

Второй: нужно проверить обработку реального ответа с изменённым полем. Тогда запрос выполняют по-настоящему, а возвращают изменённый ответ. В Playwright это делают, выполнив запрос и подменив ответ на модифицированный — документация прямо описывает такой приём для воспроизводимого тестирования.

Разница практическая. В первом случае вы проверяете, что интерфейс умеет показать состояние. Во втором — что он правильно читает настоящую структуру ответа, в которой поменяли одно поле. Второй тест ближе к реальности и ловит расхождения в именах полей и типах.

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

HAR и строгое сопоставление запросов: где мок молча не сработает

HAR-файл хранит записи сетевых запросов страницы: заголовки, cookies, содержимое, тайминги. Воспроизведение из HAR удобно, когда нужно повторить сценарий без живого сервера. Но у него есть строгое правило, о котором легко забыть.

При воспроизведении из HAR Playwright строго сопоставляет URL и HTTP-метод, а для POST-запросов — ещё и тело запроса. То есть если сценарий отправляет POST с телом, а в записи тело отличается хотя бы одним полем, совпадения не будет. Запрос уйдёт мимо записи.

Что происходит дальше — зависит от настройки. Если запись не нашлась, а сеть доступна, запрос может уйти на реальный сервер, и тест пройдёт по другой ветке, чем вы думали. Если сети нет — сценарий упадёт или зависнет. В обоих случаях зелёный результат на HAR не означает, что сработала именно запись.

Практический вывод: для сценариев с POST проверяйте, что запись действительно совпала. Смотрите, ушёл ли запрос в сеть, и сверяйте метод и тело с тем, что записано в HAR.

WebSocket и service worker как источники подмены вне обычных HTTP-запросов

Не весь трафик идёт через HTTP-запросы. Если интерфейс обновляется по WebSocket, подмена обычных запросов его не покроет. Playwright умеет перехватывать WebSocket-соединения и подменять всю коммуникацию по WebSocket вместо подключения к серверу — это отдельный механизм, и проверять его нужно отдельно.

Второй источник — service worker. По описанию MDN он работает как прокси между веб-приложением, браузером и сетью и может перехватывать сетевые запросы. Отвечать на запросы он может через FetchEvent, изменяя ответ произвольным образом с помощью FetchEvent.respondWith().

Это значит, что подмена может жить не в тесте, а в самом приложении. Если в проекте есть service worker, который отдаёт закешированные ответы, тест может получать данные из кеша и не ходить в сеть — и вы будете думать, что проверили запрос. Проверяйте, не перехватывает ли service worker тот запрос, который вы считаете настоящим.

Ограничения окружения: защищённый контекст и жизненный цикл service worker

Service workers доступны только в защищённых контекстах: документ должен отдаваться по HTTPS, при этом http://localhost браузеры тоже считают защищённым контекстом для удобства локальной разработки. Если тест открывает страницу по обычному http на не-localhost адресе, service worker просто не зарегистрируется, и подмена через него не сработает.

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

И третье: service worker не имеет доступа к DOM и выполняется в отдельном потоке от основного JavaScript приложения. Поэтому проверять через него отрисовку нельзя — он влияет на сеть, а не на разметку. Эти ограничения стоит держать в голове, когда зелёный прогон ведёт себя необъяснимо.

Чек-лист решений: какие ответы подменять и как убедиться, что сбой не скрыт

Соберём решения в короткий список. Он не заменяет вашу стратегию тестирования, но помогает не перепутать проверку отрисовки с проверкой сценария.

  • Ответ API нужен только для отрисовки состояния интерфейса? Подмените ответ моком и проверьте, что запрос к API не уходит.
  • Нужно проверить обработку реального ответа с изменённым полем? Выполните запрос и верните изменённый ответ.
  • Сценарий зависит от метода и тела POST-запроса? Сверьте, что запись в HAR совпадает по URL, методу и телу.
  • Сценарий идёт по WebSocket? Отдельно проверьте подмену WebSocket, а не только HTTP-запросов.
  • Подмена сделана через service worker? Убедитесь, что страница открыта в защищённом контексте.
  • Обновилась версия service worker? Проверьте, что старая версия не удерживается открытыми страницами.

Главное правило: перед тем как поверить зелёному прогону, ответьте, что в нём было настоящим. Если всё подставлено — вы проверили интерфейс. Если запрос ушёл и вернулся изменённый ответ — вы ближе к сценарию. Если запрос должен был уйти, но не ушёл, — проверьте, не перехватил ли его service worker или не совпала ли запись HAR.

Источники

Назад