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

トレースビューアー

はじめに​

Playwright Trace Viewerは、テストで記録された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

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

次にすること​