自动化测试 / 系统课时
断言接口响应
断言接口响应
接口测试不能只判断“请求没报错”。一个可靠的 Playwright 接口用例应同时检查 HTTP 状态、关键响应头、JSON 数据形状以及真正影响业务的字段值,这样才能区分网络成功、协议正确和业务结果正确。
学习目标
- 使用
APIResponse断言状态码和响应头 - 解析 JSON 响应并验证结构与关键字段
- 避免只检查
response.ok()导致的弱断言
从 HTTP 层开始断言
通过 Playwright 的 request fixture 发起请求后,会得到 APIResponse。通常先检查状态码,再检查响应头,最后解析响应体。这个顺序有一个实际好处:如果服务直接返回 500 或 HTML 错误页,就没有必要继续把响应当 JSON 处理。
response.ok() 表示状态码位于 200~299,但它不能代替精确状态码断言。例如创建接口通常应该返回 201,如果错误地返回 200,单独检查 ok() 仍然会通过。
同时验证状态、响应头和 JSON
下面的测试请求 JSONPlaceholder 的公开示例接口,并逐层验证响应。响应中的文章编号和字段内容固定,因此适合作为接口断言的最小示例。
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);
});预期输出
1 passed (<TIME>s)<TIME> 是实际测试耗时,每次运行可能不同。这个用例把断言分成三个层次:状态码证明请求按预期完成,content-type 证明服务返回了预期的数据格式,JSON 断言则确认响应结构和关键数据没有偏离契约。
结构断言与精确断言的边界
对每个字段都使用 toEqual() 精确比较并不总是合适。接口常包含创建时间、追踪 ID、分页信息等动态字段,如果把这些值全部写死,测试会因为无关变化频繁失败。
对于只关心“字段存在且类型正确”的部分,可以使用 expect.objectContaining() 和 expect.any();对于订单状态、权限等级、资源 ID 等决定业务是否正确的字段,再使用 toBe()、toEqual() 等精确断言。
失败时先判断是哪一层
如果状态码断言失败,应优先检查 URL、认证、请求参数和服务端错误;如果 content-type 不符合预期,可能拿到了代理错误页或登录页面;只有 HTTP 层正确时,JSON 字段失败才更可能意味着接口契约或业务数据发生变化。
这种分层断言能让失败信息更接近真实根因,也比单纯检查“请求成功”更能保护接口契约。