React / 系统课时

编写端到端测试

编写端到端测试

端到端测试要验证的不是某个函数,而是用户能否在真实浏览器里走完整条业务链路。本节用 Playwright 覆盖登录、表单提交和结果确认,并把稳定选择器、测试数据与失败证据一起纳入设计。

学习目标

  • 使用 Playwright 驱动 Next.js 应用完成真实浏览器操作
  • 把登录、表单提交和业务结果串成一条可验证的关键路径
  • 用可访问性选择器、断言和 Trace 降低端到端测试的脆弱性

准备测试环境

端到端测试应运行在独立测试环境,不要直接操作生产数据。下面安装 Playwright 测试框架和 Chromium;如果项目已经安装,可直接检查版本。

bash
npm install -D @playwright/test && npx playwright install chromium && npx playwright --version

预期输出的最后一行类似:

text
Version <VALUE>

<VALUE> 会随安装版本变化。接着在项目根目录创建 playwright.config.ts,让 Playwright 自动启动 Next.js 开发服务器,并在首次重试时保留 Trace。

ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  testDir: './tests/e2e',
  use: {
    baseURL: 'http://127.0.0.1:3000',
    trace: 'on-first-retry',
  },
  webServer: {
    command: 'npm run dev',
    url: 'http://127.0.0.1:3000',
    reuseExistingServer: !process.env.CI,
  },
});

这段配置本身不会产生业务输出。验证方法是执行测试时确认 Playwright 能自动拉起应用,测试结束后再关闭由它启动的服务器。

编写核心业务流程

下面的片段示例假设应用存在 /login、/orders/new 和 /orders 三个页面,并且测试环境准备了专用账号。选择器优先使用输入框标签、按钮角色和状态提示,而不是依赖容易变化的 CSS 类名。

ts
import { expect, test } from '@playwright/test';

test('登录后提交订单并在列表中看到结果', async ({ page }) => {
  const itemName = `E2E-${Date.now()}`;

  await page.goto('/login');
  await page.getByLabel('邮箱').fill('e2e@example.com');
  await page.getByLabel('密码').fill('Test123456!');
  await page.getByRole('button', { name: '登录' }).click();
  await expect(page).toHaveURL(/\/orders$/);

  await page.goto('/orders/new');
  await page.getByLabel('商品名称').fill(itemName);
  await page.getByLabel('数量').fill('2');
  await page.getByRole('button', { name: '提交订单' }).click();

  await expect(page.getByRole('alert')).toContainText('订单已创建');
  await page.goto('/orders');
  await expect(page.getByText(itemName)).toBeVisible();
});

这个测试同时验证三件事:认证成功后发生正确跳转、表单提交出现成功反馈、最终业务列表真的包含新记录。最后一条断言尤其重要,因为它能避免只验证“按钮点到了”,却没有确认业务状态真正落地。

运行并验证结果

在项目根目录执行测试。测试账号、测试数据库和外部依赖应提前固定,避免结果依赖生产环境或随机第三方服务。

bash
npx playwright test

预期输出类似:

text
Running 1 test using 1 worker
1 passed (<TIME>)

<TIME> 取决于机器和应用启动速度。如果失败,先用 npx playwright show-report 查看报告;若启用了 Trace,可从失败测试中检查跳转、网络请求、DOM 快照和控制台信息,再判断问题来自页面、接口还是测试本身。

让测试保持稳定

端到端测试最常见的问题不是“不会写”,而是长期维护后变得不稳定。测试数据应由测试环境创建或重置,账号必须专用;选择器优先依赖可访问性语义;断言等待用户真正可见的结果,不要用固定睡眠时间代替条件等待。

登录如果会被大量测试复用,可以进一步把认证状态保存为 Playwright storage state,避免每个用例都重复登录。但关键登录流程本身仍应保留至少一条完整测试,否则认证页面即使损坏,其他复用登录态的用例也可能继续通过。

一条高价值端到端测试应该覆盖“用户动作—系统反馈—最终业务结果”完整闭环。只要这三层都被断言,登录、表单和核心流程就不再是彼此孤立的页面检查,而是真正能阻止回归进入发布流程的质量门槛。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写端到端测试

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

登录哪都通