目录
介绍
Playwright Trace Viewer 是一个图形用户界面(GUI)工具,它允许您探索已录制的 Playwright 测试跟踪。这意味着您可以回溯和前进您的测试中的每一个动作,并直观地看到每个动作期间发生了什么。
您将学习
- 如何录制跟踪(Trace):了解如何在使用 Playwright 进行测试时录制跟踪,以便后续分析和调试。
- 如何打开跟踪查看器(Trace Viewer):学习如何启动和使用跟踪查看器来浏览和分析已录制的跟踪数据。
录制跟踪(Trace)
跟踪(Trace)可以通过在运行测试时添加 --tracing
标志来录制。
对于 pytest,你可以使用以下命令来开启跟踪录制:
pytest --tracing on
跟踪录制的选项包括:
on
:为每个测试录制跟踪。off
:不录制跟踪。(默认选项)retain-on-failure
:为每个测试录制跟踪,但仅保留失败测试运行的跟踪。
这将会录制跟踪并将其保存在您的 test-results
目录下的 trace.zip
文件中。
如果您没有使用 pytest,
# Sync
browser = chromium.launch()
context = browser.new_context()
# 在创建或导航到页面之前开始跟踪录制
# 可以设置screenshots=True来录制屏幕截图,snapshots=True来录制页面快照,sources=True来录制源代码
context.tracing.start(screenshots=True, snapshots=True, sources=True)
page = context.new_page()
page.goto("https://playwright.dev")
# Stop tracing and export it into a zip archive.
context.tracing.stop(path = "trace.zip")
或
# Async
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.dev")
# Stop tracing and export it into a zip archive.
await context.tracing.stop(path = "trace.zip")
打开跟踪(Trace)
您可以使用 Playwright CLI 或在浏览器上访问 trace.playwright.dev 来打开保存的跟踪文件。请确保添加跟踪 zip 文件所在位置的完整路径。一旦打开,您可以点击每个动作或使用时间线来查看每个动作前后页面的状态。您还可以在测试的每个步骤中检查日志、源代码和网络请求。跟踪查看器会创建一个 DOM 快照,因此您可以完全与之交互,打开开发者工具等。
使用 Playwright CLI 打开跟踪文件的命令如下:
playwright show-trace trace.zip
要了解更多信息,请查看我们关于跟踪查看器 Trace Viewer的详细指南。