Vue / 系统课时

端到端关键流程测试

端到端关键流程测试

端到端测试的价值不是覆盖每个按钮,而是证明用户最关键的业务链路在真实浏览器中可以走通。本节用 Playwright 串起登录、查询、编辑和权限拒绝四类场景,并通过稳定定位器、明确断言和失败证据,让测试既能发现回归,也能长期维护。

学习目标

  • 用 Playwright 组织登录、查询、编辑和权限测试。
  • 使用稳定定位器和面向用户结果的断言降低脆弱性。
  • 配置运行、重试与失败证据,并能判断 E2E 失败位于哪一层。

先定义关键流程而不是页面清单

一条高价值 E2E 用例应从用户目标出发。管理员流程可以是“登录 → 查询用户 → 编辑角色 → 保存成功”,普通成员则验证“打开同一编辑入口 → 被拒绝”。这样能同时覆盖路由、表单、接口联动和权限控制,又不会把所有页面都做成冗长脚本。

登录查询编辑与权限测试流程

配置 Playwright 的运行基线

配置文件只负责环境级规则。示例把基础地址放进环境变量,CI 中开启重试,并仅在失败时保留截图和 Trace,避免正常运行产生大量无用文件。

ts
// playwright.config.ts
import { defineConfig } from '@playwright/test'

export default defineConfig({
  testDir: './e2e',
  fullyParallel: true,
  retries: process.env.CI ? 2 : 0,
  use: {
    baseURL: process.env.BASE_URL ?? 'http://127.0.0.1:4173',
    screenshot: 'only-on-failure',
    trace: 'retain-on-failure',
  },
})

配置生效后,可先启动被测应用,再执行测试。若项目端口不同,通过 BASE_URL 覆盖;其中 <PORT> 替换为实际监听端口。

bash
BASE_URL=http://127.0.0.1:<PORT> npx playwright test

预期输出:

text
Running 2 tests using <VALUE> workers
2 passed (<TIME>)

<VALUE> 与 <TIME> 由机器并发度和实际执行耗时决定。

编写管理员主流程和权限分支

下面使用 getByRole、getByLabel 和可见文本定位元素,避免依赖容易变化的 CSS 层级。示例假设测试环境已准备两个稳定账号,并通过环境变量注入凭据。

ts
// e2e/user-management.spec.ts
import { expect, test } from '@playwright/test'

async function login(
  page: import('@playwright/test').Page,
  email: string,
  password: string,
) {
  await page.goto('/login')
  await page.getByLabel('邮箱').fill(email)
  await page.getByLabel('密码').fill(password)
  await page.getByRole('button', { name: '登录' }).click()
  await expect(page).toHaveURL(/\/dashboard$/)
}

test('管理员可以查询并编辑用户角色', async ({ page }) => {
  await login(
    page,
    process.env.E2E_ADMIN_EMAIL ?? 'admin@example.test',
    process.env.E2E_ADMIN_PASSWORD ?? 'admin-pass',
  )

  await page.goto('/users')
  await page.getByRole('searchbox', { name: '搜索用户' }).fill('Ada')
  await page.getByRole('button', { name: '查询' }).click()

  const row = page.getByRole('row', { name: /Ada/ })
  await expect(row).toBeVisible()
  await row.getByRole('button', { name: '编辑' }).click()

  await page.getByLabel('角色').selectOption('manager')
  await page.getByRole('button', { name: '保存' }).click()
  await expect(page.getByText('保存成功')).toBeVisible()
})

test('普通成员不能进入用户编辑页', async ({ page }) => {
  await login(
    page,
    process.env.E2E_MEMBER_EMAIL ?? 'member@example.test',
    process.env.E2E_MEMBER_PASSWORD ?? 'member-pass',
  )

  await page.goto('/users/7/edit')
  await expect(page.getByText('无权访问')).toBeVisible()
  await expect(page).toHaveURL(/\/forbidden$/)
})

运行这一文件:

bash
npx playwright test e2e/user-management.spec.ts

预期输出:

text
Running 2 tests using <VALUE> workers
✓ 管理员可以查询并编辑用户角色
✓ 普通成员不能进入用户编辑页
2 passed (<TIME>)

测试名称、并发 worker 数和耗时会随环境变化,但两个关键场景都应通过。

让断言观察用户结果

E2E 最常见的脆弱点是“点完就算成功”。点击保存后,应等待用户能观察到的完成信号,例如成功提示、目标 URL、更新后的表格内容;权限测试则同时验证提示和最终路由。这样失败时可以直接判断业务结果没有成立,而不是只知道某次点击发生过。

把失败证据留给排查

E2E 失败可能来自前端、后端、测试数据、权限配置或浏览器环境。配置中的失败截图和 Trace 能还原页面状态与操作顺序;若只在 CI 失败,应先查看 Trace,再确认测试账号、数据初始化和应用地址,而不是立即增加等待时间。

关键流程测试数量应保持克制:单元测试负责大量分支,组件测试负责交互细节,E2E 只守住真正影响发布的用户路径。这样既能在发布前发现“系统整体走不通”的问题,也不会让测试套件因页面细节变化而频繁失效。

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

目录与阅读设置

阅读设置

17

记录一个想法

端到端关键流程测试

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

登录哪都通