Playwright 网络拦截器

解决的问题

当前端依赖未稳定的第三方接口时，开发者常陷入三类困境：联调前无法准备边界响应（如超时、空数组或鉴权失败），排查弱网与异常分支耗时久，且需要复现一次请求的 URL、请求头、响应体细节时，手工 DevTools 操作难以固化。Playwright 网络拦截器把浏览器请求生命周期变成可编程事件，在请求发出前就介入。

核心能力与关键步骤

• 请求/响应改写：通过 page.route() 注册拦截器，命中规则的请求被中止、伪造或转发；可在响应到达页面前替换状态码、响应头与响应体。
• API 响应捕获：在 request 与 response 事件中读取元数据与负载，供断言、落盘或上报，便于回归测试覆盖异常分支。
• HAR 录制：按规范导出 HTTP Archive，回放与审计请求序列，形成可共享的会话证据。

执行路径大致为：定义匹配模式 → 注册 route handler → 在 handler 内构造 route.fulfill() 或 route.continue() → 按需 page.pause() 进入可视化调试。

适用边界与注意点

它适合 E2E 测试、契约演练与接口 mock 场景，但拦截发生在协议栈之上，无法绕过 DNS、TCP 层；过大的 response 缓冲可能引入额外延迟；录制 HAR 时应确认不含敏感字段。修改响应时要同步更新 CSP 或校验逻辑，否则页面可能静默失败。