CDP 协议入门:用 Playwright 接管一个已登录的浏览器

举报
少侠永不言弃 发表于 2026/10/30 18:57:58 2026/10/30
【摘要】 浏览器自动化的真正难点不在"操作",而在"会话"。本文介绍如何用 Playwright 通过 CDP 接管一个已经登录的 Chrome:三个核心概念、四种常用能力,以及两个必踩的坑。

一、为什么需要"接管"而不是"重新打开"

做网页自动化时,最常见的做法是启动一个新的浏览器实例(无头或带界面),让脚本自己去登录。这个方案在"登录需要验证码或扫码"的站点上会直接卡死。

更麻烦的是:有些站点的会话是绑定浏览器进程的——关掉浏览器,服务端的会话就被注销了。这时候无论怎么导出 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})

六、小结

接管真实浏览器的价值在于:你复用的是活着的会话,而不是一张可能已作废的凭证。代价是要处理窗口管理、页面生命周期、句柄失效这些"非业务"问题。

如果你正在做需要登录的自动化,这条路值得一试——尤其是登录带验证码、或者会话绑定浏览器进程的站点。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。