トレースビューアー
はじめに
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")
browser = await chromium.launch()
context = await browser.new_context()
# Start tracing before creating / navigating a page.
await context.tracing.start(screenshots=True, snapshots=True, sources=True)
page = await context.new_page()
await page.goto("https://playwright.dokyumento.jp")
# Stop tracing and export it into a zip archive.
await context.tracing.stop(path = "trace.zip")
トレースを開く
保存されたトレースは、Playwright CLIを使用するか、ブラウザでtrace.playwright.dev
にアクセスして開くことができます。トレースのzipファイルが置かれている場所への完全なパスを追加してください。開くと、各アクションをクリックしたり、タイムラインを使用して各アクション前後のページの状態を確認できます。また、テストの各ステップ中にログ、ソース、ネットワークを検査することもできます。トレースビューアーはDOMスナップショットを作成するため、完全に操作したり、開発者ツールを開いたりすることができます。
playwright show-trace trace.zip
詳細については、トレースビューアーに関する詳細ガイドをご覧ください。