Отслеживание

API для сбора и сохранения отслеживания Playwright. Отслеживание Playwright можно открыть в Просмотр отслеживания после выполнения скрипта 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​

осторожно

Используйте test.step вместо, если это возможно.

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

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

// use test.step instead
await test.step('Log in', async () => {
  // ...
});

Аргументы

• name строка

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

• options Объект (необязательно)

  • location Объект (необязательно)

    • file строка

    • line число (необязательно)

    • column число (необязательно)

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

Возвращает

• Promise<void>

groupEnd​

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

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

await tracing.groupEnd();

Возвращает

• Promise<void>

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 Объект (необязательно)

  • name строка (необязательно)

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

  • screenshots логическое значение (необязательно)

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

  • snapshots логическое значение (необязательно)

    Если это значение true, отслеживание будет

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

  • sources логическое значение (необязательно)

    Указывает, нужно ли включать исходные файлы для действий отслеживания.

  • title строка (необязательно)

    Имя отслеживания, которое будет отображаться в просмотре отслеживания.

Возвращает

• Promise<void>

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();
// Everything between startChunk and stopChunk will be recorded in the trace.
await context.tracing.stopChunk({ path: 'trace1.zip' });

await context.tracing.startChunk();
await page.goto('http://example.com');
// Save a second trace file with different actions.
await context.tracing.stopChunk({ path: 'trace2.zip' });

Аргументы

• options Объект (необязательно)

  • name строка (необязательно)

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

  • title строка (необязательно)

    Имя отслеживания, которое будет отображаться в просмотре отслеживания.

Возвращает

• Promise<void>

stop​

Остановить отслеживание.

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

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

Аргументы

• options Объект (необязательно)

  • path строка (необязательно)

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

Возвращает

• Promise<void>

stopChunk​

Остановить фрагмент отслеживания. Подробнее см. tracing.startChunk() для информации о нескольких фрагментах отслеживания.

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

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

Аргументы

• options Объект (необязательно)

  • path строка (необязательно)

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

Возвращает

• Promise<void>