CDP 协议入门:用 Playwright 接管一个已登录的浏览器
一、为什么需要"接管"而不是"重新打开"
做网页自动化时,最常见的做法是启动一个新的浏览器实例(无头或带界面),让脚本自己去登录。这个方案在"登录需要验证码或扫码"的站点上会直接卡死。
更麻烦的是:有些站点的会话是绑定浏览器进程的——关掉浏览器,服务端的会话就被注销了。这时候无论怎么导出 cookie,下次都登不进去。
于是有了另一条路:不重新打开浏览器,而是接管一个已经登录的浏览器。脚本只负责操作,登录这件事交给用户自己做一次。
二、三行代码接入
前提:目标 Chrome 以调试端口启动。
chrome.exe --remote-debugging-port=9222 --user-data-dir="D:\my-profile"
然后 Playwright 连上去:
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.connect_over_cdp("http://127.0.0.1:9222")
context = browser.contexts[0]
page = context.pages[0]
print(page.title())
注意用的是 connect_over_cdp 而不是 launch:前者连接已有实例,后者新开一个。
三、Target / Page / Session 三个概念
CDP 里最容易绕晕的是这三个词:
- Target:一个可调试的实体。一个标签页、一个 Service Worker、一个 iframe 都可能是 Target。
- Page:Target 的一种,代表一个标签页。
- Session:你与某个 Target 之间的通道。发命令、收事件都走它。
Playwright 把这三层包了起来:browser 对应浏览器进程,context 对应一个 profile,page 对应标签页。多数时候不用关心 Session,但要发原生 CDP 命令时会用到:
cdp = context.new_cdp_session(page)
cdp.send("Page.captureScreenshot", {"format": "png"})
四、能做什么
1. 在页面里执行 JS
result = page.evaluate("() => document.title")
这是最有用的能力。因为请求是在页面上下文里发出的,会自动带上 cookie、自动满足同源策略——比在外面用 requests 模拟请求可靠得多。
2. 截图
cdp.send("Page.captureScreenshot", {"format": "png"})
用 CDP 截图比 page.screenshot() 更"硬":后者会等字体、等动画,页面有持续动画时容易超时;前者直接抓当前帧。
3. 监听网络
page.on("response", lambda r: print(r.status, r.url))
用来分析一个页面到底调了哪些接口、带了什么请求头,非常高效。
4. 控制窗口
win = cdp.send("Browser.getWindowForTarget")["windowId"]
cdp.send("Browser.setWindowBounds",
{"windowId": win, "bounds": {"windowState": "minimized"}})
五、两个必踩的坑
坑 1:页面句柄会失效
如果用户中途刷新或重开了标签,手里的 page 对象可能指向一个已销毁的渲染进程,之后所有操作都报 TargetClosedError。
对策:每次操作前按 URL 重新找一遍页面,不要长期持有 page 引用。
page = next((p for p in context.pages if "example.com" in p.url), None)
if page is None:
page = context.new_page()
坑 2:窗口最小化会让视口变成 0×0
为了不打扰用户,很多人会把窗口最小化。但最小化之后,getBoundingClientRect() 返回的全是 0,offsetParent 变成 null,于是:
locator.click()报"元素不可见"- 按坐标点击会点在 (0,0)
对策有两个:操作前先把窗口恢复(windowState: "normal"),做完再最小化;或者用 Emulation.setDeviceMetricsOverride 设一个虚拟视口。
cdp.send("Emulation.setDeviceMetricsOverride",
{"width": 1440, "height": 900, "deviceScaleFactor": 1, "mobile": False})
六、小结
接管真实浏览器的价值在于:你复用的是活着的会话,而不是一张可能已作废的凭证。代价是要处理窗口管理、页面生命周期、句柄失效这些"非业务"问题。
如果你正在做需要登录的自动化,这条路值得一试——尤其是登录带验证码、或者会话绑定浏览器进程的站点。
- 点赞
- 收藏
- 关注作者
评论(0)