mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
180 lines
4.0 KiB
Markdown
180 lines
4.0 KiB
Markdown
为使浏览器设置更便利，本库使用`DriverOptions`类，专门用于管理浏览器的启动配置。
|
||
|
||
!> **注意：** <br>1、`DriverOptions`仅用于管理启动配置，浏览器启动后再修改无效。 <br>2、若接管已打开的浏览器，则所有启动配置均无效。
|
||
|
||
# ✔️ `DriverOptions`类
|
||
|
||
`DriverOptions`类继承自 selenium 的`Options` 类，保留了原来所有功能，原生功能不在这里叙述，只介绍增加的功能。
|
||
对象创建时，可从配置文件中读取配置来进行初始化，不从文件读取则创建一个空配置对象。
|
||
该类绝大部分方法都支持链式操作。
|
||
|
||
**初始化参数：**
|
||
|
||
- `read_file`：是否从默认 ini 文件中读取配置信息
|
||
- `ini_path`：ini 文件路径，为`None`则读取默认 ini 文件
|
||
|
||
## 📍 `driver_path`
|
||
|
||
此属性返回 chromedriver 文件路径。`MixPage`使用，`WebPage`不需要。
|
||
|
||
## 📍 `chrome_path`
|
||
|
||
此属性返回 Chrome 浏览器启动文件路径，为空时程序会根据注册表或系统路径查找。
|
||
|
||
## 📍 `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()`
|
||
|
||
此方法用于设置三种超时时间。
|
||
|
||
**参数：**
|
||
|
||
- `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 WebPage, DriverOptions
|
||
|
||
# 创建配置对象（默认从 ini 文件中读取配置）
|
||
do = DriverOptions()
|
||
# 设置不加载图片、静音
|
||
do.set_no_imgs(True).set_mute(True)
|
||
|
||
# 以该配置创建页面对象
|
||
page = WebPage(driver_or_options=do)
|
||
```
|