Как написать воспроизводимый отчёт о браузерной ошибке
Превратите сбой браузера в полезный безопасный отчёт с ожидаемым поведением, минимальными шагами и данными окружения.
BotBrowser Team
Нужна структурированная документация по теме Начало работы?
Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.
Хороший отчёт позволяет повторить сбой без догадок. Он описывает ожидаемое и фактическое поведение, минимальное воспроизведение, окружение и безопасные свидетельства. Это не вывод о причине и не запрос приватного состояния браузера.
Ожидаемое и фактическое поведение
Начните с видимого контракта. «После Save появляется подтверждение и фокус переходит к заголовку» это ожидаемое; «запрос завершён, но состояние не появилось, фокус остался на Save» это фактическое. Не называйте причину без доказательства.
Один отчёт должен описывать один связный сбой. Вход, разметка и загрузка могут иметь один release, но требуют разных шагов и владельцев. Связывайте отчёты публичным id без копирования приватных трасс.
Используйте рекомендации Chromium и Mozilla. Им не нужны учетные данные или полный dump браузера.
Минимальное воспроизведение
Удаляйте шаги, пока удаление одного не уберёт сбой. Используйте собственный fixture, синтетические данные, точное действие, видимый результат и очистку. Не проверяйте сервис, которым не владеете.
Заголовок: нет подтверждения после сохранения тестового профиля
Ожидается: открыть fixture, изменить имя, выбрать Save, увидеть «Сохранено» и переместить фокус.
Фактически: запрос завершён, состояние отсутствует, фокус остался на Save.
Окружение: Chromium 154, Linux, 1280x800, клавиатура и указатель, app 2026.10.06, 5/5 запусков.
| Состояние | Свидетельство | Действие |
|---|---|---|
| Блокирующее и воспроизводимое | шаги всегда сбойны | владелец и остановка release |
| Воспроизводимое и узкое | одна маршрут или условие | сравнить рабочую ячейку |
| Непостоянное | частота и окно | добавить контекст и повторить |
| Не воспроизводится | точные fixture и окружение | запросить одно условие |
| Скрыто приватностью | чувствительные данные удалены | одобренный канал или видимые факты |
Данные окружения
Записывайте семейство и версию браузера, платформу, viewport, ввод, release, маршрут, locale, профиль, разрешения и сеть только при влиянии на результат. Укажите холодный или тёплый кэш и видимость. Разделяйте build приложения, браузера и профиля; если изменились все, причина остаётся неизвестной.
BotBrowser может повторять разрешённые сценарии с объявленными профилем, платформой, release, viewport, маршрутом и тестовыми данными. Он не выводит причину, не собирает приватные логи, не раскрывает секреты, не гарантирует исправление и не разрешает воспроизведения против сторонних сервисов.
Проверка приватности
Удаляйте cookies, токены, пароли, аккаунты, приватные URL, параметры, личный текст, чужие вкладки и клиентские файлы. Используйте синтетические имена. Обрезайте скриншоты, скрывайте адреса и уведомления. Не отправляйте полный профиль, сеть или хранилище в публичный tracker.
Для приватных свидетельств используйте контролируемый канал, владельца хранения и срок. Публичный отчёт может указать на редактированный артефакт.
Triage и follow-up
Отчёт готов, когда шаги, видимая разница, окружение и приватная граница понятны. Добавьте частоту, первый сбойный шаг и восстановление. Если сбой не повторяется, сравните известный маршрут и запросите одно условие.
В release свяжите отчёт с кандидатом, ячейкой матрицы или регрессией. Решение может блокировать, дать ограниченное исключение, использовать резервный путь или быть вне области. Сохраняйте исходный сбой и проверенное исправление.
Перед закрытием проверьте, что fixture и синтетические данные доступны команде, которая продолжит проверку. Укажите владельца следующего запуска и условие, которое нельзя менять.
Если результат меняется, сохраните число запусков и временное окно. Такая короткая статистика помогает сравнить исправление, не выдавая единичный запуск за доказательство.
Проверьте заголовок, начальный шаг, первую видимую разницу и ожидаемое действие владельца. Эти ориентиры позволяют начать разбор без чтения длинной трассировки.
Храните версии браузера и приложения раздельно. Если они обновились одновременно, описывайте наблюдаемую комбинацию и оставляйте причину неизвестной до сравнения.
Используйте синтетическую fixture, которую можно сбросить. Форму приватного состояния опишите в отчёте, а само значение оставьте в контролируемом канале.
Добавьте результат исправления в тот же отчёт, указав число запусков и неизменные условия. Так сохраняется история для следующих release.
Для каждой новой проверки записывайте владельца и дату следующего запуска. Это уменьшает риск, что воспроизводимый случай останется без ответа.
Сохраняйте ссылку на тестовую fixture, чтобы другая команда могла повторить тот же сценарий без догадок.
Для контекста используйте проверку release и матрицу браузерных тестов.
Публичные источники
Похожие статьи
Переведите BotBrowser из исследований в продакшн
Используйте эти руководства, чтобы понять модель, а затем перейти к кроссплатформенной валидации, изолированным контекстам и масштабируемому браузерному развертыванию.