Playwright 中用 page.route() 正则匹配图片 URL 并 fulfill 空响应(status=200)可高效拦截,需覆盖 png/jpg/gif/webp/avif 等格式、忽略大小写、在 goto 前注册,避免误拦 SVG/字体/favicon 等关键资源。

Playwright 中如何用 route 拦截图片请求并返回空响应
直接拦截并终止图片加载是最省资源的方式,比等它下载完再隐藏更高效。关键不是“屏蔽 CSS 或 DOM”,而是从网络层截断——用 page.route() 匹配图片 URL 并调用 route.fulfill() 返回空响应。
常见错误是只匹配 .png 后缀,漏掉 webp、avif、data:image/ base64 图片,甚至带 query 参数的 URL(如 /logo.png?v=2)。
- 用正则匹配更可靠:
r"\.(png|jpe?g|gif|webp|avif)$",注意加i标志忽略大小写 - 必须在
page.goto()前调用route,否则首屏资源已发出,拦截失效 - 返回空响应时,
status=200最稳妥;返回404可能触发 JS 错误重试逻辑 - 示例:
page.route(r"\.(png|jpe?g|gif|webp|avif)$", lambda route: route.fulfill(status=200, body=""))
为什么不能只用 page.set_extra_http_headers() 或禁用 CSS
设 Accept: */* 或删 标签完全无效:浏览器仍会发起请求;CSS display: none 也不阻止下载。真正起效的是网络拦截。
有人尝试用 page.on("request") 监听后 request.abort(),但这是异步的,无法保证 100% 拦住首屏关键图片(尤其预加载 的资源)。
-
route是同步拦截,在请求发出前就介入,可靠性远高于request.abort() -
set_extra_http_headers对图片加载无影响,它只改请求头,不阻止请求本身 - 禁用 JavaScript(
javaScriptEnabled=False)虽能减少动态图片加载,但会破坏页面交互逻辑,得不偿失
如何区分“无用图片”和“必须加载的图片”
全量拦截所有图片风险高——有些图标、验证码、关键 UI 元素是 base64 内联或 SVG,也走图片请求;有些页面靠图片占位符触发懒加载逻辑。
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
实际中建议分层处理:先全局拦截主流格式,再对特定路径放行。
- 放行关键路径:
r"^https?://(api|cdn|static)\.example\.com/.*\.(png|jpg) - 放过内联 data URL:
route.continue_()判断request.url.startswith("data:image/") - 避开 favicon:
not request.url.endswith("favicon.ico") - 如果页面依赖图片尺寸做布局,拦截后需手动触发
page.evaluate("window.dispatchEvent(new Event('resize'))")防止错位
拦截后页面渲染异常?检查是否影响了字体或 SVG 资源
部分网站把字体文件(.woff2)或矢量图标(.svg)放在图片拦截正则里,导致文字乱码或图标消失。SVG 尤其容易被误伤——它既是图片又是文档。
- 不要在图片正则里包含
svg,除非你确认该站所有 SVG 都可丢弃 - 字体文件需单独处理:
page.route(r"\.(woff2|woff|ttf)$", lambda r: r.abort())(若确定不需要) - 用
page.on("response")打印状态码和 URL,快速定位被误拦的资源:page.on("response", lambda r: print(r.status, r.url) if "svg" in r.url else None)
真正难的不是写几行拦截代码,而是判断哪些图片背后藏着业务逻辑——比如某电商页的“缺货图标”是 PNG,但它的存在与否决定按钮是否可点击。这类细节只能结合具体页面分析,没法一劳永逸。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










