Skip to main content

錄影

簡介​

使用 Playwright，你可以錄製測試的影片。

錄製影片​

Playwright Test 可以為您的測試錄製影片, 由 Playwright 配置中的 video 選項控制。預設情況下影片是關閉的。

  • 'off' - 不錄製 影片。
  • 'on' - 為每個測試錄製 影片。
  • 'retain-on-failure' - 為每個測試錄製 影片，但移除所有成功測試執行的 影片。
  • 'on-first-retry' - 僅在第一次重試測試時錄製 影片。

影片檔案將出現在測試輸出目錄中，通常是 test-results。請參閱 testOptions.video 以進行高級影片配置。

影片會在測試結束時於 browser context 關閉時儲存。如果你手動建立一個 browser context，請確保等待 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

請注意，影片僅在頁面或瀏覽器上下文關閉後可用。