Знакомо чувство, когда CI-пайплайн падает не потому, что вы сломали код, а потому что внешний сервис лег или вернул HTML вместо JSON? Это классическая проблема хрупких интеграций. Вы тратите часы на отладку, проверяя логи, но корень зла часто лежит в нестабильности внешних зависимостей. Решением здесь становятся моки на уровне сети - инструменты, которые перехватывают HTTP-запросы до того, как они уйдут в интернет.
Два лидера в этой нише сегодня - это MSW (Mock Service Worker) для фронтенда и WireMock для бэкенда и кросс-языковых экосистем. Они решают одну задачу по-разному, но цель у них общая: сделать ваши тесты детерминированными, быстрыми и независимыми от состояния внешнего мира. Давайте разберемся, когда стоит использовать один, а когда другой, и как это спасет вашу нервную систему.
Почему обычные моки не работают
Классические юнит-тесты с моками библиотек вроде `jest.mock` или `sinon` хороши для изоляции бизнес-логики. Но они имеют фундаментальный недостаток: они не видят сеть. Если ваш код использует `fetch`, `axios` или нативный `XMLHttpRequest`, мок уровня библиотеки может промахнуться. Он подменяет объект, но не эмулирует реальный сетевой стек.
В результате вы получаете ложноположительные результаты. Тест проходит, потому что библиотека-мок корректно обработала вызов, но в продакшене запрос падает из-за CORS, таймаута или неверного заголовка. Моки на уровне сети работают иначе. Они встают между вашим приложением и реальным сервером, перехватывая трафик на протокольном уровне. Для приложения нет разницы, отвечает ли ему реальный Stripe или фейковый ответ, сконфигурированный в WireMock. Это дает уровень уверенности, который недоступен при обычном стаббинге функций.
MSW: Нативная скорость для фронтенда
MSW - это библиотека для Node.js и браузера, которая позволяет создавать mock-серверы без изменения кода приложения. Она работает через два механизма: в браузере используется Service Workers, а в Node.js - переопределение глобальных объектов `http` и `https`. Это значит, что вам не нужно внедрять зависимости от MSW в сам код компонентов React или Vue. Вы просто конфигурируете обработчики в файле тестов или в режиме разработки.
| Характеристика | MSW (Mock Service Worker) | WireMock |
|---|---|---|
| Основная платформа | JavaScript/TypeScript (Browser & Node) | Java (standalone), Docker, CLI |
| Тип перехвата | Service Workers / Monkey-patching | HTTP Proxy / Standalone Server |
| Настройка | JS/TS код (декларативно) | JSON конфиги или Java API |
| Идеальный кейс | Frontend-тесты, Storybook, локальная разработка | Интеграционные тесты бэкенда, микросервисы, QA |
| Сложность развертывания | Низкая (npm install) | Средняя (нужен JRE или Docker) |
Главная сила MSW в его прозрачности. Поскольку он использует стандартные веб-API, поведение запросов максимально приближено к реальному браузерному окружению. Вы можете эмулировать задержки сети (`delay()`), ошибки соединения (`networkError()`) и даже частичные ответы. Для фронтенд-разработчика это бесценно. Представьте, что вы тестируете форму оплаты. С MSW вы можете сказать: «При запросе к `/api/payment` верни ошибку 503 после 2 секунд». Ваш компонент покажет спиннер, а затем сообщение об ошибке, точно так же, как это будет происходить в жизни.
Еще один плюс - поддержка GraphQL из коробки. MSW понимает структуру запросов и может мокать резолверы, а не просто отдавать сырой JSON. Это критично для современных приложений, где данные приходят сложными структурами.
WireMock: Тяжелая артиллерия для бэкенда
Если MSW - это скальпель хирурга, то WireMock - это швейцарский нож солдата. Это полноценный HTTP-сервер, написанный на Java, который умеет делать все, что угодно с входящими запросами. WireMock не привязан к языку программирования вашего приложения. Он слушает порт, принимает запросы и возвращает ответы согласно правилам, описанным в JSON-конфигурации или заданным через Java DSL.
Почему бэкендеры любят WireMock? Потому что он поддерживает stateful behavior (поведение с состоянием). Допустим, у вас есть процесс оформления заказа:
- POST `/orders` создает заказ со статусом `pending`.
- GET `/orders/{id}` должен вернуть `pending`.
- POST `/orders/{id}/cancel` меняет статус на `cancelled`.
- GET `/orders/{id}` теперь должен вернуть `cancelled`.
С WireMock вы можете настроить цепочку ответов. Первый запрос сохранит данные во внутреннее состояние, второй их прочитает, третий изменит. Это позволяет тестировать сложные бизнес-процессы без поднятия реальной базы данных. Кроме того, WireMock умеет записывать трафик. Вы можете запустить приложение против реального API, включить запись, а затем использовать эти записи как моки для оффлайн-разработки. Это функция «record and replay» экономит часы на ручное описание контрактов.
Как выбрать инструмент под задачу
Выбор между MSW и WireMock редко бывает вопросом «что лучше». Это вопрос контекста.
Используйте MSW, если:
- Вы пишете тесты для React, Angular, Vue или Svelte.
- Вам нужно быстро поднять мок-сервер внутри Jest/Vitest без внешних процессов.
- Команда фронтенда хочет иметь возможность локально работать без доступа к бэкенду (режим development).
- Проект полностью на JavaScript/TypeScript.
Используйте WireMock, если:
- Бэкенд написан на Java, Kotlin, C# или другом языке, отличном от JS.
- Нужны сложные интеграционные тесты, где важно состояние системы.
- QA-инженеры хотят писать сценарии на понятном им языке (или использовать UI) независимо от кода разработчиков.
- Требуется эмуляция задержек, ретраев и специфических HTTP-кодов на уровне инфраструктуры.
Часто эти инструменты используются вместе. Фронтенд-команда использует MSW для своих юнит и компонентных тестов, а бэкенд-команда поднимает WireMock в Docker-контейнере для контрактных тестов и проверки взаимодействия микросервисов.
Практические советы по внедрению
Не пытайтесь мокать всё сразу. Начните с самых нестабильных внешних зависимостей. Обычно это платежные шлюзы (Stripe, PayPal), сервисы геолокации или сторонние API аналитики.
Для MSW создайте файл `handlers.ts`, где будут описаны все правила. Импортируйте его в настройку тестового окружения. Не забудьте добавить `msw/node` в зависимости для dev-окружения. Важно правильно обрабатывать случай, когда запрос не найден среди моков. По умолчанию MSW пробрасывает запрос дальше, но в тестах лучше выбрасывать ошибку, чтобы поймать непредвиденные вызовы.
С WireMock начните с запуска standalone jar-файла: `java -jar wiremock-standalone.jar`. Он поднимется на порту 8080. Создайте папку `mappings` и положите туда JSON-описания ответов. Структура проста: указываем URL, метод и ожидаемый ответ. Для сложных сценариев используйте шаблонизатор Handlebars в ответах, чтобы динамически менять ID заказов или токены сессий.
Можно ли использовать MSW для тестирования бэкенда на Node.js?
Да, можно. MSW имеет пакет `msw/node`, который перехватывает запросы, сделанные через модули `http`, `https` и `net`. Однако для сложных интеграционных сценариев с множеством микросервисов WireMock часто удобнее, так как он работает как отдельный процесс и не зависит от внутреннего состояния Node.js процесса, что снижает риск побочных эффектов.
Как WireMock справляется с HTTPS?
WireMock может работать как HTTPS-сервер, если предоставить SSL-сертификаты. Также он может выступать в роли MITM-прокси (Man-in-the-Middle), перехватывая HTTPS-трафик, если клиент настроен на использование этого прокси и доверяет самоподписанному сертификату WireMock. Это полезно для эмуляции внешних защищенных API.
Что тяжелее в поддержке: JSON-конфиги WireMock или код MSW?
Это зависит от команды. Разработчикам TypeScript проще поддерживать код MSW, так как там есть автодополнение, типизация и рефакторинг. JSON-конфиги WireMock более громоздки, но они не требуют знаний языка программирования, что делает их доступными для QA-инженеров и продуктовых менеджеров, которые могут сами править сценарии тестов.
Заменят ли моки реальные интеграционные тесты?
Нет. Моки на уровне сети заменяют только внешние зависимости. Реальные интеграционные тесты (E2E) с использованием живых сервисов или песочниц (sandbox environments) необходимы хотя бы в минимальном объеме, чтобы проверить корректность самих моков и общую связность системы. Используйте пирамиду тестов: много моков, мало реальных E2E.
Есть ли альтернативы этим инструментам?
Да, существуют другие решения. Например, Prism от Stoplight для контрактного тестирования OpenAPI, Mountebank для мультипротокольного мокинга или встроенные средства фреймворков вроде Spring Cloud Contract для Java. Однако MSW и WireMock остаются наиболее популярными благодаря зрелости экосистемы и большому сообществу.