自动化测试 / 系统课时
监听页面网络请求
监听页面网络请求
自动化测试不只要验证页面最终显示了什么,还经常需要确认页面到底发出了哪一个请求。本节使用 Playwright 的请求事件捕获地址、HTTP 方法、请求头和请求体,并通过一个可独立运行的本地示例验证监听结果。
学习目标
- 使用
page.on('request')监听页面产生的网络请求 - 从
Request对象读取 URL、方法、请求头和请求体 - 正确处理监听时机、请求过滤与空请求体等常见边界
请求事件能看到什么
page.on('request', handler) 会在页面发出请求时触发回调。监听器必须在目标操作发生前注册,否则已经发出的请求不会被补发给监听器。页面导航、脚本、图片、接口调用等都可能产生事件,因此实际测试中通常还需要按 URL 或资源类型过滤。
回调收到的 Request 对象提供了本节最常用的四类信息:url() 返回请求地址,method() 返回 HTTP 方法,allHeaders() 获取完整请求头,postData() 返回原始请求体字符串。GET 请求或没有请求体的请求,其 postData() 通常为 null。
捕获一次 POST 请求
下面的测试启动一个临时 HTTP 服务。页面点击“保存”后发送 JSON 请求,监听器只记录 /api/profile,因此不会被页面本身的文档请求干扰。示例不依赖外部网站,适合直接放进已经配置好的 Playwright Test 项目运行。
import { expect, test } from '@playwright/test';
import http from 'node:http';
test('监听页面请求', async ({ page }) => {
const server = http.createServer((req, res) => {
if (req.url === '/') {
res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
res.end(`
<button id="save">保存</button>
<script>
document.querySelector('#save').addEventListener('click', () => {
fetch('/api/profile', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Client': 'demo'
},
body: JSON.stringify({ name: 'Ada' })
});
});
</script>
`);
return;
}
if (req.url === '/api/profile') {
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}`;
const captured: Array<{
url: string;
method: string;
headers: Record<string, string>;
body: string | null;
}> = [];
// 先注册监听器,再触发页面操作,避免漏掉目标请求。
page.on('request', async (request) => {
if (!request.url().endsWith('/api/profile')) return;
captured.push({
url: request.url(),
method: request.method(),
headers: await request.allHeaders(),
body: request.postData()
});
});
try {
await page.goto(baseURL);
await page.getByRole('button', { name: '保存' }).click();
await expect.poll(() => captured.length).toBe(1);
const request = captured[0];
console.log(`${request.method} ${request.url}`);
console.log(`content-type: ${request.headers['content-type']}`);
console.log(request.body);
} finally {
await new Promise<void>((resolve) => server.close(() => resolve()));
}
});预期输出:
POST http://127.0.0.1:<PORT>/api/profile
content-type: application/json
{"name":"Ada"}其中 <PORT> 是操作系统临时分配的端口,实际值每次运行都可能不同。
控制监听范围
真实页面可能在一次操作中发送几十个请求。如果目标是检查接口调用,应尽早过滤,而不是把全部请求保存下来之后再分析。例如可以通过 request.url() 判断接口路径,也可以用 request.resourceType() 区分 document、script、image、xhr、fetch 等资源类型。
如果只等待某一次明确的请求,page.waitForRequest() 往往比长期事件监听更直接;如果要持续观察一段流程中的多个请求,page.on('request') 更合适。两者都应在触发请求的点击、提交或导航动作之前开始等待。
请求头和请求体的边界
请求头名称通常以小写形式读取,因此示例使用 headers['content-type']。测试完整请求头时优先使用 allHeaders();如果只关心几个业务字段,应只断言这些稳定字段,不要把浏览器自动生成的 user-agent、长度或缓存相关头部全部写死。
postData() 返回的是原始字符串。对于确定为 JSON 的请求,可以进一步使用 postDataJSON() 得到解析后的值,但它并不适合任意表单、二进制上传或非 JSON 内容。监听页面请求的重点是捕获足够证明业务行为的证据,而不是对所有浏览器内部字段做脆弱断言。