自动化测试 / 系统课时
联动接口与页面测试
联动接口与页面测试
端到端测试不必通过页面完成所有数据准备。更高效的方式是先调用接口创建目标数据,再让浏览器直接进入需要验证的页面,最后通过界面断言业务结果。这样既保留真实页面验证,又能减少冗长且脆弱的前置 UI 操作。
学习目标
- 使用
requestfixture 为页面测试准备业务数据 - 将接口返回的资源 ID 传递给后续页面步骤
- 使用
try...finally保证测试数据在失败时仍能清理
把接口用于准备而不是替代页面验证
假设要验证“新订单详情页能够正确显示商品和状态”。如果每次都从首页进入商品页、加入购物车、填写信息再提交订单,大量步骤其实只是在制造测试前置条件。
更直接的链路是:接口创建订单并返回 ID,浏览器访问这个订单的详情页,然后使用 Locator 断言页面内容。测试重点仍然是页面,只是把数据准备移动到了更稳定、更快速的 API 层。

完成一条接口到页面的测试链路
下面假设被测应用运行在 APP_URL 指定的地址,并提供 POST /api/orders、GET 对应订单详情页以及 DELETE /api/orders/:id。页面使用 data-testid 暴露商品名称和订单状态定位点。
import { test, expect } from '@playwright/test';
test('接口创建订单后在页面验证', async ({ request, page }) => {
const baseURL = process.env.APP_URL ?? 'http://127.0.0.1:3000';
const createResponse = await request.post(`${baseURL}/api/orders`, {
data: {
product: 'Playwright Mug',
quantity: 1,
},
});
expect(createResponse.status()).toBe(201);
const order = await createResponse.json();
expect(order.id).toBeTruthy();
try {
// API 只负责准备状态,真正的业务验收仍通过页面完成。
await page.goto(`${baseURL}/orders/${order.id}`);
await expect(page.getByTestId('product-name')).toHaveText(
'Playwright Mug'
);
await expect(page.getByTestId('order-status')).toHaveText('待支付');
} finally {
// 即使页面断言失败,也尽量清除本次测试创建的数据。
const deleteResponse = await request.delete(
`${baseURL}/api/orders/${order.id}`
);
expect([200, 204]).toContain(deleteResponse.status());
}
});预期输出
1 passed (<TIME>s)<TIME> 为实际运行耗时。测试成功意味着接口创建出的订单能够被页面读取,并且页面展示的商品名称和初始状态与业务预期一致,同时测试结束后已调用删除接口清理数据。
正确传递接口产生的动态数据
接口准备数据最重要的价值之一,是可以直接取得资源 ID、用户名或令牌等后续页面步骤需要的信息。不要在测试里猜测数据库自增 ID,也不要依赖“最新一条订单”这种可能受并发影响的查询方式。
上例把 order.id 直接拼入详情页 URL,因此当前测试始终验证自己创建的那一条记录。并行运行多个测试时,这种显式的数据关联尤其重要。
让清理步骤抵抗测试失败
测试数据如果只在最后一行删除,那么中间任意页面断言失败都会跳过清理。将删除请求放入 finally 可以显著减少残留订单、用户或其他测试资源。
清理接口本身也应该检查状态码,但不要让测试之间共享同一条可变业务数据。接口负责快速建立隔离的前置状态,页面负责验证用户真正看到的结果,这种职责划分通常能让端到端测试更快、更稳定,也更容易定位失败原因。