自动化测试 / 系统课时
配置浏览器启动选项
配置浏览器启动选项
浏览器启动选项必须在创建 WebDriver 会话前确定。本节以 Selenium 4 的 Python 绑定和 Chrome 为例,把无头模式、语言、下载目录与常用启动参数集中到 ChromeOptions,并给出可运行的验证方法,避免参数写了却没有真正传给浏览器。
学习目标
- 使用
ChromeOptions配置无头模式、窗口尺寸、语言和 Chromium 偏好。 - 为下载目录设置可移植的绝对路径,并确认配置确实进入启动能力。
- 判断哪些启动参数适合日常测试,哪些只应在容器或特定环境下使用。
启动前集中声明 Options
Options 是创建浏览器会话时的一次性输入;webdriver.Chrome(options=options) 执行后,再修改原来的 options 不会改变已经运行的浏览器。现代 Chrome 可直接使用 --headless,无头测试最好同时固定窗口尺寸,否则响应式布局可能因为默认视口不同而改变元素位置。
下面示例会创建项目目录下的 downloads,配置中文语言、无头模式、1440×900 视口和下载偏好,并在真正启动浏览器前检查这些配置是否已经写入 capabilities。
from pathlib import Path
from selenium import webdriver
download_dir = (Path.cwd() / "downloads").resolve()
download_dir.mkdir(exist_ok=True)
options = webdriver.ChromeOptions()
options.add_argument("--headless")
options.add_argument("--window-size=1440,900")
options.add_argument("--lang=zh-CN")
options.add_argument("--disable-notifications")
options.add_experimental_option(
"prefs",
{
"download.default_directory": str(download_dir),
"download.prompt_for_download": False,
"intl.accept_languages": "zh-CN,zh",
},
)
chrome_options = options.to_capabilities()["goog:chromeOptions"]
print("headless =", "--headless" in chrome_options["args"])
print("lang =", "--lang=zh-CN" in chrome_options["args"])
print(
"accept_language =",
chrome_options["prefs"]["intl.accept_languages"] == "zh-CN,zh",
)
print(
"download_dir =",
chrome_options["prefs"]["download.default_directory"] == str(download_dir),
)
driver = webdriver.Chrome(options=options)
try:
driver.get("data:text/html,<title>options-ok</title><h1>ready</h1>")
print("title =", driver.title)
finally:
driver.quit()预期输出
headless = True
lang = True
accept_language = True
download_dir = True
title = options-ok如果前三项有任意一项为 False,先检查参数是否加在创建 driver 之前;若浏览器无法启动,再单独排查 Chrome 与驱动环境,而不要先把更多启动参数一起塞进去。
常用启动参数按场景取值
启动参数越多,测试环境与真实用户环境的差异越大。下面四项足以覆盖大多数本地和 CI 场景;其中 --window-size 在无头模式下比 --start-maximized 更可控,因为它直接给出可重复的像素尺寸。
| 配置 | 推荐值 | 适用场景 | 检查点 |
|---|---|---|---|
| 无头模式 | --headless |
CI、服务器、批量回归 | 截图尺寸与有界面模式一致 |
| 窗口尺寸 | --window-size=1440,900 |
响应式页面、截图测试 | driver.get_window_size() 接近目标值 |
| Chrome 应用语言 | --lang=zh-CN |
浏览器自身区域设置 | 不等同于网站一定返回中文 |
| 网站首选语言 | intl.accept_languages = zh-CN,zh |
Accept-Language 内容协商 |
用目标站响应或页面语言验证 |
| 通知 | --disable-notifications |
网站会弹浏览器通知授权 | 页面流程不再被通知授权提示打断 |
Chrome 132 及之后的常规 --headless 使用统一后的 Headless 实现;旧教程里的 --headless=new 属于版本迁移阶段常见写法。维护旧环境时应按实际 Chrome 版本验证,不要为了兼容历史脚本同时添加多种 headless 参数。
下载目录用绝对路径
Chromium 的下载目录通过 prefs 传入,而不是普通命令行参数。download.default_directory 建议使用 Path.resolve() 得到绝对路径;download.prompt_for_download=False 可避免保存对话框阻塞自动化。下载动作完成后,还要检查目标文件是否出现,不能把“已点击下载按钮”当成“文件已下载”。
| 偏好键 | 示例值 | 作用 |
|---|---|---|
download.default_directory |
/absolute/project/downloads |
指定浏览器进程写入文件的目录 |
download.prompt_for_download |
False |
关闭每次下载前的询问 |
若脚本运行在 Selenium Grid 或远程容器中,这个目录属于远端浏览器所在机器,不是发起测试的本机。需要把远端下载取回客户端时,应使用 Grid 的下载管理能力,而不是把本机路径硬塞给远端 Chrome。
避免把环境补丁当默认配置
很多复制来的 Selenium 示例会附带 --no-sandbox、--disable-dev-shm-usage 或固定的 --user-data-dir。这些参数不是“提高稳定性”的通用开关,应当只在能说明原因时加入,否则会掩盖真实的运行环境问题。
| 参数 | 什么时候才考虑 | 不该怎么用 |
|---|---|---|
--no-sandbox |
受控容器里确认沙箱机制导致启动失败 | 不要在普通开发机和生产测试机默认关闭沙箱 |
--disable-dev-shm-usage |
Linux 容器的 /dev/shm 很小且 Chrome 因共享内存崩溃 |
不要把它当所有 CI 的固定模板 |
--user-data-dir=<PATH> |
需要隔离且持久的专用测试 Profile | 不要指向日常使用的个人 Chrome Profile |
--remote-debugging-port=<PORT> |
明确需要外部 DevTools 连接 | 普通 Selenium 会话不要固定端口,避免并发冲突 |
一个可维护的起点通常只有业务真正需要的参数:无头、固定视口、语言与下载偏好。遇到启动失败时再按日志添加环境相关参数,比一开始复制十几个开关更容易定位问题。