Баг-репорты для разработчиков: те улики, которые вы собрали бы сами
Обновлено
Баг-репорт для разработчика работает лучше всего, когда в нём есть то, что вы собрали бы сами: ошибка в консоли со стек-трейсом, упавший запрос с телом, шаги, которые к этому привели, и браузер, в котором всё случилось. 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 для собственной отладки?
- Да. Записать баг, который вы нашли сами, — быстрый способ передать его коллеге или вернуться к нему позже, когда логи всё ещё на месте.