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

トレースビューアー

はじめに

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

学習内容

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

トレースの記録

トレースは、テストを--tracingフラグ付きで実行することにより記録できます。

pytest --tracing on

トレースのオプション:

  • on: 各テストのトレースを記録する
  • off: トレースを記録しない。(デフォルト)
  • retain-on-failure: 各テストのトレースを記録するが、成功したテスト実行からのすべてのトレースは削除する。

これによりトレースが記録され、test-resultsディレクトリ内のtrace.zipというファイルに保存されます。

Pytestを使用していない場合は、こちらをクリックしてトレースの記録方法を学習してください。
browser = chromium.launch()
context = browser.new_context()

# Start tracing before creating / navigating a page.
context.tracing.start(screenshots=True, snapshots=True, sources=True)

page = context.new_page()
page.goto("https://playwright.dokyumento.jp")

# Stop tracing and export it into a zip archive.
context.tracing.stop(path = "trace.zip")

トレースを開く

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

playwright show-trace trace.zip

playwright trace viewer

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

次のステップ