Мгновенный повтор для баг-репортов: сохраните баг, который уже случился
Обновлено
Мгновенный повтор в Midge позволяет сообщить о баге уже после того, как он случился. Когда повтор включён для сайта, Midge ведёт скользящую запись последних 30–120 секунд страницы, и один клик сохраняет это окно как баг-репорт с прикреплёнными логами консоли, сетевыми запросами и действиями пользователя. По умолчанию функция выключена, и вы включаете её для отдельных сайтов или для всех сразу.
Главная проблема плавающих багов — тайминг. Выпадающий список мигнул, всплывающее уведомление показало не то сообщение, таблица дёрнулась, а пока вы запускаете запись, всё уже прошло. С мгновенным повтором воспроизводить баг не нужно. Он у вас уже есть.
Как это работает
Мгновенный повтор не записывает видео. Он записывает саму страницу: DOM, то есть структуру элементов и текста, которую рисует браузер. Midge сохраняет снимок страницы, а затем каждое её изменение — добавленный узел, переключённый класс, обновлённый текст — вместе с прокруткой и кликами. Плеер повтора шаг за шагом восстанавливает страницу по этой записи.
Длину буфера выбираете вы, от 30 до 120 секунд. Старые изменения отбрасываются по мере поступления новых, так что расход памяти ограничен. Когда вы нажимаете сохранить повтор, Midge берёт текущий буфер, добавляет логи консоли и сети за тот же период и предлагает создать репорт.
Почему не непрерывное видео?
Мы думали о том, чтобы постоянно записывать экран и хранить последние две минуты. И отказались от этого по двум причинам.
- Chrome показывает индикатор демонстрации, пока идёт захват. Постоянная плашка «эта вкладка транслируется» отвлекает и приучает людей игнорировать предупреждение, которое существует ради их безопасности.
- Видео стоит процессора, памяти и батареи. Непрерывное кодирование кадров в каждой вкладке замедлило бы браузер, а инструмент для отладки должен делать обратное.
Запись DOM обходит обе проблемы. Она всё же тяжелее сбора логов, потому что хранит копию содержимого страницы, поэтому мы оставляем её выключенной, пока вы сами не решите, что она нужна.
Как включить
Мгновенный повтор по умолчанию выключен. Включить его можно:
- для всех сайтов, если вы целый день тестируете много разных приложений, или
- для отдельных сайтов, например только для
staging.yourapp.comиlocalhost.
Список исключений всё равно важнее. Если сайт в этом списке, Midge там не работает совсем, и повтор тоже. Хорошая стартовая настройка: включить повтор на стейджинге и локальных хостах разработки, оставить выключенным для всего остального и добавить в список исключений банк и почту.
Что есть в репорте с повтором
Сохранённый повтор — это полноценный репорт Midge. В каждой записи есть логи консоли, сетевые запросы, действия пользователя и данные об устройстве. Повтор — не исключение. Разработчик, открывший ссылку, увидит:
- воспроизведённую страницу в плеере,
- сообщения консоли за те же 30–120 секунд, включая неперехваченные ошибки (см. логи консоли),
- трафик fetch, XHR и WebSocket с телами и таймингами (см. сетевые логи),
- клики, переходы между страницами и поля, в которые вы что-то вводили, без самого текста,
- браузер, операционную систему, размер окна и URL страницы.
Конфиденциальность в повторах
Повтор содержит содержимое страницы, поэтому правила здесь строже, чем для видео вкладки:
- Все значения полей ввода замаскированы. То, что было набрано в любом поле, в повтор не попадает.
- Текст на странице проверяется по тем же шаблонам, что и логи: JWT, номера карт, проходящие проверку по алгоритму Луна, API-ключи и приватные ключи удаляются, а email и международные номера телефонов маскируются наполовину.
- Логи тоже очищаются. Пароли, номера карт, токены и cookies удаляются прямо в браузере, прежде чем что-либо покинет ваше устройство.
На странице скрытия данных перечислены все правила. Скрытие работает по правилам, поэтому необычный секрет, показанный на экране обычным текстом, может остаться нераспознанным. Команды могут добавлять свои названия полей.
Ограничения, о которых стоит знать
Повтор DOM — это реконструкция, а не копия пикселей. Большинство страниц воспроизводятся точно, но то, что не описано в DOM, например рисунки на canvas или медиа, играющие внутри страницы, может выглядеть не совсем так, как было. Если баг визуальный именно в этом смысле, используйте запись экрана.
Кроме того, повтор охватывает только то время, пока он работал. Если вы включили его для сайта минуту назад, в буфере не больше этой минуты.
Когда пригодится мгновенный повтор
- Плавающие баги интерфейса, которые не получается воспроизвести по заказу.
- Исследовательское тестирование, когда вы понимаете, что это был баг, только после того, как он случился.
- Демо и показы на стейджинге, когда что-то ломается прямо на глазах у коллеги.
Для багов, которые легко воспроизвести, часто хватает обычной записи или скриншота с пометками. Общие советы о том, что включать в репорт в любом случае, — в гайде как сообщить о баге. А если вам нужна только сетевая сторона инцидента от коллеги, у которого не был запущен Midge, попросите у него HAR файл и очистите его с помощью бесплатной очистки HAR, прежде чем он попадёт в тикет.
Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака.
Частые вопросы
- Мгновенный повтор — это видео?
- Нет. Он записывает изменения структуры страницы (DOM) и воссоздаёт их в плеере. Это легче видео и обходится без постоянного индикатора демонстрации экрана в Chrome.
- Мгновенный повтор включён по умолчанию?
- Нет. Он выключен, пока вы его не включите — для всех сайтов или только для выбранных. Сбор логов консоли и сети работает и без него.
- Насколько далеко назад он сохраняет?
- Вы выбираете окно от 30 до 120 секунд. Когда вы сохраняете повтор, Midge оставляет именно столько секунд до момента клика.
- Записывает ли мгновенный повтор то, что я набираю?
- Нет. Все значения полей ввода в повторе замаскированы, а текст на странице проходит те же правила скрытия, что и логи, поэтому токены, номера карт и подобные значения удаляются.