自动化测试 / 系统课时
保存截图与视频
保存截图与视频
测试失败时,单靠终端错误往往看不到页面当时长什么样,也无法判断重试是否走了不同路径。本课用 Playwright Test 的内置产物策略,在失败时自动保留截图,并在首次重试时录制视频,让问题现场随测试结果一起保存。
学习目标
- 配置失败截图和首次重试视频
- 验证失败、重试与产物保留之间的对应关系
- 区分自动诊断产物与手工截图的使用场景
配置产物策略
在 playwright.config.ts 中统一设置产物,比在每个测试里手写截图逻辑更稳定。下面配置只对失败运行保存截图,并仅为第一次重试录制视频:
import { defineConfig } from '@playwright/test';
export default defineConfig({
retries: 1,
outputDir: 'test-results',
use: {
screenshot: 'only-on-failure',
video: 'on-first-retry',
},
});screenshot: 'only-on-failure' 会在失败运行结束时保留页面截图;video: 'on-first-retry' 只录制第一次重试,因此不会为所有成功测试持续生成录像。两类产物都会进入测试输出目录,具体子目录由测试名称、项目和运行结果决定。
制造一次可验证的重试
下面的测试第一次运行故意失败,重试时改为正确断言。这样可以同时观察“首次失败截图”和“首次重试视频”的生成行为:
import { test, expect } from '@playwright/test';
test('artifact demo', async ({ page }, testInfo) => {
await page.setContent('<button type="button">Submit</button>');
// 首次运行制造失败;retry 为 1 时验证真实文本。
const expectedText = testInfo.retry === 0 ? 'Done' : 'Submit';
await expect(page.getByRole('button')).toHaveText(expectedText);
});执行测试:
npx playwright test tests/artifact-demo.spec.ts --reporter=line预期输出末尾会把“首次失败、重试通过”的测试归类为 flaky;耗时和路径可能不同:
1 flaky此时 test-results 中应能找到首次失败对应的 PNG 截图,以及第一次重试对应的 WebM 视频。实际文件路径可能类似 <PATH>/test-failed-1.png 和 <PATH>/video.webm,应以本机生成结果为准。
选择截图还是视频
截图适合回答“失败那一刻页面是什么状态”,成本低、打开快,特别适合元素缺失、遮挡、文本错误和布局异常。视频适合回答“页面是怎样一步步走到失败或成功的”,对动画、跳转、拖拽、异步加载和偶发重试更有价值。
如果需要记录某个业务检查点,而不是等待失败后自动截图,可以在测试代码中调用 page.screenshot();这类手工截图应只用于真正需要长期保留的关键状态,避免和自动失败截图重复。
验收与清理边界
先确认失败截图对应的是失败的那一次运行,再确认视频对应的是第一次重试。如果测试没有发生重试,on-first-retry 不会产生视频;如果运行没有失败,only-on-failure 也不会保留截图,这不是配置失效。
产物通常只服务于当前测试运行,不应把 test-results 当成永久档案。CI 中应按排障窗口设置构件保留期;页面可能包含账号、订单、令牌或用户数据时,还要在录制前完成脱敏或避免进入敏感页面。稳定性治理的目标是留下足够证据,而不是无条件保存所有像素和每一秒录像。