E2E 测试工作流：Playwright 关键旅程与产物管理

端到端（E2E）测试的价值不在“覆盖率数字”，而在于它能把关键用户旅程跑通，并在失败时产出可追溯证据（截图/录像/trace）。一个可复用的落地框架可以概括为三件事：旅程清单、稳定性、产物管理。

什么时候必须上 E2E

推荐至少覆盖以下“高风险旅程”：

e2e-runner 提供了 POM 的示例结构（节选），关键点是把“定位器与操作”收敛到页面对象里，避免测试文件里到处写 locator：

export class MarketsPage {
  async goto() {
    await this.page.goto('/markets')
    await this.page.waitForLoadState('networkidle')
  }
}

e2e-runner 对 flaky 的典型原因与修法是：

示例（节选）：

await page.waitForResponse(resp => resp.url().includes('/api/markets'))

e2e-runner 建议在失败时保留：

这能显著降低“CI 红了但不知道为什么”的排障成本。

e2e-runner 给出了两种隔离方式（节选）：

test.fixme(true, 'Test is flaky - Issue #123')

或在 CI 环境跳过：

test.skip(process.env.CI, 'Test is flaky in CI - Issue #123')

无