当前位置：首页 > news >正文

Web自动化中Selenium下Chrome与Edge的Webdriver常用Options参数

news 来源：原创 2025/9/18 1:49:51

引言

说明

Add_argument()

添加方式

常用参数

Add_experimental_option()

添加方式

常用方法

任务结束后仍然保持浏览器打开

禁用“Chrome 正受到自动测试软件的控制”提示

设置下载路径

禁用弹窗拦截

禁用图片加载

禁用 JavaScript

注意

引言

Options是selenium用来设定浏览器的一些属性和必要操作的工具。根据添加方式可以分为命令行参数，用户配置文件，扩展组件和实验性功能等。

本文主要介绍命令行参数与实验性选项这两个Selenium在web自动化中最常用的Options设定。

说明

在web自动化过程中命令行参数与实验性选项是最直接和灵活的一种方式，通过传递特定的字符串参数给浏览器，可以改变浏览器的启动行为。但是许多用户在使用时不知道去哪里查询这些参数。实际上，Selenium官方文档和各浏览器的官方文档都提供了详细的参数列表。以下是一些作者本人曾用到和查询过的参数。

本文所有内容均基于Selenium官方文档和Chromium浏览器的官方文档。且所给内容适合配合selenium使用,需要注意的是,由于浏览器版本等问题,部分参数可能失效。

https://peter.sh/experiments/chromium-command-line-switches/https://peter.sh/experiments/chromium-command-line-switches/https://github.com/GoogleChrome/chrome-launcher/blob/main/docs/chrome-flags-for-tools.mdhttps://github.com/GoogleChrome/chrome-launcher/blob/main/docs/chrome-flags-for-tools.md

Add_argument()

作用：用于向浏览器启动时传递命令行参数。

特点：直接修改浏览器的启动参数。

参数是浏览器原生支持的，通常可以在浏览器的官方文档中找到。

添加方式

