自动化测试 / 系统课时
模拟接口响应
模拟接口响应
本课解决前端测试依赖真实后端而出现数据波动、接口不可用的问题。完成后,你可以用 Playwright 替换商品接口的返回结果,分别验证空列表和服务器错误时页面是否显示预期内容。
学习目标
- 理解请求拦截与接口 Mock 的工作方式。
- 掌握
page.route()和route.fulfill()返回固定 JSON 的方法。 - 使用模拟数据验证页面的空态与错误态。
模拟响应机制
接口模拟通过拦截请求并直接返回指定内容实现。页面认为接口已返回,但数据来自测试脚本。page.route('**/api/products', handler) 匹配请求后,route.fulfill() 用 status、contentType 和 body 构造响应,浏览器再将它交给页面代码处理。
应在 page.goto() 或触发接口请求的操作之前注册路由,避免漏掉页面初始化请求。没有命中的请求仍按正常网络流程处理;接口返回后,测试应断言页面状态,而不是靠固定等待时间猜测请求是否完成。

返回固定数据
下面的测试同时模拟商品接口和一个最小网页,因此不需要启动真实后端。把代码保存为 tests/mock-api.spec.js;同一个主示例覆盖 HTTP 200 的空列表和 HTTP 500 的失败响应。
const { test, expect } = require('@playwright/test');
const scenarios = [
{ name: '空列表', status: 200, payload: { items: [] }, expected: '商品数:0' },
{ name: '服务失败', status: 500, payload: { error: 'unavailable' }, expected: '加载失败' }
];
for (const scenario of scenarios) {
test(`mock api: ${scenario.name}`, async ({ page }) => {
// 在导航前注册接口路由,确保首屏请求也被拦截
await page.route('**/api/products', route => route.fulfill({
status: scenario.status,
contentType: 'application/json',
body: JSON.stringify(scenario.payload)
}));
// 页面文档也由测试提供,避免访问实际网站
await page.route('https://shop.test/', route => route.fulfill({
contentType: 'text/html',
body: `<div id="result">加载中</div>
<script>
fetch('/api/products')
.then(r => { if (!r.ok) throw Error('API error'); return r.json(); })
.then(data => document.querySelector('#result').textContent = '商品数:' + data.items.length)
.catch(() => document.querySelector('#result').textContent = '加载失败');
</script>`
}));
await page.goto('https://shop.test/');
await expect(page.locator('#result')).toHaveText(scenario.expected);
});
}预期结果:200 响应中的 items: [] 使页面显示“商品数:0”;500 响应使 response.ok 检查失败,页面显示“加载失败”。两个测试都通过时,说明这两条 UI 分支按预期工作。
在已安装 @playwright/test 与 Chromium 的项目根目录执行:
npx playwright test tests/mock-api.spec.js预期输出(摘录,实际耗时可能不同):
2 passed (<TIME>)Mock 使用边界
模拟接口适合验证前端渲染、空态和错误态,但不能替代真实接口联调。尤其要区分 HTTP 状态码 与 JSON 内容:返回 500 并不一定让 fetch() 的 Promise 自动拒绝;页面需要主动检查 response.ok,否则可能将错误 JSON 当作正常业务数据处理。
路由表达式必须与实际请求地址匹配,例如 **/api/products 不会匹配 /api/products/123。真实项目应只 Mock 当前测试需要控制的请求,并另外通过接口测试或联调确认真实服务的字段、状态码与鉴权行为。