メインコンテンツにスキップ

動画

はじめに

Playwright を使用すると、テスト用にビデオを記録できます。

ビデオの記録

Playwright Test は、Playwright の設定ファイルにある video オプションで制御して、テストのビデオを録画できます。デフォルトでは、ビデオ録画はオフです。

  • 'off' - ビデオを録画しない。
  • 'on' - 各テストのビデオを録画する。
  • 'retain-on-failure' - 各テストのビデオを録画するが、成功したテスト実行のすべてのビデオを削除する。
  • 'on-first-retry' - テストを初めて再試行するときのみビデオを録画する。

ビデオファイルは、通常 test-results であるテスト出力ディレクトリに表示されます。高度なビデオ設定については、testOptions.video を参照してください。

ビデオは、テストの最後にブラウザコンテキストが閉じるときに保存されます。ブラウザコンテキストを手動で作成する場合は、browserContext.close() を await するようにしてください。

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();

ビデオは、ページまたはブラウザコンテキストが閉じられた後にのみ利用可能になることに注意してください。