自动化测试 / 系统课时
生成 HTML 测试报告
生成 HTML 测试报告
HTML 报告把一次 Playwright 测试运行整理成可浏览的结果页,适合从失败用例继续查看错误栈、执行耗时和测试附件。本篇会完成 Reporter 配置、报告生成与打开,并说明如何从报告中快速找到真正有用的失败证据。
学习目标
- 配置并生成 Playwright HTML 测试报告
- 从报告中查看用例状态、耗时、错误信息和附件
- 知道报告目录该如何保存,以及失败时先检查哪些证据
配置 HTML Reporter
推荐把 Reporter 写入 playwright.config.ts,这样本地和 CI 使用同一套报告策略。下面把报告固定输出到 test-report,并关闭执行结束后的自动打开;同时只在失败时保留截图,方便报告中直接查看页面现场。
import { defineConfig } from '@playwright/test';
export default defineConfig({
reporter: [['html', { outputFolder: 'test-report', open: 'never' }]],
use: {
screenshot: 'only-on-failure',
},
});配置生效后,每次 npx playwright test 都会重新生成该目录中的 HTML 报告。截图只有在用例失败且确实产生截图附件时才会出现在详情中,因此不要把“没有附件”误判成 Reporter 失效。
生成并打开报告
在项目根目录执行测试,再使用 show-report 启动本地报告服务。即使用例失败,HTML 报告仍可用于分析;如果第一条命令返回非零退出码,继续单独执行第二条命令即可。
npx playwright test
npx playwright show-report test-report预期结果:
test-report/index.html 被生成。
HTML 报告随后通过 http://localhost:<PORT> 提供访问。<PORT> 是实际监听端口,可能因端口占用而变化。报告目录中的文件是一次测试运行的产物,CI 场景应把整个目录作为构建产物保存,而不是只保留 index.html。
读懂失败详情
打开报告后,先按失败状态筛选,再进入具体用例。总览适合判断失败集中在哪个项目或测试文件;用例详情则用于回答三个问题:失败发生在哪个断言或动作、执行到这里用了多久、失败现场是否留下截图或其他附件。
错误信息回答“哪里失败”,附件回答“失败时页面是什么状态”,耗时则帮助发现异常慢步骤。若报告里只有最终错误而缺少足够现场,应回到测试配置补充截图、trace 或业务日志,而不是仅靠重跑猜测原因。
保存报告时注意什么
HTML 报告适合人工分析,但它本质上是测试产物而不是源代码。不要把每次运行生成的 test-report 长期提交到 Git;在 CI 中应按流水线保留策略上传产物,并确保报告与对应的提交、浏览器项目和测试运行能够对应起来。
如果报告中的失败证据已经足够定位问题,就直接修复测试或应用并重新运行验证;如果同一用例时而通过、时而失败,则需要进一步按等待条件、共享状态、并发竞争和环境波动的顺序分析偶发失败。