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

Запись экрана с логами консоли, включая ошибки до нажатия «Запись»

Обновлено

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

Именно этого не хватает большинству баг-репортов. Когда вы замечаете, что что-то сломалось, ошибка уже давно пролетела в окне DevTools, которое никто не открывал. Midge убирает шаг «а можешь повторить с открытой консолью?».

Что собирается

Все уровни консоли

Midge записывает вызовы log, info, warn, error и debug с временными метками и переданными значениями. Предупреждения важнее, чем кажется: предупреждение React о ключах или уведомление об устаревшем API прямо перед падением часто и есть настоящая подсказка.

Неперехваченные ошибки

Исключения, которые никто не перехватил, никогда не проходят через console.error. Они всплывают до уровня окна, и браузер печатает их красным. Midge слушает и их, так что падение в обработчике события будет видно, даже если в вашем приложении нет никакого логирования.

Необработанные отклонения промисов

Отклонённый промис без .catch() — один из самых частых тихих сбоев в современных фронтендах. Кнопка «ничего не делает», потому что fetch завершился с ошибкой, а обработать её никто не догадался. Midge записывает такие отклонения и их причину.

Стек-трейсы

Для ошибок Midge сохраняет стек-трейс, который сообщает браузер. Обычная запись выглядит так:

Uncaught (in promise) TypeError: Failed to fetch
    at submitOrder (orders.js:88:15)
    at HTMLButtonElement.onClick (checkout.js:41:9)

Если продакшен-бандл минифицирован, в стеке будут минифицированные имена файлов и позиции — ровно так, как их сообщил браузер. Поэтому держите source maps под рукой, когда читаете репорт с продакшена.

Собирается ещё до нажатия записи

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

Когда вы запускаете запись экрана или делаете скриншот, эта недавняя история прикрепляется к репорту. На практике это значит, что можно спокойно работать, заметить, что что-то не так, и только потом решить сообщить о баге. Красная ошибка 20-секундной давности всё ещё на временной шкале.

Несколько слов о буфере:

  • Он живёт только в памяти и очищается при закрытии вкладки.
  • Ничего не покидает ваш компьютер, если вы не создаёте репорт.
  • Он работает на обычных страницах http и https. Можно добавить сайты, где Midge не должен работать вообще, например банк или менеджер паролей.

Консоль и видео на одной временной шкале

В каждой записи есть логи консоли, сетевые запросы, действия пользователя и данные об устройстве. В репорте консоль находится рядом с видео и отсортирована по времени. Смотрите момент, когда модальное окно не открылось, и соответствующий TypeError будет прямо там, на пару строк ниже клика, который его вызвал.

Ошибки естественно связываются с сетевой активностью. 500 от /api/orders, а следом Cannot read properties of undefined — и вся история понятна: сервер упал, а клиент не обработал сбой. Подробнее — на странице про сетевые логи.

Секреты в выводе консоли

Разработчики логируют то, чего логировать не стоит, особенно во время отладки: токен, целый объект пользователя, URL запроса с API-ключом в query string. Midge применяет к тексту консоли те же правила скрытия, что и к сетевым данным. Пароли, номера карт, токены и cookies удаляются прямо в браузере, прежде чем что-либо покинет ваше устройство.

Например, вот эта строка:

auth ok: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123 for [email protected]

в репорте выглядит так:

auth ok: [REDACTED] for j***@acme.com

Полный список правил и то, чего скрытие не ловит, — на странице скрытия данных.

Midge против ручного экспорта консоли

Сохранить вывод консоли из Chrome DevTools можно и самому — наш гайд о том, как экспортировать логи консоли в Chrome, объясняет как. Это работает, но с пробелами. DevTools должны быть открыты до того, как случится ошибка, экспорт — это простой текст без видео, и никто не убирает из него секреты. Если вы всё же экспортируете логи или HAR файл вручную, прогоните HAR через бесплатную очистку HAR, прежде чем прикреплять его к тикету.

С Midge консоль собирается независимо от того, были ли открыты DevTools, синхронизирована с тем, что вы видели, и очищена от секретов до загрузки.

Кто читает эти логи

QA-тестировщики перестают вставлять в тикеты обрывки стек-трейсов. Агенты поддержки могут приложить к эскалации настоящий вывод ошибок, даже не зная, что такое консоль. Разработчики получают точную ошибку, стек и окружающие сетевые запросы в одном месте. Если это про вас, посмотрите страницу Midge для разработчиков.

Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака.

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

Какие сообщения консоли собирает Midge?
Все пять уровней: log, info, warn, error и debug. Ещё Midge записывает неперехваченные исключения и необработанные отклонения промисов, которые никогда не проходят через console.error, вместе с их стек-трейсами.
Может ли Midge поймать ошибку, которая случилась до начала записи?
Да. Midge держит в памяти последние несколько минут вывода консоли для каждой вкладки, поэтому запись или скриншот, сделанные сразу после ошибки, всё равно её содержат. Буфер очищается при закрытии вкладки и не покидает ваше устройство, если вы не создаёте репорт.
Удаляются ли секреты из сообщений консоли?
Да. JWT, номера карт, API-ключи известных форматов, приватные ключи и чувствительные параметры URL удаляются из текста консоли, а email и международные номера телефонов маскируются наполовину.
Нужно ли открывать DevTools?
Нет. Midge собирает консоль без открытых DevTools, а тот, кто откроет ваш репорт, увидит сообщения рядом с видео.