自动化测试 / 系统课时
拦截并修改请求
拦截并修改请求
有些测试不能只观察请求,还需要在请求真正到达服务端前改写它。Playwright 可以暂停匹配的网络请求,修改目标地址、请求头或请求体后继续发送,从而模拟灰度接口、测试标记或特定输入,而无需修改被测页面代码。
学习目标
- 使用
page.route()拦截指定网络请求 - 通过
route.continue()修改 URL、请求头和请求体 - 验证服务端最终收到的内容,并避开常见的头部与路由陷阱
请求被拦截后发生什么
调用 page.route() 后,匹配到的请求会先进入路由处理器,而不是立即发往服务器。处理器可以通过 route.request() 读取原始请求,再选择继续发送、直接返回模拟响应或终止请求。本节只处理“修改后继续发送”这一条路径。

路由规则必须在目标请求发生前注册。route.continue() 会立即把当前请求继续发送;如果一个项目为同一请求注册了多层路由处理逻辑,需要特别留意它与 route.fallback() 的区别,避免前面的处理器意外终止后续路由链。
同时修改地址、请求头和请求体
下面的完整测试启动本地 HTTP 服务。页面原本向 /api/orders 提交数量为 1 的订单;Playwright 拦截后把地址改成 /api/orders-v2,增加测试请求头,并把数量改成 2。服务端记录自己真正收到的数据,因此可以直接证明修改已经生效。
import { expect, test } from '@playwright/test';
import http from 'node:http';
test('拦截并修改请求', async ({ page }) => {
let received: {
path: string;
source: string | undefined;
body: unknown;
} | null = null;
const server = http.createServer((req, res) => {
if (req.url === '/') {
res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
res.end(`
<button id="submit">提交订单</button>
<script>
document.querySelector('#submit').addEventListener('click', () => {
fetch('/api/orders', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ sku: 'A-1', qty: 1 })
});
});
</script>
`);
return;
}
if (req.url === '/api/orders-v2' && req.method === 'POST') {
let rawBody = '';
req.on('data', (chunk) => {
rawBody += chunk;
});
req.on('end', () => {
received = {
path: req.url ?? '',
source: req.headers['x-test-source'] as string | undefined,
body: JSON.parse(rawBody)
};
res.writeHead(200, { 'content-type': 'application/json' });
res.end('{"ok":true}');
});
return;
}
res.writeHead(404);
res.end();
});
await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve));
const address = server.address();
if (!address || typeof address === 'string') throw new Error('无法获取监听端口');
const baseURL = `http://127.0.0.1:${address.port}`;
// 路由必须在触发目标请求之前注册。
await page.route('**/api/orders', async (route) => {
const request = route.request();
if (request.method() !== 'POST') {
await route.continue();
return;
}
const originalBody = request.postDataJSON() as { sku: string; qty: number };
const headers = await request.allHeaders();
// 请求体长度发生变化时不要沿用旧的 Content-Length。
delete headers['content-length'];
headers['x-test-source'] = 'playwright';
const newUrl = new URL('/api/orders-v2', request.url()).toString();
await route.continue({
url: newUrl,
headers,
postData: JSON.stringify({ ...originalBody, qty: 2 })
});
});
try {
await page.goto(baseURL);
await page.getByRole('button', { name: '提交订单' }).click();
await expect.poll(() => received).not.toBeNull();
console.log(JSON.stringify(received));
} finally {
await new Promise<void>((resolve) => server.close(() => resolve()));
}
});预期输出:
{"path":"/api/orders-v2","source":"playwright","body":{"sku":"A-1","qty":2}}输出证明服务器最终收到的是修改后的地址、请求头和 JSON 请求体,而页面源代码仍然只知道原始的 /api/orders 和 qty: 1。
修改请求时的关键边界
修改 URL 时,新地址必须与原请求保持相同协议,例如不能直接把 http 请求通过 route.continue() 改成 https。另外,路由匹配依据最初的请求 URL 完成;即使处理器随后修改 URL,也不会重新用新地址执行一轮 page.route() 匹配。
修改请求体时还要注意相关头部。浏览器原请求可能已经带有 content-length,如果继续复制旧值而请求体长度发生变化,就可能产生长度不一致的问题,因此示例主动删除它,让底层重新计算。修改 JSON 内容时也应保留正确的 content-type。
什么时候不用 continue
route.continue() 适合让请求仍然访问真实服务,只是在发送前做有限改写。如果目标是完全模拟后端返回值,应使用 route.fulfill();如果测试的是资源加载失败或请求被阻止的场景,则应使用 route.abort()。选择哪一种方式取决于测试是否还需要真实服务器参与,而不是为了方便把所有接口都改成 Mock。