Playwright 不支持直接修改响应体,只能通过 route.fulfill() 伪造响应;需同步请求原始响应、修改 body 后手动 fulfill,注意编码、Content-Type 和 JSON 处理。

Playwright 本身不支持直接修改响应体(response body),这是它的设计限制——你只能拦截、中止、继续或伪造整个响应,但无法在原始响应返回前动态重写其 body 内容。
为什么 route.continue_() 不能改响应体
调用 route.continue_() 会原样转发请求到服务器,拿到真实响应后直接返回给页面;它不提供 hook 点来篡改已收到的响应数据。常见误解是以为能像 Puppeteer 的 interceptResponse 那样操作,但 Playwright 没有等价机制。
-
route.fulfill()可以伪造响应,但需你完全构造 status、headers、body,无法复用原始响应结构 -
route.abort()或route.continue_()都不暴露 response 对象 - 即使监听
page.on("response"),事件触发时响应已结束,无法干预传输中的 body
用 route.fulfill() 伪造响应并复用原始 headers
实际可行路径是:拦截请求 → 发起一次同步 HTTP 请求获取原始响应 → 提取 headers 和 status → 修改 body → 调用 route.fulfill() 返回伪造结果。关键点在于自己做一次“代理式转发”。
- 必须用同步 HTTP 客户端(如
requests),因为route回调不支持 await - 注意处理二进制响应(如图片、JSON、HTML):body 必须是
bytes或str,且content-typeheader 要匹配 - 原始响应的
set-cookie、cache-control等 header 建议保留,否则可能破坏登录态或缓存逻辑
def handle_route(route, request):
try:
# 同步获取原始响应
resp = requests.get(request.url, headers=request.headers, timeout=10)
# 修改 body:例如把所有 "old" 替成 "new"
new_body = resp.text.replace("old", "new")
# 构造 fulfill 参数
route.fulfill(
status=resp.status_code,
headers=resp.headers,
body=new_body.encode(resp.encoding or "utf-8")
)
except Exception as e:
route.abort()
<h1>注册路由(注意:只对匹配 URL 生效)</h1><p>page.route("**/api/data", handle_route)
</p>
拦截 JSON API 并注入字段的典型场景
前端依赖某个 /api/user 接口返回 JSON,你想在不改服务端的前提下,强制添加 "is_mocked": true 字段——这是最常被问到的需求。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 别直接
json.loads(resp.text)后dict.update(),要小心空值、嵌套结构和编码异常 - 若原始响应是 gzip 压缩的,
requests默认自动解压,但resp.content是 bytes,resp.text是 str,选错会导致乱码 - 务必检查
resp.headers.get("content-type", "")是否含application/json,避免对非 JSON 响应做 JSON 操作
if "application/json" in resp.headers.get("content-type", ""):
try:
data = resp.json()
data["is_mocked"] = True
new_body = json.dumps(data, ensure_ascii=False).encode("utf-8")
except json.JSONDecodeError:
new_body = resp.content # 保持原样 fallback
else:
new_body = resp.content
Chrome DevTools Protocol(CDP)不是替代方案
有人尝试通过 context.new_cdp_session() 调用 CDP 的 Network.setResponseHeaders 或类似方法,但 CDP 在 Playwright 中不暴露响应体修改能力,且该接口仅用于设置 header,与 body 无关。
- CDP 的
Network.setRequestInterception已被 Playwright 封装为route,底层能力一致 - 任何绕过 Playwright 路由 API 直接操作 CDP 的尝试,最终仍受限于 Chromium 本身的限制:它不提供运行时重写响应 body 的通道
- 若真需要深度响应篡改,应考虑在本地起 mock server(如
httpx + ASGI),再用page.route()把请求重定向过去
真正卡住的地方往往不是代码怎么写,而是误以为 Playwright 有“响应中间件”能力。一旦接受它只提供请求层控制的事实,方案就清晰了:要么全量伪造(fulfill),要么换架构(本地代理)。别在 continue_() 上浪费调试时间。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










