为使浏览器设置更便利,本库扩展了`selenium.webdriver.chrome.options`的`Options`对象功能,创建了`DriverOptions`类,专门用于管理浏览器的启动配置。
!> **注意:**
1、`DriverOptions`仅用于管理启动配置,浏览器启动后再修改无效。
2、若设置了`local_port`或`debugger_address`且浏览器未启动,则只有`arguments`、`driver_path`、`chrome_path`参数生效。
3、若设置了`local_port`或`debugger_address`且接管已有浏览器,只有`driver_path`参数生效。
# DriverOptions 类
`DriverOptions`类继承自`Options 类`,保留了原来所有功能,原生功能不在这里叙述,只介绍增加的功能。
对象创建时,可从配置文件中读取配置来进行初始化,不从文件读取则创建一个空配置对象。
该类绝大部分方法都支持链式操作。
初始化参数:
- read_file:是否从默认 ini 文件中读取配置信息
- ini_path:ini 文件路径,为`None`则读取默认 ini 文件
## driver_path
此属性返回 chromedriver 文件路径。
## chrome_path
此属性返回 Chrome 浏览器启动文件路径,即`binary_location`。
为空时程序会根据注册表或系统路径查找。
## set_paths()
该方法用于设置浏览器用到的几种路径信息。
参数:
- driver_path:chromedriver.exe 路径
- chrome_path:chrome.exe 路径
- local_port:本地端口号
- debugger_address:调试浏览器地址,会覆盖`local_port`设置,例:127.0.0.1:9222
- download_path:下载文件路径
- user_data_path:用户数据路径
- cache_path:缓存路径
返回:`None`
## save()
此方法用于保存当前配置对象的信息到配置文件。
参数:
- path:配置文件的路径,默认保存到当前读取的配置文件,传入`'default'`保存到默认 ini 文件
返回:配置文件绝对路径
## save_to_default()
此方法用于保存当前配置对象的信息到默认 ini 文件。
参数:无
返回:配置文件绝对路径
## remove_argument()
此方法用于移除一个`argument`项。
参数:
- value:设置项名称,带有值的设置项传入设置名称即可
返回:当前对象
## remove_experimental_option()
此方法用于移除一个实验设置,传入key值删除。
参数:
- key:实验设置的名称
返回:当前对象
## remove_all_extensions()
此方法用于移除所有插件。
参数:无
返回:当前对象
## set_argument()
此方法用于设置浏览器配置的`argument`属性。
参数:
- arg:属性名
- value:属性值,有值的属性传入值,没有的传入`bool`类型表示开关
返回:当前对象
## set_timeouts()
此方法用于设置三种超时时间,selenium 4 以上版本有效。
参数:
- implicit:查找元素超时时间
- pageLoad:页面加载超时时间
- script:脚本运行超时时间
返回:当前对象
## set_headless()
该方法用于设置是否已无头模式启动浏览器。
参数:
- on_off:`bool`类型,表示开或关
返回:None
## set_no_imgs()
该方法用于设置是否禁止加载图片。
参数:
- on_off:`bool`类型,表示开或关
返回:`None`
## set_mute()
该方法用于设置是否静音。
参数:
- on_off:`bool`类型,表示开或关
返回:None
## set_proxy()
该方法用于设置代理。
参数:
- proxy: 代理网址和端口,如 127.0.0.1:1080
返回:`None`
## set_user_agent()
该方法用于设置 user agent。
参数:
- user_agent:user agent文本
返回:`None`
## as_dict()
该方法以`dict`方式返回所有配置信息。
参数:无
返回:配置信息
# 简单示例
```python
from DrissionPage import MixPage
from DrissionPage.config import DriverOptions
# 创建配置对象(默认从 ini 文件中读取配置)
do = DriverOptions()
# 设置不加载图片、静音
do.set_no_imgs(True).set_mute(True)
# 以该配置创建页面对象
page = MixPage(driver_options=do)
```