Шаги воспроизведения — это пронумерованные действия, по которым другой человек дойдёт от известной исходной точки до того же бага, что видели вы. В хороших шагах сказано, откуда вы начали (страница, аккаунт, что лежало в корзине), на каждой строке — одно действие с точными значениями, которые вы вводили, а в конце — что вы ожидали и что получилось вместо этого.
Каким приходит отчёт
Майя Томпсон — покупательница Acme Store, демо-магазина, на котором я делаю скриншоты. И она, и магазин выдуманы, а её баг — тот же, что в посте про Whisper. Здесь речь о шагах. Майя вводит FALL20 в поле для скидки, получает вместо итоговой суммы $NaN и отправляет через кнопку баг-репорта в магазине такой текст:
Applied FALL20 and the total turned into "$NaN". Shipping still says Free and I can't continue to payment.
(Применила FALL20, и сумма превратилась в «$NaN». В доставке по-прежнему написано Free, и перейти к оплате не получается.)

Для покупателя это хороший отчёт: в нём есть код, симптом и то, что из-за бага не работает. Но на машине разработчика, где API доставки отвечает, FALL20 даёт правильную сумму.
Тот же баг в виде шагов
Шаги, по которым разработчик пройдёт сам, начинаются с состояния, которое он может воссоздать у себя:
Начало: https://acme-store.com/cart, вход под покупателем cus_1042
Корзина: 2 × Enamel camp mug, 1 × Canvas market tote, 1 × Merino rib beanie
Доставка: Portland, OR 97205
1. Нажать + рядом с Canvas market tote. Количество становится 2.
2. Ввести FALL20 в поле Discount code.
3. Нажать Apply.
Ожидаемый результат: Discount −$23.20, итого $92.80.
Фактический результат: Discount −$23.20, итого "$NaN". В Shipping по-прежнему Free.
Кнопка Continue to payment не реагирует.
Браузер: Chrome 141 на macOS, окно 1280 × 800
Как часто: при каждой попытке
Зачем нужна каждая часть:
Исходное состояние другой человек может воссоздать. «Корзину с какими-то товарами» — не может.
Записаны все действия, даже те, что кажутся лишними. Майя поменяла количество сумок перед тем, как применить код. Здесь это ни на что не повлияло, но разработчик не узнал бы этого, не попробовав.
Одно действие на шаг, и шаг начинается с глагола: нажать, ввести, выбрать, прокрутить.
Точные значения, потому что FALL20 и «купон» — разные входные данные. Один код снимает 20%, другой — $10, и сломаться может только один из них.
Надписи — так, как их показывает страница: Discount code, Apply, Continue to payment. Разработчик ищет эти строки в коде.
Ожидаемый результат — числом. «Правильная сумма» заставляет разработчика сначала её посчитать, а $92.80 проверяется одним взглядом.
Браузер, ОС и размер окна: баг вёрстки при ширине 1280 пикселей может не проявляться при 1440.
Как часто: каждый раз, в одной попытке из пяти, один раз.
Всё, что вы заметили по пути: сообщение об ошибке, спиннер, который так и не остановился.
Предусловие, которого покупательница не видела
На машине, где API доставки отвечает, эти шаги дают $92.80.
Когда Майя нажала Apply, магазин запросил у своего API доставки новый тариф. Через 1,2 секунды API ответил 503 с carrier_timeout вместо тарифов, и страница прибавила к сумме неопределённую стоимость доставки. Поэтому первая строка шагов — предусловие: эндпоинт тарифов доставки отвечает ошибкой, здесь — 503. Покупатель такого не напишет: в строке Shipping по-прежнему Free, и ничто на странице не говорит о неудачном запросе.
Для состояния, которым автор отчёта не управляет, в шагах нужна строка с предусловием. Это ответы сервера, фича-флаги, данные аккаунта.
BugDump записывает шаги, пока покупатель кликает
В BugDump шаги записывает сам виджет. В каждом отчёте из виджета есть список Actions: клики, введённые значения, переключения, выбранные варианты, отправленные формы и переходы между страницами, по порядку. Вот список Майи:

Шесть строк совпадают с шагами выше, включая клик у сумки, о котором Майя не написала. Как устроен список:
Он называет элементы, а не надписи. Первая строка,
Clicked <button type="button">, — это + рядом с сумкой. Какая именно это была кнопка, видно в воспроизведении сессии из того же отчёта.Он скрывает поля с конфиденциальными данными. Поля паролей, поля, у которых
autocompleteуказывает на номер карты, срок действия, код безопасности или одноразовый код, и всё внутриdata-bugdump-maskили.bugdump-blockотображаются как Typed (hidden). Поле карты без такогоautocompleteзаписывается как любое другое. Остальные введённые значения обрезаются до 80 символов.Он хранит последние 500 действий, а пока автор отчёта записывает экран — 3000.
Предусловие — в том же отчёте. На вкладке Network есть 503 от /api/shipping/rates, а на вкладке Console — сообщение об этой ошибке, которое вывел сам магазин. Магазин включил тела сетевых запросов, поэтому на вкладке виден и carrier_timeout. По умолчанию тела выключены, но и без них вкладка показывает 503 и сколько длился запрос.
С этими данными разработчик пишет первую строку: эндпоинт тарифов отвечает 503. С моком или правилом прокси, которое возвращает этот ответ, шаги 1–3 дают $NaN при каждой попытке. Заблокировать запрос мало: запрос без ответа оставляет сумму $92.80.
Частые вопросы о шагах воспроизведения
Шаги воспроизведения — это и есть баг-репорт? Нет, это его часть. В баг-репорте есть ещё заголовок и доказательства: скриншоты, консоль, сеть.
Сколько должно быть шагов? Как можно меньше, лишь бы они доводили от начала до бага. Начинайте с ближайшей к багу страницы, которую другой человек может открыть напрямую: каждый шаг до неё — ещё один шаг, который может пойти иначе.
Что делать, если баг не воспроизводится даже у меня? Запишите, что вы делали, укажите, что это случилось один раз, и приложите консоль и сетевые запросы, записанные в тот раз.
Читайте также
Как написать хороший баг-репорт (с чек-листом): весь отчёт вокруг шагов, от заголовка до доказательств.
Что делать с баг-репортом, который не воспроизводится: когда шаги верные, а баг всё равно не появляется.
Воспроизведение сессии для отладки: что пользователь сделал перед багом: что даёт воспроизведение сессии, когда в списке действий написано
<button>и нужно понять, какая именно кнопка.
