跳到主要内容

视频

简介

使用 Playwright,你可以为测试录制视频。

录制视频

Playwright 测试可以通过 Playwright 配置中的 video 选项来录制测试视频。默认情况下,视频功能是关闭的。

  • 'off' - 不录制视频。
  • 'on' - 为每个测试录制视频。
  • 'retain-on-failure' - 为每个测试录制视频,但移除成功测试运行的视频。
  • 'on-first-retry' - 仅在第一次重试测试时录制视频。

视频文件将出现在测试输出目录中,通常是 test-results。有关高级视频配置,请参阅 testOptions.video

视频在测试结束时 浏览器上下文 关闭时保存。如果你手动创建浏览器上下文,请确保 await browserContext.close()

playwright.config.ts
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
video: 'on-first-retry',
},
});

你也可以指定视频大小。视频大小默认为按比例缩小以适应 800x800 的视口大小。视口视频被放置在输出视频的左上角,如有必要会按比例缩小以适应。你可能需要设置视口大小以匹配你期望的视频大小。

playwright.config.ts
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
video: {
mode: 'on-first-retry',
size: { width: 640, height: 480 }
}
},
});

对于多页面场景,你可以通过 page.video() 访问与页面关联的视频文件。

const path = await page.video().path();
note

请注意,视频仅在页面或浏览器上下文关闭后可用。