自动化测试 / 系统课时

监听页面网络请求

监听页面网络请求

自动化测试不只要验证页面最终显示了什么,还经常需要确认页面到底发出了哪一个请求。本节使用 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 项目运行。

ts
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()));
  }
});

预期输出:

text
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 内容。监听页面请求的重点是捕获足够证明业务行为的证据,而不是对所有浏览器内部字段做脆弱断言。

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

目录与阅读设置

阅读设置

17

记录一个想法

监听页面网络请求

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

登录哪都通