自动化测试 / 系统课时

拦截并修改请求

拦截并修改请求

有些测试不能只观察请求,还需要在请求真正到达服务端前改写它。Playwright 可以暂停匹配的网络请求,修改目标地址、请求头或请求体后继续发送,从而模拟灰度接口、测试标记或特定输入,而无需修改被测页面代码。

学习目标

  • 使用 page.route() 拦截指定网络请求
  • 通过 route.continue() 修改 URL、请求头和请求体
  • 验证服务端最终收到的内容,并避开常见的头部与路由陷阱

请求被拦截后发生什么

调用 page.route() 后,匹配到的请求会先进入路由处理器,而不是立即发往服务器。处理器可以通过 route.request() 读取原始请求,再选择继续发送、直接返回模拟响应或终止请求。本节只处理“修改后继续发送”这一条路径。

Playwright 请求拦截与修改链路

路由规则必须在目标请求发生前注册。route.continue() 会立即把当前请求继续发送;如果一个项目为同一请求注册了多层路由处理逻辑,需要特别留意它与 route.fallback() 的区别,避免前面的处理器意外终止后续路由链。

同时修改地址、请求头和请求体

下面的完整测试启动本地 HTTP 服务。页面原本向 /api/orders 提交数量为 1 的订单;Playwright 拦截后把地址改成 /api/orders-v2,增加测试请求头,并把数量改成 2。服务端记录自己真正收到的数据,因此可以直接证明修改已经生效。

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

预期输出:

text
{"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。

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

目录与阅读设置

阅读设置

17

记录一个想法

拦截并修改请求

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

登录哪都通