Skip to main content

Tracing

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

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

const browser = await chromium.launch();
const context = await browser.newContext();
await context.tracing.start({ screenshots: true, snapshots: true });
const page = await context.newPage();
await page.goto('https://playwright.dev');
await context.tracing.stop({ path: 'trace.zip' });

Методы​

group​

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

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

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

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

// используйте test.step вместо этого
await test.step('Log in', async () => {
  // ...
});

Аргументы

  • name [string]#

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

  • options [Object] (опционально)

    • location [Object] (опционально)#

      • file [string]

      • line [number] (опционально)

      • column [number] (опционально)

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

Возвращает

  • [Promise]<[void]>#

groupEnd​

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

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

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

await tracing.groupEnd();

Возвращает

  • [Promise]<[void]>#

start​

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

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

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

await context.tracing.start({ screenshots: true, snapshots: true });
const page = await context.newPage();
await page.goto('https://playwright.dev');
await context.tracing.stop({ path: 'trace.zip' });

Аргументы

  • options [Object] (опционально)

    • name [string] (опционально)#

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

    • screenshots [boolean] (опционально)#

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

    • snapshots [boolean] (опционально)#

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

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

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

      Включать ли исходные файлы для действий трассировки.

    • title [string] (опционально) Добавлено в: v1.17#

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

Возвращает

  • [Promise]<[void]>#

startChunk​

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

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

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

await context.tracing.start({ screenshots: true, snapshots: true });
const page = await context.newPage();
await page.goto('https://playwright.dev');

await context.tracing.startChunk();
await page.getByText('Get Started').click();
// Все между startChunk и stopChunk будет записано в трассировку.
await context.tracing.stopChunk({ path: 'trace1.zip' });

await context.tracing.startChunk();
await page.goto('http://example.com');
// Сохраните второй файл трассировки с другими действиями.
await context.tracing.stopChunk({ path: 'trace2.zip' });

Аргументы

  • options [Object] (опционально)

    • name [string] (опционально) Добавлено в: v1.32#

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

    • title [string] (опционально) Добавлено в: v1.17#

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

Возвращает

  • [Promise]<[void]>#

stop​

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

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

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

await tracing.stop();
await tracing.stop(options);

Аргументы

  • options [Object] (опционально)

    • path [string] (опционально)#

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

Возвращает

  • [Promise]<[void]>#

stopChunk​

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

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

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

await tracing.stopChunk();
await tracing.stopChunk(options);

Аргументы

  • options [Object] (опционально)

    • path [string] (опционально)#

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

Возвращает

  • [Promise]<[void]>#