mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
更新readme
This commit is contained in:
parent
6cd52a33b5
commit
af675c8a8e
130
README.en.md
130
README.en.md
@ -1005,6 +1005,24 @@ Parameter Description:
|
|||||||
|
|
||||||
Returns the last sibling element object.
|
Returns the last sibling element object.
|
||||||
|
|
||||||
|
### parents
|
||||||
|
|
||||||
|
parents(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
Returns the Nth-level parent element object.
|
||||||
|
|
||||||
|
### nexts
|
||||||
|
|
||||||
|
nexts(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
Returns the next N sibling element objects.
|
||||||
|
|
||||||
|
### prevs
|
||||||
|
|
||||||
|
prevs(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
Return the first N sibling element objects.
|
||||||
|
|
||||||
### size
|
### size
|
||||||
|
|
||||||
Returns the element size as a dictionary.
|
Returns the element size as a dictionary.
|
||||||
@ -1213,6 +1231,24 @@ Parameter Description:
|
|||||||
|
|
||||||
Returns the last sibling element object.
|
Returns the last sibling element object.
|
||||||
|
|
||||||
|
### parents
|
||||||
|
|
||||||
|
parents(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
Returns the Nth-level parent element object.
|
||||||
|
|
||||||
|
### nexts
|
||||||
|
|
||||||
|
nexts(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
Returns the next N sibling element objects.
|
||||||
|
|
||||||
|
### prevs
|
||||||
|
|
||||||
|
prevs(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
Return the first N sibling element objects.
|
||||||
|
|
||||||
### ele
|
### ele
|
||||||
|
|
||||||
ele(loc_or_str: Union[tuple, str], mode: str = None, show_errmsg: bool = False) -> Union[SessionElement, List[SessionElement], None]
|
ele(loc_or_str: Union[tuple, str], mode: str = None, show_errmsg: bool = False) -> Union[SessionElement, List[SessionElement], None]
|
||||||
@ -1365,33 +1401,109 @@ Parameter Description:
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Useful methods
|
- ## easy_set methods
|
||||||
|
|
||||||
|
The configuration of chrome is too difficult to remember, so the commonly used configuration is written as a simple method, and the call will modify the relevant content of the ini file.
|
||||||
|
|
||||||
### set_paths
|
### set_paths
|
||||||
|
|
||||||
set_paths(driver_path: str = None, chrome_path: str = None, debugger_address: str = None, global_tmp_path: str = None, download_path: str = None, check_version: bool = True) -> None
|
set_paths(driver_path: str = None, chrome_path: str = None, debugger_address: str = None, global_tmp_path: str = None, download_path: str = None, user_data_path: str = None, cache_path: str = None, check_version: bool = True) -> None
|
||||||
|
|
||||||
Convenient way to set the path, save the incoming path to the default ini file, and check whether the chrome and chromedriver versions match.
|
Convenient way to set the path, save the incoming path to the default ini file, and check whether the chrome and chromedriver versions match.
|
||||||
|
|
||||||
Parameter Description:
|
Parameter Description:
|
||||||
|
|
||||||
- driver_path - chromedriver.exe path
|
- driver_path - the path of chromedriver.exe
|
||||||
- chrome_path - chrome.exe path
|
- chrome_path - the path of chrome.exe
|
||||||
- debugger_address - Debug browser address, for example: 127.0.0.1:9222
|
- debugger_address - Debug browser address, eg. 127.0.0.1:9222
|
||||||
- download_path - Download path
|
- download_path - File download path
|
||||||
- global_tmp_path - Temporary folder path
|
- global_tmp_path - Temporary folder path
|
||||||
|
- user_data_path - User data path
|
||||||
|
- cache_path - Cache path
|
||||||
- check_version - Whether to check whether chromedriver and chrome match
|
- check_version - Whether to check whether chromedriver and chrome match
|
||||||
|
|
||||||
|
### set_value_argument
|
||||||
|
|
||||||
|
set_value_argument(arg: str, value: str) -> None
|
||||||
|
|
||||||
|
Set valued attributes.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- arg - Attribute name
|
||||||
|
- value - Attribute value
|
||||||
|
|
||||||
|
### set_argument
|
||||||
|
|
||||||
|
set_argument(arg: str, on_off: bool) -> None
|
||||||
|
|
||||||
|
Set an attribute with no value.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- arg - Attribute name
|
||||||
|
- on_off - On or off
|
||||||
|
|
||||||
### set_headless
|
### set_headless
|
||||||
|
|
||||||
set_headless(on_off: bool) -> None
|
set_headless(on_off: bool) -> None
|
||||||
|
|
||||||
Convenient headless switch.
|
Turn headless mode on or off.
|
||||||
|
|
||||||
Parameter Description:
|
Parameter Description:
|
||||||
|
|
||||||
- on_off - Whether to enable headless mode
|
- on_off - Whether to enable headless mode
|
||||||
|
|
||||||
|
### set_no_imgs
|
||||||
|
|
||||||
|
set_no_imgs(on_off: bool) -> None
|
||||||
|
|
||||||
|
Turn the picture display on or off.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- on_off - Whether to enable no-picture mode
|
||||||
|
|
||||||
|
### set_no_js
|
||||||
|
|
||||||
|
set_no_js(on_off: bool) -> None
|
||||||
|
|
||||||
|
Turn JS mode on or off.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- on_off - Whether to enable or disable JS mode
|
||||||
|
|
||||||
|
### set_mute
|
||||||
|
|
||||||
|
set_mute(on_off: bool) -> None
|
||||||
|
|
||||||
|
Turn silent mode on or off.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- on_off - Whether to turn on silent mode
|
||||||
|
|
||||||
|
### set_user_agent
|
||||||
|
|
||||||
|
set_user_agent(user_agent: str) -> None:
|
||||||
|
|
||||||
|
Set user_agent.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- user_agent - user_agent value
|
||||||
|
|
||||||
|
### set_proxy
|
||||||
|
|
||||||
|
set_proxy(proxy: str) -> None
|
||||||
|
|
||||||
|
Set up the proxy.
|
||||||
|
|
||||||
|
Parameter Description:
|
||||||
|
|
||||||
|
- proxy - Proxy value
|
||||||
|
|
||||||
### check_driver_version
|
### check_driver_version
|
||||||
|
|
||||||
check_driver_version(driver_path: str = None, chrome_path: str = None) -> bool
|
check_driver_version(driver_path: str = None, chrome_path: str = None) -> bool
|
||||||
@ -1400,5 +1512,5 @@ Parameter Description:
|
|||||||
|
|
||||||
Parameter Description:
|
Parameter Description:
|
||||||
|
|
||||||
- driver_path - chromedriver.exe path
|
- driver_path - the path of chromedriver.exe
|
||||||
- chrome_path - chrome.exe path
|
- chrome_path - the path of chrome.exe
|
118
README.zh-cn.md
118
README.zh-cn.md
@ -1001,6 +1001,24 @@ driver模式的元素对象,包装了一个WebElement对象,并封装了常
|
|||||||
|
|
||||||
返回上一个兄弟元素对象。
|
返回上一个兄弟元素对象。
|
||||||
|
|
||||||
|
### parents
|
||||||
|
|
||||||
|
parents(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
返回第N层父级元素对象。
|
||||||
|
|
||||||
|
### nexts
|
||||||
|
|
||||||
|
nexts(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
返回下N个兄弟元素对象。
|
||||||
|
|
||||||
|
### prevs
|
||||||
|
|
||||||
|
prevs(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
返回前N个兄弟元素对象。
|
||||||
|
|
||||||
### size
|
### size
|
||||||
|
|
||||||
以字典方式返回元素大小。
|
以字典方式返回元素大小。
|
||||||
@ -1209,6 +1227,24 @@ session模式的元素对象,包装了一个Element对象,并封装了常用
|
|||||||
|
|
||||||
返回上一个兄弟元素对象。
|
返回上一个兄弟元素对象。
|
||||||
|
|
||||||
|
### parents
|
||||||
|
|
||||||
|
parents(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
返回第N层父级元素对象。
|
||||||
|
|
||||||
|
### nexts
|
||||||
|
|
||||||
|
nexts(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
返回下N个兄弟元素对象。
|
||||||
|
|
||||||
|
### prevs
|
||||||
|
|
||||||
|
prevs(num: int = 1) -> Union[DriverElement, None]
|
||||||
|
|
||||||
|
返回前N个兄弟元素对象。
|
||||||
|
|
||||||
### ele
|
### ele
|
||||||
|
|
||||||
ele(loc_or_str: Union[tuple, str], mode: str = None, show_errmsg: bool = False) -> Union[SessionElement, List[SessionElement], None]
|
ele(loc_or_str: Union[tuple, str], mode: str = None, show_errmsg: bool = False) -> Union[SessionElement, List[SessionElement], None]
|
||||||
@ -1361,11 +1397,13 @@ session模式的元素对象,包装了一个Element对象,并封装了常用
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 有用的方法
|
## easy_set方法
|
||||||
|
|
||||||
|
chrome的配置太难记,所以把常用的配置写成简单的方法,调用会修改ini文件相关内容。
|
||||||
|
|
||||||
### set_paths
|
### set_paths
|
||||||
|
|
||||||
set_paths(driver_path: str = None, chrome_path: str = None, debugger_address: str = None, global_tmp_path: str = None, download_path: str = None, check_version: bool = True) -> None
|
set_paths(driver_path: str = None, chrome_path: str = None, debugger_address: str = None, global_tmp_path: str = None, download_path: str = None, user_data_path: str = None, cache_path: str = None, check_version: bool = True) -> None
|
||||||
|
|
||||||
便捷的设置路径方法,把传入的路径保存到默认ini文件,并检查chrome和chromedriver版本是否匹配。
|
便捷的设置路径方法,把传入的路径保存到默认ini文件,并检查chrome和chromedriver版本是否匹配。
|
||||||
|
|
||||||
@ -1376,18 +1414,92 @@ session模式的元素对象,包装了一个Element对象,并封装了常用
|
|||||||
- debugger_address - 调试浏览器地址,例:127.0.0.1:9222
|
- debugger_address - 调试浏览器地址,例:127.0.0.1:9222
|
||||||
- download_path - 下载文件路径
|
- download_path - 下载文件路径
|
||||||
- global_tmp_path - 临时文件夹路径
|
- global_tmp_path - 临时文件夹路径
|
||||||
|
- user_data_path - 用户数据路径
|
||||||
|
- cache_path - 缓存路径
|
||||||
- check_version - 是否检查chromedriver和chrome是否匹配
|
- check_version - 是否检查chromedriver和chrome是否匹配
|
||||||
|
|
||||||
|
### set_value_argument
|
||||||
|
|
||||||
|
set_value_argument(arg: str, value: str) -> None
|
||||||
|
|
||||||
|
设置有值的属性。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- arg - 属性名
|
||||||
|
- value - 属性值
|
||||||
|
|
||||||
|
### set_argument
|
||||||
|
|
||||||
|
set_argument(arg: str, on_off: bool) -> None
|
||||||
|
|
||||||
|
设置没有值的属性。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- arg - 属性名
|
||||||
|
- on_off - 开或关
|
||||||
|
|
||||||
### set_headless
|
### set_headless
|
||||||
|
|
||||||
set_headless(on_off: bool) -> None
|
set_headless(on_off: bool) -> None
|
||||||
|
|
||||||
便捷的headless开关。
|
开启或关闭headless模式。
|
||||||
|
|
||||||
参数说明:
|
参数说明:
|
||||||
|
|
||||||
- on_off - 是否开启headless模式
|
- on_off - 是否开启headless模式
|
||||||
|
|
||||||
|
### set_no_imgs
|
||||||
|
|
||||||
|
set_no_imgs(on_off: bool) -> None
|
||||||
|
|
||||||
|
开启或关闭图片显示。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- on_off - 是否开启无图模式
|
||||||
|
|
||||||
|
### set_no_js
|
||||||
|
|
||||||
|
set_no_js(on_off: bool) -> None
|
||||||
|
|
||||||
|
开启或关闭禁用JS模式。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- on_off - 是否开启禁用JS模式
|
||||||
|
|
||||||
|
### set_mute
|
||||||
|
|
||||||
|
set_mute(on_off: bool) -> None
|
||||||
|
|
||||||
|
开启或关闭静音模式。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- on_off - 是否开启静音模式
|
||||||
|
|
||||||
|
### set_user_agent
|
||||||
|
|
||||||
|
set_user_agent(user_agent: str) -> None:
|
||||||
|
|
||||||
|
设置user_agent。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- user_agent - user_agent值
|
||||||
|
|
||||||
|
### set_proxy
|
||||||
|
|
||||||
|
set_proxy(proxy: str) -> None
|
||||||
|
|
||||||
|
设置代理。
|
||||||
|
|
||||||
|
参数说明:
|
||||||
|
|
||||||
|
- proxy - 代理值
|
||||||
|
|
||||||
### check_driver_version
|
### check_driver_version
|
||||||
|
|
||||||
check_driver_version(driver_path: str = None, chrome_path: str = None) -> bool
|
check_driver_version(driver_path: str = None, chrome_path: str = None) -> bool
|
||||||
|
Loading…
x
Reference in New Issue
Block a user