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

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

Установить

Session Replay

Бесплатное расширение для Chrome. Один клик на странице, которая ведёт себя не так, захватывает скриншот, консоль и сетевой журнал и отдаёт вам ссылку, которую можно вставить в задачу.

Установить расширение

Chrome и браузеры на Chromium, из Web Store. Настраивать после этого нечего.

Записать ошибку

Откройте страницу, которая ведёт себя не так, и нажмите на значок расширения на панели инструментов.

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

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

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

Добавьте описание, если оно у вас есть. Необязательно, и стоит этих пятнадцати секунд: чего вы ожидали. Это единственное, чего запись знать не может.

Что записывается без всякого вашего участия

Это та часть, ради которой отчёт стоит читать, и ничего из этого не требует открывать инструменты разработчика:

  • Браузер, версия, операционная система и размер экрана, которые решают, общий это дефект или только ваш
  • Вывод консоли, включая ошибку, напечатанную, пока никто не смотрел
  • Сетевой журнал, со статусом и таймингами каждого запроса, который сделала страница, и файл HAR, который можно скачать и открыть в инструментах разработчика
  • Что делали вы: клики, заполнения полей и переходы, приведшие к ошибке, по порядку, и именно это превращает отчёт в шаги воспроизведения

Одну вещь нужно включить осознанно. Отметьте флажок тел ответов до записи, и расширение подключит отладчик Chrome, так что в отчёт попадёт то, что сервер действительно вернул, а не только строка запроса. По умолчанию он выключен, а пока отладчик подключён, Chrome всё это время показывает собственное предупреждение.

Поделиться

Вы получаете ссылку. Вставьте её туда, где идёт работа: в задачу, в пул реквест, в чат. Тот, кто её откроет, увидит запись и рядом с ней все вкладки с контекстом, без аккаунта и ничего не устанавливая.

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

Ссылка для обмена по умолчанию общедоступна. Именно это делает её удобной для отправки, и об этом стоит знать до того, как записывать страницу с чьими-то персональными данными или с внутренней системой. Если домен ваш и у вас платный тариф, это можно изменить: отчёты могут начинаться приватными, видимыми только тому, кто их прислал, и вашей команде, а любой отчёт можно потом перевести в другое состояние.

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

То, чего инструмент не делает

Запись - это свидетельство. Это ещё не отчёт.

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

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

Коротко

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