自动化测试 / 系统课时

联动接口与页面测试

联动接口与页面测试

端到端测试不必通过页面完成所有数据准备。更高效的方式是先调用接口创建目标数据,再让浏览器直接进入需要验证的页面,最后通过界面断言业务结果。这样既保留真实页面验证,又能减少冗长且脆弱的前置 UI 操作。

学习目标

  • 使用 request fixture 为页面测试准备业务数据
  • 将接口返回的资源 ID 传递给后续页面步骤
  • 使用 try...finally 保证测试数据在失败时仍能清理

把接口用于准备而不是替代页面验证

假设要验证“新订单详情页能够正确显示商品和状态”。如果每次都从首页进入商品页、加入购物车、填写信息再提交订单,大量步骤其实只是在制造测试前置条件。

更直接的链路是:接口创建订单并返回 ID,浏览器访问这个订单的详情页,然后使用 Locator 断言页面内容。测试重点仍然是页面,只是把数据准备移动到了更稳定、更快速的 API 层。

接口准备数据并由页面完成业务验证的联动流程

完成一条接口到页面的测试链路

下面假设被测应用运行在 APP_URL 指定的地址,并提供 POST /api/orders、GET 对应订单详情页以及 DELETE /api/orders/:id。页面使用 data-testid 暴露商品名称和订单状态定位点。

ts
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());
  }
});

预期输出

text
1 passed (<TIME>s)

<TIME> 为实际运行耗时。测试成功意味着接口创建出的订单能够被页面读取,并且页面展示的商品名称和初始状态与业务预期一致,同时测试结束后已调用删除接口清理数据。

正确传递接口产生的动态数据

接口准备数据最重要的价值之一,是可以直接取得资源 ID、用户名或令牌等后续页面步骤需要的信息。不要在测试里猜测数据库自增 ID,也不要依赖“最新一条订单”这种可能受并发影响的查询方式。

上例把 order.id 直接拼入详情页 URL,因此当前测试始终验证自己创建的那一条记录。并行运行多个测试时,这种显式的数据关联尤其重要。

让清理步骤抵抗测试失败

测试数据如果只在最后一行删除,那么中间任意页面断言失败都会跳过清理。将删除请求放入 finally 可以显著减少残留订单、用户或其他测试资源。

清理接口本身也应该检查状态码,但不要让测试之间共享同一条可变业务数据。接口负责快速建立隔离的前置状态,页面负责验证用户真正看到的结果,这种职责划分通常能让端到端测试更快、更稳定,也更容易定位失败原因。

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

目录与阅读设置

阅读设置

17

记录一个想法

联动接口与页面测试

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

登录哪都通