自动化测试 / 系统课时

断言接口响应

断言接口响应

接口测试不能只判断“请求没报错”。一个可靠的 Playwright 接口用例应同时检查 HTTP 状态、关键响应头、JSON 数据形状以及真正影响业务的字段值,这样才能区分网络成功、协议正确和业务结果正确。

学习目标

  • 使用 APIResponse 断言状态码和响应头
  • 解析 JSON 响应并验证结构与关键字段
  • 避免只检查 response.ok() 导致的弱断言

从 HTTP 层开始断言

通过 Playwright 的 request fixture 发起请求后,会得到 APIResponse。通常先检查状态码,再检查响应头,最后解析响应体。这个顺序有一个实际好处:如果服务直接返回 500 或 HTML 错误页,就没有必要继续把响应当 JSON 处理。

response.ok() 表示状态码位于 200~299,但它不能代替精确状态码断言。例如创建接口通常应该返回 201,如果错误地返回 200,单独检查 ok() 仍然会通过。

同时验证状态、响应头和 JSON

下面的测试请求 JSONPlaceholder 的公开示例接口,并逐层验证响应。响应中的文章编号和字段内容固定,因此适合作为接口断言的最小示例。

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

test('断言文章接口响应', async ({ request }) => {
  const response = await request.get(
    'https://jsonplaceholder.typicode.com/posts/1'
  );

  // 先验证 HTTP 层,避免错误响应继续进入 JSON 断言。
  expect(response.status()).toBe(200);
  expect(response.ok()).toBeTruthy();
  expect(response.headers()['content-type']).toContain('application/json');

  const body = await response.json();

  // 结构断言关注字段是否存在及其类型。
  expect(body).toEqual(
    expect.objectContaining({
      userId: expect.any(Number),
      id: expect.any(Number),
      title: expect.any(String),
      body: expect.any(String),
    })
  );

  // 关键业务字段再做精确断言。
  expect(body.id).toBe(1);
  expect(body.userId).toBe(1);
});

预期输出

text
1 passed (<TIME>s)

<TIME> 是实际测试耗时,每次运行可能不同。这个用例把断言分成三个层次:状态码证明请求按预期完成,content-type 证明服务返回了预期的数据格式,JSON 断言则确认响应结构和关键数据没有偏离契约。

结构断言与精确断言的边界

对每个字段都使用 toEqual() 精确比较并不总是合适。接口常包含创建时间、追踪 ID、分页信息等动态字段,如果把这些值全部写死,测试会因为无关变化频繁失败。

对于只关心“字段存在且类型正确”的部分,可以使用 expect.objectContaining() 和 expect.any();对于订单状态、权限等级、资源 ID 等决定业务是否正确的字段,再使用 toBe()、toEqual() 等精确断言。

失败时先判断是哪一层

如果状态码断言失败,应优先检查 URL、认证、请求参数和服务端错误;如果 content-type 不符合预期,可能拿到了代理错误页或登录页面;只有 HTTP 层正确时,JSON 字段失败才更可能意味着接口契约或业务数据发生变化。

这种分层断言能让失败信息更接近真实根因,也比单纯检查“请求成功”更能保护接口契约。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言接口响应

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

登录哪都通