跳至主要内容

视频

介绍

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

录制视频

Playwright 测试可以为您的测试录制视频,由 Playwright 配置中的 video 选项控制。默认情况下,视频处于关闭状态。

  • 'off' - 不录制视频。
  • 'on' - 为每个测试录制视频。
  • 'retain-on-failure' - 为每个测试录制视频,但从成功的测试运行中删除所有视频。
  • 'on-first-retry' - 仅在首次重试测试时录制视频。

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

视频在测试结束时 浏览器上下文 关闭时保存。如果您手动创建浏览器上下文,请确保等待 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();
注意

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