DrissionPage/docs/APIs/easy_set 方法.md
2021-12-10 19:02:42 +08:00

129 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

chrome 配置太复杂,所以把常用的配置写成简单的方法,调用会修改 ini 文件相关内容。
### get_match_driver()
自动识别 chrome 版本并下载匹配的driver。获取 ini 文件记录的 chrome.exe 路径,若没有则获取系统变量中的。
参数说明:
- ini_path: str - 要读取和修改的 ini 文件路径
- save_path: str - chromedriver 保存路径
返回: None
### show_settings()
打印 ini 文件中所有配置信息。
参数说明:
- ini_path: str - ini 文件路径,为 None 则读取默认 ini 文件
返回: None
### set_paths()
便捷的设置路径方法,把传入的路径保存到 ini 文件,并检查 chrome 和 chromedriver 版本是否匹配。
参数说明:
- driver_path: str - chromedriver.exe 路径
- chrome_path: str - chrome.exe 路径
- debugger_address: str - 调试浏览器地址127.0.0.1:9222
- download_path: str - 下载文件路径
- tmp_path: str - 临时文件夹路径
- user_data_path: str - 用户数据路径
- cache_path: str - 缓存路径
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
- check_version: bool - 是否检查 chromedriver 和 chrome 是否匹配
返回: None
### set_argument()
设置属性。若属性无值(如 'zh_CN.UTF-8' value 传入 bool 表示开关;否则把 value 赋值给属性,当 value 为 '' 或 False删除该属性项。
参数说明:
- arg: str - 属性名
- value: [bool, str] - 属性值,有值的属性传入值,没有的传入 bool
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### set_headless()
开启或关闭 headless 模式。
参数说明:
- on_off: bool - 是否开启 headless 模式
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### set_no_imgs()
开启或关闭图片显示。
参数说明:
- on_off: bool - 是否开启无图模式
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### set_no_js()
开启或关闭禁用 JS 模式。
参数说明:
- on_off: bool - 是否开启禁用 JS 模式
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### set_mute()
开启或关闭静音模式。
参数说明:
- on_off: bool - 是否开启静音模式
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### set_user_agent()
设置 user_agent。
参数说明:
- user_agent: str - user_agent 值
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### set_proxy()
设置代理。
参数说明:
- proxy: str - 代理值
- ini_path: str - ini 文件路径,为 None 则保存到默认 ini 文件
返回: None
### check_driver_version()
检查 chrome 与 chromedriver 版本是否匹配。
参数说明:
- driver_path: bool - chromedriver.exe 路径
- chrome_path: bool - chrome.exe 路径
返回: bool