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

トレースビューアー

はじめに

Playwright トレースビューアーは、記録された Playwright テストのトレースを探索できる GUI ツールです。これにより、テストの各アクションを前後に移動し、各アクション中に何が起こっていたかを視覚的に確認できます。

学習内容

  • トレースの記録方法
  • トレースビューアーの開き方

トレースの記録

トレースは、BrowserContext.tracing() API を使用して次のように記録できます。

Browser browser = browserType.launch();
BrowserContext context = browser.newContext();

// Start tracing before creating / navigating a page.
context.tracing().start(new Tracing.StartOptions()
.setScreenshots(true)
.setSnapshots(true)
.setSources(true));

Page page = context.newPage();
page.navigate("https://playwright.dokyumento.jp");

// Stop tracing and export it into a zip archive.
context.tracing().stop(new Tracing.StopOptions()
.setPath(Paths.get("trace.zip")));

これによりトレースが記録され、trace.zip という名前のファイルに保存されます。

トレースを開く

保存されたトレースは、Playwright CLI を使用するか、ブラウザで trace.playwright.dev から開くことができます。トレースの zip ファイルが保存されている場所への完全なパスを追加してください。開くと、各アクションをクリックするか、タイムラインを使用して、各アクションの前後でのページのステータスを確認できます。また、テストの各ステップでログ、ソース、ネットワークを検査できます。トレースビューアーは DOM スナップショットを作成するため、完全に操作したり、devtools を開いたりできます。

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="show-trace trace.zip"

playwright trace viewer

詳細については、トレースビューアーに関する詳細ガイドをご覧ください。

次のステップ