自动化测试 / 系统课时
设计核心业务用例
设计核心业务用例
核心业务用例要验证用户真正完成了一条业务链路,而不是把登录、点击和断言拆成互不相关的小脚本。本节围绕登录、查询、新增、修改和删除设计一条可复用的端到端场景,并用稳定定位器和状态断言保证每一步都能验证。
学习目标
- 把登录、查询和 CRUD 操作组织成有业务意义的端到端场景
- 为每个步骤选择可验证的前置状态和结果断言
- 使用 Playwright 编写一条可运行、可定位失败点的核心业务测试
从业务目标反推场景
假设被测系统是商品管理后台,核心目标不是“按钮都能点击”,而是管理员能把一条商品记录从不存在推进到创建、修改、查询确认,再安全删除。每一步都必须有可观察结果,否则失败时只能知道“某个点击没成功”,无法判断业务状态。

这条链路有明确的状态变化:不存在 → 已创建 → 已修改 → 已删除。查询既是独立功能,也是每次写操作后的验证手段,因此比只断言一个成功 Toast 更可靠。
为每一步定义可验证结果
测试设计时先写业务结果,再写操作。登录成功可验证 URL 或用户菜单;新增成功要验证表格出现唯一记录;修改后要验证字段新值;删除后要验证目标行不存在。这样即使界面文案调整,只要业务状态没变,测试仍容易维护。
定位器优先使用 getByRole、getByLabel、getByTestId 等面向用户或显式测试契约的方式。避免依赖深层 CSS 结构,例如 div:nth-child(3) > span,因为布局调整会制造与业务无关的失败。
编写一条完整的端到端用例
下面示例假设系统提供 /login 和 /products 页面,并为关键元素设置了稳定的可访问名称或 data-testid。测试使用唯一商品名避免与并发任务冲突。
import { test, expect } from '@playwright/test';
test('管理员可以完成商品新增、修改和删除', async ({ page }) => {
const productName = `e2e-product-${Date.now()}`;
const updatedPrice = '199.00';
await page.goto('/login');
await page.getByLabel('用户名').fill('admin');
await page.getByLabel('密码').fill('playwright-demo');
await page.getByRole('button', { name: '登录' }).click();
await expect(page).toHaveURL(/\/products$/);
await page.getByPlaceholder('搜索商品').fill(productName);
await page.getByRole('button', { name: '查询' }).click();
await expect(page.getByTestId('product-row')).toHaveCount(0);
await page.getByRole('button', { name: '新增商品' }).click();
await page.getByLabel('商品名称').fill(productName);
await page.getByLabel('价格').fill('99.00');
await page.getByRole('button', { name: '保存' }).click();
await expect(page.getByRole('row', { name: new RegExp(productName) })).toBeVisible();
const row = page.getByRole('row', { name: new RegExp(productName) });
await row.getByRole('button', { name: '编辑' }).click();
await page.getByLabel('价格').fill(updatedPrice);
await page.getByRole('button', { name: '保存' }).click();
await expect(page.getByRole('row', { name: new RegExp(`${productName}.*199\\.00`) })).toBeVisible();
await page.getByRole('row', { name: new RegExp(productName) })
.getByRole('button', { name: '删除' })
.click();
await page.getByRole('button', { name: '确认删除' }).click();
await expect(page.getByRole('row', { name: new RegExp(productName) })).toHaveCount(0);
});预期结果:把文件保存为 tests/e2e/product-crud.spec.ts 后,用下面命令运行;测试应按业务状态顺序完成,并在全部断言通过时退出为成功。
npx playwright test tests/e2e/product-crud.spec.ts --project=chromium预期输出
Running 1 test using 1 worker
✓ 1 [chromium] › product-crud.spec.ts:<LINE>:<COLUMN> › 管理员可以完成商品新增、修改和删除 (<TIME>)
1 passed (<TIME>)实际行号和耗时会不同;如果某一步失败,Playwright 会直接指出失败断言所在位置,便于判断是登录、查询、新增、修改还是删除阶段出现问题。
让失败更容易定位
不要为了“少写几行”把所有断言集中到测试最后。每个改变业务状态的动作后都应立即验证,否则新增其实失败了,测试可能直到修改阶段才报错,根因会被掩盖。
也不要把五个步骤机械拆成五个互相依赖的测试。Playwright 默认允许并行与独立执行,如果测试 B 必须依赖测试 A 先创建数据,重试、筛选单测和并发都会变得脆弱。核心业务链路适合保留为一条独立测试,其他边界条件再拆成单独用例。
扩展角色与浏览器覆盖
核心 CRUD 用例稳定后,再按风险扩展。管理员路径可以继续在 Chromium 上做完整回归,Firefox 和 WebKit 优先覆盖登录、查询与关键展示;viewer 角色则验证能查询但看不到新增、编辑和删除入口。
这种扩展方式让每个新增用例都回答一个明确问题:验证某个业务结果、某种权限差异或某类浏览器兼容性。只要每条用例都能独立准备数据、执行操作并断言最终状态,综合项目就能在持续集成中保持稳定。