Перейти к основному содержимому

Tracing

API для сбора и сохранения трассировок Playwright. Трассировки Playwright могут быть открыты в Trace Viewer после выполнения скрипта Playwright.

Начните запись трассировки перед выполнением действий. В конце остановите трассировку и сохраните её в файл.

Browser browser = chromium.launch();
BrowserContext context = browser.newContext();
context.tracing().start(new Tracing.StartOptions()
  .setScreenshots(true)
  .setSnapshots(true));
Page page = context.newPage();
page.navigate("https://playwright.dev");
context.tracing().stop(new Tracing.StopOptions()
  .setPath(Paths.get("trace.zip")));

Методы​

group​

Добавлено в: v1.49 tracing.group
предупреждение

Используйте test.step, если доступно.

Создает новую группу в пределах трассировки, назначая все последующие вызовы API этой группе, до тех пор, пока не будет вызван Tracing.groupEnd(). Группы могут быть вложенными и будут видны в просмотрщике трассировок.

Использование

// Все действия между group и groupEnd
// будут показаны в просмотрщике трассировок как группа.
page.context().tracing().group("Open Playwright.dev > API");
page.navigate("https://playwright.dev/");
page.getByRole(AriaRole.LINK, new Page.GetByRoleOptions().setName("API")).click();
page.context().tracing().groupEnd();

Аргументы

  • name String#

    Имя группы, отображаемое в просмотрщике трассировок.

  • options Tracing.GroupOptions (опционально)

    • setLocation Location (опционально)#

      • setFile String

      • setLine int (опционально)

      • setColumn int (опционально)

      Указывает пользовательское расположение для группы, которое будет показано в просмотрщике трассировок. По умолчанию используется расположение вызова Tracing.group().

Возвращает

groupEnd​

Добавлено в: v1.49 tracing.groupEnd

Закрывает последнюю группу, созданную Tracing.group().

Использование

Tracing.groupEnd();

Возвращает

start​

Добавлено в: v1.12 tracing.start

Начать трассировку.

Использование

context.tracing().start(new Tracing.StartOptions()
  .setScreenshots(true)
  .setSnapshots(true));
Page page = context.newPage();
page.navigate("https://playwright.dev");
context.tracing().stop(new Tracing.StopOptions()
  .setPath(Paths.get("trace.zip")));

Аргументы

  • options Tracing.StartOptions (опционально)

    • setName String (опционально)#

      Если указано, промежуточные файлы трассировки будут сохранены в файлы с заданным префиксом имени внутри каталога, указанного в setTracesDir, указанного в BrowserType.launch(). Чтобы указать имя конечного zip-файла трассировки, необходимо передать опцию path в Tracing.stop().

    • setScreenshots boolean (опционально)#

      Захватывать ли скриншоты во время трассировки. Скриншоты используются для построения предварительного просмотра временной шкалы.

    • setSnapshots boolean (опционально)#

      Если эта опция включена, трассировка будет

      • захватывать снимок DOM при каждом действии
      • записывать сетевую активность

    • setSources boolean (опционально) Добавлено в: v1.17#

      Включать ли исходные файлы для действий трассировки. Список каталогов с исходным кодом приложения должен быть предоставлен через переменную окружения PLAYWRIGHT_JAVA_SRC (пути должны быть разделены ';' на Windows и ':' на других платформах).

    • setTitle String (опционально) Добавлено в: v1.17#

      Имя трассировки, отображаемое в Trace Viewer.

Возвращает

startChunk​

Добавлено в: v1.15 tracing.startChunk

Начать новый фрагмент трассировки. Если вы хотите записать несколько трассировок в одном BrowserContext, используйте Tracing.start() один раз, а затем создайте несколько фрагментов трассировки с помощью Tracing.startChunk() и Tracing.stopChunk().

Использование

context.tracing().start(new Tracing.StartOptions()
  .setScreenshots(true)
  .setSnapshots(true));
Page page = context.newPage();
page.navigate("https://playwright.dev");

context.tracing().startChunk();
page.getByText("Get Started").click();
// Все между startChunk и stopChunk будет записано в трассировку.
context.tracing().stopChunk(new Tracing.StopChunkOptions()
  .setPath(Paths.get("trace1.zip")));

context.tracing().startChunk();
page.navigate("http://example.com");
// Сохраните второй файл трассировки с другими действиями.
context.tracing().stopChunk(new Tracing.StopChunkOptions()
  .setPath(Paths.get("trace2.zip")));

Аргументы

  • options Tracing.StartChunkOptions (опционально)

    • setName String (опционально) Добавлено в: v1.32#

      Если указано, промежуточные файлы трассировки будут сохранены в файлы с заданным префиксом имени внутри каталога, указанного в setTracesDir, указанного в BrowserType.launch(). Чтобы указать имя конечного zip-файла трассировки, необходимо передать опцию path в Tracing.stopChunk().

    • setTitle String (опционально) Добавлено в: v1.17#

      Имя трассировки, отображаемое в Trace Viewer.

Возвращает

stop​

Добавлено в: v1.12 tracing.stop

Остановить трассировку.

Использование

Tracing.stop();
Tracing.stop(options);

Аргументы

  • options Tracing.StopOptions (опционально)

    • setPath Path (опционально)#

      Экспортировать трассировку в файл с указанным путем.

Возвращает

stopChunk​

Добавлено в: v1.15 tracing.stopChunk

Остановить фрагмент трассировки. См. Tracing.startChunk() для получения более подробной информации о нескольких фрагментах трассировки.

Использование

Tracing.stopChunk();
Tracing.stopChunk(options);

Аргументы

  • options Tracing.StopChunkOptions (опционально)

    • setPath Path (опционально)#

      Экспортировать трассировку, собранную с момента последнего вызова Tracing.startChunk(), в файл с указанным путем.

Возвращает