Назад в Центр знаний
Начало работы

Trace Viewer Playwright для отладки разрешённых тестов

Сохраняйте трассировки Playwright для повторяемой диагностики тестов и держите их содержимое, хранение и передачу в утверждённых границах.

BotBrowser Team

Документация

Нужна структурированная документация по теме Начало работы?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

Путь трассировки Playwright от записи разрешённого теста к локальной проверке и контролируемому хранению

TL;DR

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

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

Содержание

Содержимое трассировки Playwright

Tracing Playwright записывает временную шкалу разрешённого теста для проверки сбоя. Trace Viewer показывает действия, сеть, консоль, снимки и состояния страницы в зависимости от параметров. Трассировка описывает наблюдение браузера и не доказывает принятие запроса сервисом. BotBrowser может служить тестируемым браузером, пока Playwright записывает трассу контролируемого запуска, но не может добавить в трассу события за пределами браузера. Если ожидаемый вывод консоли отсутствует, разделите stdout Node, события консоли страницы и неперехваченные исключения, прежде чем считать отсутствие сообщения сбоем приложения. Для кнопки внутри iframe сопоставьте документ на снимке с деревом фреймов в момент неудачного клика.

Документация Trace Viewer описывает просмотр шагов, а рекомендации Playwright требуют изолированных тестов. Ищите первое действие или утверждение, отклонившееся от контракта. Если в трассировке есть ответ, которого не дождался тест, сопоставьте момент подписки с GET и POST при сохранении: так можно отличить позднюю подписку от выбора не того ответа.

В трассировке могут быть текст, подписи, URL и заголовки. Записывайте только синтетический или утверждённый сценарий; не добавляйте реальную сессию, платежи или токены. Сетевое мокирование в собственных тестах описано в материале Сетевое мокирование для собственных тестов браузерной автоматизации.

См. жизненный цикл BrowserContext и модель хранения. Изоляция не очищает уже созданную трассировку.

Ограниченная запись

Запускайте tracing в минимальном fixture и останавливайте в finally. Обычно сохраняют первую повторную попытку и сверяются с актуальным API. Если в трассировке видна нужная кнопка, но проверка имени не прошла, сравните имя в снимке ARIA с видимой надписью, прежде чем обновить эталон.

await context.tracing.start({ screenshots: true, snapshots: true, sources: false });
try {
  await runAuthorizedScenario(page);
} finally {
  await context.tracing.stop({ path: tracePath });
}

Используйте путь worker и отмечайте отсутствующий или неполный архив как инфраструктурный результат. Трассировка отвечает на ограниченный вопрос.

Повтор создаёт новый контекст с теми же синтетическими входами. Не используйте неизвестное состояние. Об изоляции тестов и фикстурах рассказывает материал Фикстуры и изоляция браузерной автоматизации.

Проверка и хранение

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

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

Срок хранения должен соответствовать задаче. После воспроизведения примените истечение и контроль доступа. context.close() не удаляет копию в CI. Жизненный цикл контекста и состояние хранилища разбираются в материале Жизненный цикл BrowserContext и состояние хранилища в Playwright.

Порядок работы и границы

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

Используйте artifacts/traces/<test>-<worker>-<attempt>.zip и минимальные метаданные. Явно отмечайте пропущенный, повреждённый или поздний архив.

BotBrowser может предоставить изолированный контекст и повторяемый профиль для разрешённого потока Playwright. Он не гарантирует отсутствие чувствительного содержимого, не удаляет токены из снимков и не делает сбой сервиса наблюдаемым; владелец выбирает синтетические входы и соблюдает доступ и хранение. См. документацию об изоляции аккаунтов.

Назовите тест.

Назовите синтетический сценарий.

Запишите версии.

Укажите первое отклонение.

Классифицируйте результат.

Отметьте снимки.

Отметьте сетевые данные.

Выделите закрытый путь worker.

Остановите tracing до перемещения.

Не записывайте секреты в CI.

Создавайте контекст для каждой попытки.

Не используйте неизвестное состояние.

Не объявляйте первый сбой незначимым.

Предпочитайте видимое условие.

Включайте снимки только при необходимости.

Уменьшайте слишком большой архив.

Ограничьте читателей.

Задайте срок истечения.

Проверяйте данные перед передачей.

Разделяйте браузерные и серверные свидетельства.

Владелец подтверждает серверный ответ.

Записывайте ошибки очистки.

Пересматривайте правило после изменения потока.

Повторяйте в чистой папке.

Удаляйте только файлы теста.

Сделайте очистку повторяемой.

Удаляйте закрытые копии по сроку.

Проверяйте чувствительные поля.

В записи укажите тест, синтетический сценарий, версии, первое отклонение и срок хранения.

Определите ожидаемый контракт до запуска.

Читайте трассировку от утверждения к первому неожиданному состоянию.

Выбирайте снимки по вопросу диагностики.

Считайте размер артефакта операционным ограничением.

Каждая повторная попытка получает новый контекст.

Разделяйте пути параллельных workers.

Ограничьте доступ так же строго, как к секрету.

Очищайте архив и экспортированные снимки.

Преобразуйте первое отклонение в узкую регрессию.

Повторяйте в чистой папке с указанной версией браузера.

Заменяйте хрупкие ожидания видимыми условиями.

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

Делайте очистку наблюдаемой без содержимого архива.

Для навигации сравните временную шкалу с видимым сигналом завершения.

Для утверждения проверьте снимок шага и синтетическое состояние fixture.

Для сети запишите категорию и документированный статус, не копируя заголовки.

Для визуального отличия проверьте язык, viewport и версию до обновления базы.

Запишите следующее действие после проверки.

Передавайте закрытую ссылку, а не полный архив.

Не помещайте идентификаторы аккаунта в метки.

Подтверждайте сервер поддерживаемыми журналами.

После инцидента храните только очищенный вывод.

Контрольный список

  • Назовите разрешённый сценарий и утверждение.
  • Включайте tracing только для нужного fixture.
  • Используйте закрытый уникальный путь.
  • Очищайте данные перед передачей.
  • Запишите результат, версии и срок хранения.

Источники

Итог

Если нужно выбрать сопровождаемый контракт автоматизации, сравните Playwright и Puppeteer по соединению, состоянию, трассам и версии браузера отдельно от этого процесса отладки тестов.

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

#Playwright#Trace Viewer#Отладка Тестов#Артефакты Тестов#Конфиденциальность

Эта статья входит в руководство: Начало работы с автоматизацией браузера: карта

Выполните ту же проверку в BotBrowser

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