自动化测试 / 系统课时

配置浏览器启动选项

配置浏览器启动选项

浏览器启动选项必须在创建 WebDriver 会话前确定。本节以 Selenium 4 的 Python 绑定和 Chrome 为例,把无头模式、语言、下载目录与常用启动参数集中到 ChromeOptions,并给出可运行的验证方法,避免参数写了却没有真正传给浏览器。

学习目标

  • 使用 ChromeOptions 配置无头模式、窗口尺寸、语言和 Chromium 偏好。
  • 为下载目录设置可移植的绝对路径,并确认配置确实进入启动能力。
  • 判断哪些启动参数适合日常测试,哪些只应在容器或特定环境下使用。

启动前集中声明 Options

Options 是创建浏览器会话时的一次性输入;webdriver.Chrome(options=options) 执行后,再修改原来的 options 不会改变已经运行的浏览器。现代 Chrome 可直接使用 --headless,无头测试最好同时固定窗口尺寸,否则响应式布局可能因为默认视口不同而改变元素位置。

下面示例会创建项目目录下的 downloads,配置中文语言、无头模式、1440×900 视口和下载偏好,并在真正启动浏览器前检查这些配置是否已经写入 capabilities。

python
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()

预期输出

text
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 会话不要固定端口,避免并发冲突

一个可维护的起点通常只有业务真正需要的参数:无头、固定视口、语言与下载偏好。遇到启动失败时再按日志添加环境相关参数,比一开始复制十几个开关更容易定位问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置浏览器启动选项

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通