Документация Браузерное расширение — захват, моки, запись

Браузерное расширение — захват, моки и запись прямо в браузере

Расширение Mockarty превращает браузер, в котором вы и так отлаживаете, в
инструмент захвата трафика, прокси с моками и рекордер UI-тестов. Оно работает
без аккаунта: поставили, нажали запись — и всё лежит локально, пока вы сами
не отправите это в Mockarty.

Установка

  1. Возьмите расширение из папки extension/chrome репозитория Mockarty —
    она загружается как есть, сборка не нужна.
  2. Оставьте папку на месте и не удаляйте её — Chrome грузит расширение
    именно оттуда при каждом запуске.
  3. Откройте chrome://extensions, включите Режим разработчика, нажмите
    Загрузить распакованное и выберите папку.
  4. Закрепите иконку Mockarty на панели. Клик по ней открывает боковую панель.

Работает в Chrome, Edge, Brave и других браузерах на Chromium.

Захват трафика

Откройте панель и нажмите Старт. Каждый запрос страницы записывается с
методом, URL, статусом, таймингами, заголовками и телами — включая кадры
WebSocket в обе стороны.

  • Запись работает офлайн. Захваченное лежит в браузере, пока вы не отправите.
  • Секреты вырезаются прямо при записи — токены, куки, поля паролей и
    указанные JSON-пути не попадают в хранилище в открытом виде.
  • Остановка — кнопкой Стоп или с клавиатуры: Alt+Shift+C.

Любой захват превращается в:

  • коллекцию Postman, HAR-файл или команду cURL — без сервера;
  • моки в Mockarty — выберите запросы и нажмите Создать моки;
  • записанную сессию в Mockarty, если вы подключены.

Моки и подмена запросов

Раздел Правила перехватывает запросы до того, как они уйдут из браузера:

Правило Что делает
Мок Отвечает вашим ответом, без сервера
Блокировка Роняет запрос (проверить обработку ошибок)
Правка запроса Переписывает заголовки, query или тело на выходе
Правка ответа Переписывает то, что получает страница
Редирект Отправляет запрос в другое место
Хаос Добавляет задержку, ошибки, троттлинг, обрезанные тела
Брейкпоинт Ставит запрос на паузу — можно посмотреть и поправить

Правила матчатся по шаблону URL, методу и — для GraphQL — по имени операции.
В ответах работает шаблонизатор: {{faker.email}}, подстановка значений из
запроса, счётчики.

Заберите свои моки с сервера. Если команда уже собрала моки в Mockarty,
нажмите Забрать моки — они станут локальными правилами и начнут отвечать в
браузере сразу. Повторный запрос обновит эти правила, а не наплодит дубли.

Alt+Shift+R выключает и включает весь перехват — кнопка «верни страницу в
нормальное состояние».

Запись UI-теста

Нажмите Запись во вкладке Действия и работайте со страницей как обычно.
Клики, ввод и переходы записываются с устойчивыми селекторами (сначала роли и
доступные имена, сгенерированных id избегаем).

Правый клик по элементу во время записи добавляет проверку: виден, скрыт,
содержит текст, значение, атрибут, количество, URL.

Когда закончили:

  • Экспорт в код Playwright — готовый .spec.ts, запускается где угодно;
  • Отправить в Mockarty — станет UI-тестом, который можно ставить по
    расписанию, гонять на флоте устройств и привязать к тест-кейсу.

Аудит страницы

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

Подключение к Mockarty

Всё описанное выше работает автономно. Подключение добавляет: отправку захватов
и тестов в проект, выгрузку моков, просмотр прогонов и уведомлений, а также
использование браузера как раннера UI-тестов для команды (см.
Запуск UI-тестов в своём браузере).

Три способа подключиться:

  1. Использовать мою сессию Mockarty — если вы уже вошли в Mockarty в этом
    браузере, один клик обменяет сессию на ограниченный токен.
  2. Страница сопряжения — откройте Mockarty → Подключить расширение и
    подтвердите.
  3. Токен вручную — вставьте API-токен и адрес сервера.

Если запрос вернул 403 — токен исправен, но у аккаунта нет места или прав на
эту возможность; попросите администратора. Перепейринг тут не поможет, и
расширение так и скажет, а не отправит вас по кругу.

Сочетания клавиш

Сочетание Действие
Alt+Shift+M Открыть панель Mockarty
Alt+Shift+C Старт / стоп захвата
Alt+Shift+R Выключить / включить все правила перехвата

Переназначить можно в chrome://extensions/shortcuts.

Приватность и хранилище

  • Захваты, правила и записи лежат в локальном хранилище браузера; ничего не
    уходит с машины, пока вы не отправите.
  • Секреты вырезаются в момент записи.
  • Когда хранилище браузера заполняется, самые старые захваты отбрасываются, и
    панель об этом сообщает — запись при этом продолжается.
  • Отключиться очищает токен, но сохраняет локальные захваты.

Смотрите также