mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
186 lines
4.0 KiB
Markdown
186 lines
4.0 KiB
Markdown
为使浏览器设置更便利，本库扩展了`selenium.webdriver.chrome.options`的`Options`对象功能，创建了`DriverOptions`类，专门用于管理浏览器的启动配置。
|
||
|
||
!> **注意：** <br>
|
||
1、`DriverOptions`仅用于管理启动配置，浏览器启动后再修改无效。 <br>
|
||
2、若设置了`local_port`或`debugger_address`且浏览器未启动，则只有`arguments`、`driver_path`、`chrome_path`参数生效。 <br>
|
||
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)
|
||
```
|
||
|