Видео
Введение
С помощью Playwright можно записывать видео для тестов.
Запись видео
Playwright Test может записывать видео для тестов. Эта возможность управляется параметром video в конфигурации Playwright. По умолчанию запись видео отключена.
-
'off'— не записывать видео. -
'on'— записывать видео для каждого теста. -
'retain-on-failure'— записывать видео для каждого теста, но удалять все видео после успешного выполнения тестов. -
'on-first-retry'— записывать видео только при первой повторной попытке выполнить тест.
Видеофайлы появятся в каталоге вывода тестов, обычно в test-results. Дополнительные параметры настройки видео см. в разделе testOptions.video.
Видео сохраняются при закрытии контекста браузера в конце теста. Если вы создаёте контекст браузера вручную, обязательно дождитесь выполнения browserContext.close().
- Тест
- Библиотека
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
video: 'on-first-retry',
},
});const context = await browser.newContext({ recordVideo: { dir: 'videos/' } });
// Make sure to await close, so that videos are saved.
await context.close();Также можно указать размер видео и добавить аннотации. По умолчанию размер видео соответствует размеру области просмотра, уменьшенному так, чтобы видео помещалось в область 800x800. Видео области просмотра размещается в левом верхнем углу выходного видео и при необходимости уменьшается, чтобы поместиться. Возможно, потребуется задать размер области просмотра в соответствии с желаемым размером видео.
Если указан параметр show: { actions }, каждое действие будет визуально выделено на видео контуром элемента и подзаголовком с названием действия. Необязательное свойство duration задаёт длительность отображения каждой аннотации (по умолчанию — 500мс).
Если указан параметр show: { test }, на видео будут добавлены сведения о текущем тесте с настраиваемым параметром level.
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
video: {
mode: 'on-first-retry',
size: { width: 640, height: 480 },
show: {
actions: {
duration: 500,
position: 'top-right',
fontSize: 14,
},
test: {
level: 'step',
position: 'top-left',
fontSize: 12,
}
},
},
},
}); В сценариях с несколькими страницами получить связанный со страницей видеофайл можно с помощью метода page.video().
const path = await page.video().path();
ПримечаниеОбратите внимание: видео доступно только после закрытия страницы или контекста браузера.
© 2026 Microsoft
Licensed under the Apache License, Version 2.0.
https://playwright.dev/docs/videos