视频教程

简介

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

录制视频

Playwright Test 可以为您的测试录制视频，通过 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',
  },
});

库

const context = await browser.newContext({ recordVideo: { dir: 'videos/' } });
// 确保等待 close，以便保存视频
await context.close();

您还可以指定视频尺寸。默认情况下视频尺寸会缩放到适合 800x800 的视口大小。视口视频会放置在输出视频的左上角，必要时会进行缩放。您可能需要设置视口大小以匹配所需的视频尺寸。

测试

playwright.config.ts

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

库

const context = await browser.newContext({
  recordVideo: {
    dir: 'videos/',
    size: { width: 640, height: 480 },
  }
});

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

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

备注

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