#selenium支持chrome edge firefox safari四种类型的浏览器
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
#其余三种类型的webdriver的Options导入
# from selenium.webdriver.chrome.options import Options
# from selenium.webdriver.firefox.options import Options
# from selenium.webdriver.safari.options import Options#向options添加命令行参数
options=Options()
options.add_argument('字符串参数')#四种类型的webdriver,options需要与其导入时的webdriver类型一致
#否则打开的webdriver为options所属
browser=webdriver.Edge((options=options)
# browser=webdriver.ChromiumEdge(options=options)
# browser=webdriver.Chrome(options=options)
# browser=webdriver.Firefox(options=options)
# browser=webdriver.Safari(options=options)

这里需要注意的是，若你使用Edge的webdriver来进行自动化的话，那么webdriver使用ChromiumEdge与Edge以及Options使用edge.options都可以，因为Edge本身是基于chromium内核的。

常用参数

--allow-external-pages	允许在 Web 测试期间访问外部页面。
--auto-accept-camera-and-microphone-capture	绕过提示用户提供拍摄摄像头和麦克风权限的对话框(自动接受)。在视频会议或其他涉及到调用摄像头和麦克风权限 Web 应用程序自动测试中有用。
--auto-accept-this-tab-capture	此标志使 Chrome 自动接受/拒绝捕获当前标签页的请求。只应用于测试
--auto-grant-captured-surface-control-prompt	跳过 Captured Surface Control 的权限提示
--auto-open-devtools-for-tabs	自动打开当前Webdriver内每个网站标签页的开发者工具
--autoreplay-policy=no-replay --autoreplay-policy=default --autoreplay-policy=replayable-only	用于设置浏览器在遇到网络错误时的重试策略，即测试网络请求失败时的页面行为。 default:默认值。重试一次。 no-replay：禁用自动重试，遇到网络错误时直接失败。 `replayable-only`：仅对可重试的请求（如 GET 请求）进行重试，而对非重试请求（如 POST 请求）则直接失败。
--bypass-installable-message-throttle-for-testing	绕过 PWA（Progressive Web App）安装提示的节流机制。
--disable-auto-reload	禁用错误页面的自动重新加载。
--disable-background-media-suspend	不要立即暂停后台选项卡中正在播放的媒体。
--disable-gpu	禁用 GPU 硬件加速。如果未安装软件渲染器，则 GPU 进程不会启动。在无头模式下用到。
--disable-input-event-activation-protection	Chromium 浏览器有一个内置的保护机制，用于防止某些输入事件（如点击）被意外触发。例如：防止页面在加载过程中意外触发点击事件。防止广告或弹窗拦截用户的点击操作。该命令行的作用是禁用这种保护机制，允许输入事件（如点击）在任何情况下都能触发。
--disable-audio-output	禁用音频输出。浏览器不会播放任何声音，即使网页中包含音频或视频内容
--disable-pdf-plugin	禁用内置的 PDF 插件，使用外部程序打开 PDF。
--disable-virtual-keyboard	禁用网页内的虚拟键盘。
--disable-volume-adjust-sound	禁用音量调整提示音，调整音量时'嘟'的声音不再出现。
--disable-blink-features=AutomationControlled	禁用自动化控制相关的 Blink 功能。以此来绕过反自动化检测，防止网站限制
--disable-blink-feature=PreferHtmlOverPlugins	强制使用 HTML5 内容，避免依赖过时的插件。如果Flash。
--disable-cookies	禁用所有cookie。
--disable-third-party-cookie	禁用第三方 cookie。
--disable-translate	禁用自动翻译。
--disable-infobars	禁用信息栏（包括自动化提示栏）
--disable-geolocation	禁用地理位置。
--disable-extentions	禁用浏览器扩展。
--disable-popup-blocking	禁用窗口弹出拦截功能。
--disable-logging	禁用浏览器日志记录功能。
--deny-permission-prompts	webdriver会自动拒绝所有权限请求，包括地理位置、摄像头、麦克风、通知等。
--enable-auto-reload	当浏览器检测到页面内容发生变化（如文件修改）时，会自动刷新页面。
--enable-automation	`--enable-automation` 参数通常与 `excludeSwitches` 一起使用，以隐藏自动化提示栏。
--enable-logging	启用浏览器日志记录功能。
--enable-features=ParallelDownloading	启用文件并行下载功能，提升下载速度。
--enable-strict-mixed-content-checking	启用严格的混合内容检查，阻止不安全的 HTTP 资源加载,增强网页安全性。
--enable-features=IsolateOrigins	启用源隔离功能，进一步隔离不同源的网页内容,增强网页安全性和隐私保护。
--enable-site-per-process	启用站点隔离功能，每个站点运行在独立的进程中,增强网页安全性和稳定性。
--force-media-suspend	强制暂停媒体播放。
--force-device-scale=1.5	强制设置设备的缩放比例为150%。
--force-dark-mode	强制启用深色模式,网站需要支持深色模式才有用。
--guest	访客模式,此时webdriver收藏夹不可用，且不保存浏览记录。
--headless	开启无头模式
--ignore-ssl-errosr	忽略ssl错误
--ignore-certificate-errors	忽略证书错误
--mute-audio	禁用所有音频,浏览器不会播放任何声音，即使网页中包含音频或视频内容。
--no-sandbox	禁用沙箱模式,通常在无头模式下使用
--proxy-server	添加代理
--start-maximized	webdriver启动时窗口最大化
--start-fullscreen	webdriver启动后开启全屏模式(按下F11)
--user-agent	伪装不同设备上的浏览器,绕过某些网站对特定浏览器或设备的访问限制。
--window-position=x轴横坐标,y轴横坐标	设定打开的webdriver的窗口位置
--window-size=height,width	设定打开的webdriver的窗口大小

说明:上表参数只需要按照字符串的格式加上引号之后直接复制粘贴到add_argument方法内,webdriver启动后便会带有相应的特性，如无响应可能是浏览器版本问题。

Add_experimental_option()

作用：用于设置浏览器的实验性选项或偏好设置（preferences）。

特点：通常用于修改 webdriver的 prefs 或 excludeswitches等实验性选项。

这些选项不全是浏览器原生支持的，部分需要通过 Selenium 提供的接口来设置的。

添加方式

与add_argument导入方式一致,唯一区别在于使用的是add_experimental_option()方法,且使用方法较为灵活。

#selenium支持chrome edge firefox safari的四种类型的浏览器
from selenium import webdriver
from selenium.webdriver.edge.options import Options
#其余三种类型的webdriver的Options导入
# from selenium.webdriver.chrome.options import Options
# from selenium.webdriver.firefox.options import Options
# from selenium.webdriver.safari.options import Options
#向options添加命令行参数
options=Options()
options.add_experimental_option()#四种类型的webdriver,options需要与其导入时的webdriver类型一致
#否则打开的webdriver为options所属
browser=webdriver.Edge(options=options)
# browser=webdriver.ChromiumEdge(options=options)
# browser=webdriver.Chrome(options=options)
# browser=webdriver.Firefox(options=options)
# browser=webdriver.Safari(options=options)

常用方法

任务结束后仍然保持浏览器打开

options.add_experimental_option('detach',True)

将 detach 参数设置为 true后, 只要不向driver发送quit命令, 就可以在任务结束后仍然保持浏览器打开。

禁用“Chrome 正受到自动测试软件的控制”提示

options.add_experimental_option("excludeSwitches", ["enable-automation"])  # 禁用自动化提示
options.add_experimental_option("useAutomationExtension", False)  # 禁用自动化扩展

设置下载路径

prefs = {"download.default_directory": "/path/to/download",  # 设置下载路径"download.prompt_for_download": False,  # 禁用下载提示"download.directory_upgrade": True,  # 允许下载路径升级"profile.default_content_setting_values.automatic_downloads": True  #允许多文件下载"safebrowsing.enabled": True  # 启用安全浏览
}
options.add_experimental_option("prefs",prefs)

禁用弹窗拦截

prefs = {"profile.default_content_setting_values.popups": 1  # 允许弹窗
}
options.add_experimental_option("prefs",prefs)

禁用图片加载

prefs = {"profile.managed_default_content_settings.images": 2  # 2 表示禁用图片加载
}
options.add_experimental_option("prefs",prefs)

禁用 JavaScript

prefs = {"profile.managed_default_content_settings.javascript": 2  # 2 表示禁用 JavaScript
}
options.add_experimental_option("prefs",prefs)

注意

当我们向webdriver中传入options时，应该保证导入的Options所属的webdriver与所使用的webdriver一致,否则打开的webdriver以Options所属为准。

比如:我们的webdriver为Edge,Options从chrome导入


from selenium import webdriver
from selenium.webdriver.chrome.options import Options#导入chrome浏览器的Options类
options=Options()
options.add_argument('--disable-blink-features=AutomationControlled')
options.add_argument('--disable-logging')
options.add_argument('--ignore-ssl-errosr')#忽略ssl错误
options.add_argument('--ignore-certificate-errors')#忽略证书错误
options.add_experimental_option('excludeSwitches', ['enable-logging'])#禁用日志
options.add_experimental_option('excludeSwitches',['enable-automation'])#隐藏自动化控制
options.add_experimental_option('detach',True)
browser=webdriver.Edge(options)#使用Edge webdriver
browser.get('https://bot.sannysoft.com/')

启动的是chrome的webdriver

引言

说明

Add_argument()

添加方式

常用参数

Add_experimental_option()

添加方式

常用方法

任务结束后仍然保持浏览器打开

禁用“Chrome 正受到自动测试软件的控制”提示

设置下载路径

禁用弹窗拦截

禁用图片加载

禁用 JavaScript

注意

相关文章：