跳到主要内容

追踪查看器

简介​

Playwright Trace Viewer 是一个 GUI 工具，它允许你浏览已记录的测试轨迹，这意味着你可以前后浏览测试的每个操作，并直观地查看每个操作期间发生的情况。

你将学习

记录轨迹​

默认情况下，playwright.config 文件会包含创建每个测试的 trace.zip 文件所需的配置。轨迹设置为在首次重试时运行 (on-first-retry)，这意味着它们会在测试首次失败重试时运行。同时在 CI 环境下 retries 设置为 2，本地运行时为 0。这意味着轨迹会在测试首次失败重试时记录，但不会在首次运行或第二次重试时记录。

playwright.config.ts
import { defineConfig } from '@playwright/test';
export default defineConfig({
  retries: process.env.CI ? 2 : 0, // 在 CI 环境下设置为 2
  // ...
  use: {
    trace: 'on-first-retry', // 在每个测试首次重试时记录轨迹
  },
});

要了解更多关于记录轨迹的可用选项，请查看我们的详细指南 Trace Viewer。

轨迹通常在持续集成(CI)环境中运行，因为在本地你可以使用 UI 模式来开发和调试测试。但是，如果你想在本地运行轨迹而不使用 UI 模式，可以通过 --trace on 强制开启轨迹记录。

npx playwright test --trace on

打开 HTML 报告​

HTML 报告展示了所有已运行测试的概况，包括在哪些浏览器上运行以及耗时情况。可以按通过、失败、不稳定或跳过的测试进行筛选。您还可以搜索特定测试。点击测试将打开详细视图，查看更多信息，如错误详情、测试步骤和追踪记录。

npx playwright show-report

打开追踪记录​

在 HTML 报告中点击测试名称旁边的追踪图标，可直接打开对应测试的追踪记录。

playwright html 报告

您也可以点击进入测试的详细视图，向下滚动至 '追踪记录' 标签页，通过点击追踪截图来打开记录。

playwright html 报告详细视图

要了解更多关于报告器的信息，请参阅我们详细的报告器指南，包括 HTML 报告器。

查看追踪记录​

通过逐项点击操作或使用时间轴悬停来查看测试的追踪记录，观察操作前后页面状态的变化。在测试的每个步骤中检查日志、源代码、网络请求、错误和控制台输出。追踪查看器会创建 DOM 快照，您可以完全与之交互，并打开浏览器开发者工具来检查 HTML、CSS 等。

playwright 追踪查看器

要了解更多关于追踪记录的信息，请参阅我们详细的 追踪查看器 指南。

下一步​