6. ChromiumPage 基础

ChromiumPage 是最常用的入口对象。

它内部封装了浏览器对象和标签页对象，简化了操作。

创建 ChromiumPage

最简单的方式：

from DrissionPage import ChromiumPage

page = ChromiumPage()

这行代码做了三件事：启动浏览器、创建连接、获取标签页。

可以直接使用：

page = ChromiumPage()
page.get('https://www.baidu.com')
print(page.title)

Chromium 对象

ChromiumPage 内部封装的就是 Chromium 对象。

Chromium 是浏览器总管，管理标签页、运行参数、浏览器信息等。

也可以直接用 Chromium 对象：

from DrissionPage import Chromium

browser = Chromium()           # 创建浏览器对象
tab = browser.latest_tab       # 获取标签页对象
tab.get('https://www.baidu.com')

效果一样，只是多了一步获取标签页的操作。

指定端口

默认使用 9222 端口。想换端口：

browser = Chromium(9333)              # 传入端口号
browser = Chromium('127.0.0.1:9333')  # 传入地址字符串

如果该端口已有浏览器在跑，就接管它。没有的话，启动一个新的。

接管已有浏览器

想控制一个已经打开的浏览器？

先用命令行启动浏览器并开启远程调试端口：

chrome.exe --remote-debugging-port=9333

然后用代码接管：

from DrissionPage import Chromium

browser = Chromium(9333)  # 接管 9333 端口的浏览器
tab = browser.latest_tab
print(tab.title)          # 打印当前标签页标题

通过配置创建

需要自定义启动参数时，用 ChromiumOptions：

from DrissionPage import Chromium, ChromiumOptions

# 创建配置对象
co = ChromiumOptions().set_browser_path(r'D:\chrome.exe')

# 用配置创建浏览器
browser = Chromium(addr_or_opts=co)

ChromiumOptions 支持链式调用，后面章节会详细讲。

指定 ini 文件

配置可以保存到 ini 文件，创建时指定：

from DrissionPage import Chromium, ChromiumOptions

co = ChromiumOptions(ini_path=r'./my_config.ini')
browser = Chromium(addr_or_opts=co)

这样不同项目可以用不同的配置文件，互不干扰。

单例模式

同一个浏览器只能有一个 Chromium 对象控制。

重复调用 Chromium() 获取的是同一个对象：

b1 = Chromium()
b2 = Chromium()
print(b1 is b2)  # True

不用担心重复创建会启动多个浏览器。

关闭浏览器

browser.quit()

程序结束时浏览器不会主动关闭（VSCode 启动的除外）。

这是为了下次运行时能复用浏览器。想手动关闭就调 quit()。