Перейти к содержимому

Баг-репорты для разработчиков: те улики, которые вы собрали бы сами

Обновлено

Баг-репорт для разработчика работает лучше всего, когда в нём есть то, что вы собрали бы сами: ошибка в консоли со стек-трейсом, упавший запрос с телом, шаги, которые к этому привели, и браузер, в котором всё случилось. Midge автоматически собирает всё это из вкладки Chrome, выстраивает на одной временной шкале с видео и скрывает секреты до загрузки, так что репорт можно спокойно вставить в тикет, pull request или чат с ИИ.

В каждой записи есть логи консоли, сетевые запросы, действия пользователя и данные об устройстве. Это значит меньше сообщений «можешь прислать консоль?» и больше багов, исправленных с первого прочтения.

Что вы получаете в репорте

Одна временная шкала

Видео находится рядом с панелью сообщений консоли, сетевых запросов и действий пользователя, упорядоченных по времени. Смотрите на клик по Save, и сразу рядом — последовавший за ним PATCH /api/projects/88, а через несколько миллисекунд после ответа — Uncaught TypeError. Не нужно восстанавливать последовательность событий по трём вложениям.

Консоль со стек-трейсами

Все уровни от debug до error, а также неперехваченные исключения и необработанные отклонения промисов со стеками. Midge начинает слушать уже при загрузке страницы, поэтому ошибки старта тоже попадают в репорт, а скользящий буфер сохраняет ошибки, случившиеся ещё до того, как тестировщик нажал запись. Подробнее — на странице логов консоли.

Подробности о сети

Запросы fetch и XHR приходят с заголовками, телами запросов и ответов, кодами статуса и таймингами. Сообщения WebSocket записываются в обе стороны. Для остальных ресурсов показываются статус, размер и время. Для GraphQL у каждого запроса видно имя операции, а ответы 200 с массивом errors помечаются отдельно, ведь фильтр по статусу их бы пропустил. Подробнее — на странице сетевых логов.

Данные об устройстве

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

Копировать как cURL

Любой запрос можно скопировать как команду cURL и запустить из терминала:

curl 'https://staging.acme.dev/api/projects/88' \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -H 'Authorization: [REDACTED]' \
  --data-raw '{"name":"Q4 roadmap","archived":null}'

Скрытый заголовок Authorization — это намеренно. Подставьте токен своего тестового пользователя, и вы повторите в точности тот же запрос, без того чтобы кто-то делился живой сессией. Если нужно разобрать токен из своего окружения, бесплатный JWT-декодер покажет его claims и срок действия, никуда его не отправляя.

Скачать очищенный HAR

Когда нужен весь сетевой лог — для вопроса о производительности или для поддержки поставщика API, — скачайте его как HAR файл. В файле только очищенные данные. Откройте его в бесплатном просмотрщике HAR файлов или в любом инструменте, который читает HAR. Если вы работаете с HAR, который кто-то выгрузил прямо из DevTools, прочитайте, как удалить чувствительные данные из HAR файла, прежде чем пересылать его дальше.

Скрытие данных, чтобы репорт можно было вставить куда угодно

Баг-репорты вставляют повсюду: в тикеты, треды Slack, описания pull request, чаты с ИИ-ассистентами для программирования. Пароли, номера карт, токены и cookies скрываются в вашем браузере, прежде чем что-либо покинет ваше устройство. Сюда входят:

  • заголовки Authorization, Cookie и Set-Cookie, а также любой заголовок, в названии которого есть token, secret, session или auth,
  • чувствительные параметры URL, например access_token, code и signature,
  • поля тела, например password, otp, cvv и client_secret,
  • JWT, номера карт, проходящие проверку по алгоритму Луна, приватные ключи и API-ключи Stripe, AWS, GitHub, Slack, Google, OpenAI и Anthropic.

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

Работа с ИИ-агентами

У Midge есть MCP-сервер по адресу https://midge.dev/mcp, так что Claude Code, Cursor и другие агенты могут напрямую читать консоль, сеть и действия из репорта. Вставьте ссылку на репорт в чат, и агент заберёт нужное через инструменты только для чтения, такие как get_console, get_network и get_user_actions. Он входит через ваш браузер или использует токен из Settings › Account › AI assistants. Упавший запрос по-прежнему можно скопировать как cURL или приложить очищенный HAR. В любом случае данные уже вычищены.

Как получать от команды репорты получше

Даже лучший инструмент зависит от того, что люди записывают. Поделитесь с тестировщиками и поддержкой нашим гайдом о том, как написать баг-репорт, и покажите им запись экрана. Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака, так что экономить на записях никому не придётся.

Частые вопросы

Что видит разработчик, когда открывает репорт Midge?
Видео или скриншот, а рядом — сообщения консоли, сетевые запросы, действия пользователя и данные об устройстве, упорядоченные по времени. У запросов видны заголовки, тела, коды статуса и тайминги.
Можно ли повторить упавший запрос?
Да. Любой записанный запрос можно скопировать как команду cURL. Заголовки авторизации и cookies скрыты, поэтому перед запуском подставьте токен своего тестового аккаунта.
Безопасно ли вставлять репорт Midge в публичный issue или чат с ИИ?
Midge удаляет пароли, номера карт, токены, cookies и известные форматы API-ключей до загрузки. Скрытие работает по правилам, поэтому необычные данные стоит проверить, но типичных секретов там уже нет.
Можно ли пользоваться Midge для собственной отладки?
Да. Записать баг, который вы нашли сами, — быстрый способ передать его коллеге или вернуться к нему позже, когда логи всё ещё на месте.