自动化测试 / 系统课时

保存截图与视频

保存截图与视频

测试失败时,单靠终端错误往往看不到页面当时长什么样,也无法判断重试是否走了不同路径。本课用 Playwright Test 的内置产物策略,在失败时自动保留截图,并在首次重试时录制视频,让问题现场随测试结果一起保存。

学习目标

  • 配置失败截图和首次重试视频
  • 验证失败、重试与产物保留之间的对应关系
  • 区分自动诊断产物与手工截图的使用场景

配置产物策略

在 playwright.config.ts 中统一设置产物,比在每个测试里手写截图逻辑更稳定。下面配置只对失败运行保存截图,并仅为第一次重试录制视频:

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' 只录制第一次重试,因此不会为所有成功测试持续生成录像。两类产物都会进入测试输出目录,具体子目录由测试名称、项目和运行结果决定。

制造一次可验证的重试

下面的测试第一次运行故意失败,重试时改为正确断言。这样可以同时观察“首次失败截图”和“首次重试视频”的生成行为:

ts
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);
});

执行测试:

bash
npx playwright test tests/artifact-demo.spec.ts --reporter=line

预期输出末尾会把“首次失败、重试通过”的测试归类为 flaky;耗时和路径可能不同:

text
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 中应按排障窗口设置构件保留期;页面可能包含账号、订单、令牌或用户数据时,还要在录制前完成脱敏或避免进入敏感页面。稳定性治理的目标是留下足够证据,而不是无条件保存所有像素和每一秒录像。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

保存截图与视频

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通