修改文档

This commit is contained in:
g1879 2022-03-21 22:20:09 +08:00
parent 132d24a685
commit 8b843878c2
2 changed files with 33 additions and 47 deletions

View File

@ -4,9 +4,8 @@
该方法在 d 模式和 s 模式下都可用,用于跳转到一个网址。 该方法在 d 模式和 s 模式下都可用,用于跳转到一个网址。
当连接失败时,程序默认重试 3 次,每次间隔 2 秒,也可以通过参数设置重试次数和间隔。 当连接失败时,程序默认重试 3 次,每次间隔 2 秒,也可以通过参数设置重试次数和间隔。
如果目标 url 和当前 url 一致,程序默认不跳转,可通过参数强制跳转。
在 s 模式下,可传入连接参数,语法与 requests 的`get()`方法一致。 在 s 模式下,可传入连接参数,语法与 requests 的`get()`方法一致。
方法返回是否连接成功的布尔值s 模式下根据 Response 对象的`status_code`参数决定d 模式下根据浏览器的状态,还可以通过重写`check_page()`方法实现自定义检查方式。 方法返回是否连接成功的布尔值s 模式下根据`Response`对象的`status_code`参数决定d 模式下根据浏览器的状态,还可以通过重写`check_page()`方法实现自定义检查方式。
参数: 参数:
@ -63,8 +62,7 @@ page.get(url, headers=headers, cookies=cookies, proxies=proxies)
- interval重试间隔与页面对象的设置一致默认 2 秒 - interval重试间隔与页面对象的设置一致默认 2 秒
- **kwargs连接参数s 模式专用 - **kwargs连接参数s 模式专用
?> **Tips:** <br> ?> **Tips:** <br>虽然参数里没有`json`参数,但也和 requests 一样可以对`json`参数传值。
虽然参数里没有`json`参数,但也和 requests 一样可以对`json`参数传值。
```python ```python
from DrissionPage import MixPage from DrissionPage import MixPage
@ -93,8 +91,6 @@ page.post(url, json='xxx')
page.post(url, json={'xxx': 'xxx'}) page.post(url, json={'xxx': 'xxx'})
``` ```
# 其它请求方式 # 其它请求方式
本库只针对常用的 get 和 post 方式作了优化,但也可以通过提取页面对象内的`Session`对象以原生 requests 代码方式执行其它请求方式。当然,它们工作在 s 模式。 本库只针对常用的 get 和 post 方式作了优化,但也可以通过提取页面对象内的`Session`对象以原生 requests 代码方式执行其它请求方式。当然,它们工作在 s 模式。

View File

@ -4,13 +4,11 @@
## get() ## get()
此方法用于跳转到一个 url详细用法见“[使用方法 -> 访问网页](访问网页.md)”章节。 此方法用于跳转到一个 url详细用法见“[使用方法 -> 访问网页](使用方法/访问网页.md)”章节。
## ele()、eles()、s_ele()、s_eles() ## ele()、eles()、s_ele()、s_eles()
这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](查找页面元素)”章节。 这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](使用方法/查找页面元素)”章节。
## change_mode() ## change_mode()
@ -19,6 +17,8 @@
!> **注意:** <br>s 模式转 d 模式时,若浏览器当前网址域名和 s 模式不一样,必定会跳转。 !> **注意:** <br>s 模式转 d 模式时,若浏览器当前网址域名和 s 模式不一样,必定会跳转。
参数: 参数:
- mode目标模式字符串`'s'``'d'`,默认转换到另一种 - mode目标模式字符串`'s'``'d'`,默认转换到另一种
@ -62,8 +62,6 @@ print('登录后title', page.title)
登录后title 个人资料 - 码云 Gitee.com 登录后title 个人资料 - 码云 Gitee.com
``` ```
## set_cookies() ## set_cookies()
此方法用于设置`cookies` 此方法用于设置`cookies`
@ -81,8 +79,6 @@ cookies = {'name': 'abc'}
page.set_cookies(cookies) page.set_cookies(cookies)
``` ```
## cookies_to_session() ## cookies_to_session()
此方法用于从`WebDriver`对象复制`cookies``Session`对象。 此方法用于从`WebDriver`对象复制`cookies``Session`对象。
@ -93,8 +89,6 @@ page.set_cookies(cookies)
返回:`None` 返回:`None`
## cookies_to_driver() ## cookies_to_driver()
此方法用于从`Session`对象复制`cookies``WebDriver`对象。 此方法用于从`Session`对象复制`cookies``WebDriver`对象。
@ -105,14 +99,10 @@ page.set_cookies(cookies)
返回:`None` 返回:`None`
## download() ## download()
此方法用于下载文件,详细用法见“[使用方法 -> 下载文件](下载文件.md)”章节。 此方法用于下载文件,详细用法见“[使用方法 -> 下载文件](下载文件.md)”章节。
## close_driver() ## close_driver()
此方法用于关闭`WebDriver`对象和浏览器。 此方法用于关闭`WebDriver`对象和浏览器。
@ -168,7 +158,7 @@ page.set_cookies(cookies)
方法: 方法:
| 方法 | 参数说明 | 功能 | | 方法 | 参数说明 | 功能 |
| :-------: | :------: | :-----------------: | |:---------:|:----:|:------------:|
| display() | 无 | 等待元素从 DOM 显示 | | display() | 无 | 等待元素从 DOM 显示 |
| hidden() | 无 | 等待元素从 DOM 隐藏 | | hidden() | 无 | 等待元素从 DOM 隐藏 |
| delete() | 无 | 等待元素从 DOM 删除 | | delete() | 无 | 等待元素从 DOM 删除 |
@ -243,7 +233,7 @@ page.run_script('alert(arguments[0]+arguments[1])', 'Hello', ' world!')
这些方法返回值为当前页面对象,可实现下一步的链式操作。 这些方法返回值为当前页面对象,可实现下一步的链式操作。
| 方法 | 参数说明 | 功能 | | 方法 | 参数说明 | 功能 |
| :-------------: | :------------: | :--------------------------: | |:---------------:|:-------:|:----------------:|
| main() | 无 | 切换到顶层框架 | | main() | 无 | 切换到顶层框架 |
| parent(level) | 第几层上级框架 | 切换到上级框架,可指定多层 | | parent(level) | 第几层上级框架 | 切换到上级框架,可指定多层 |
| by_id(id) | id 属性 | 切换到`id`为该参数的框架 | | by_id(id) | id 属性 | 切换到`id`为该参数的框架 |
@ -383,7 +373,7 @@ page.close_other_tabs(reserve_list)
调用此属性返回一个`Scroll`对象,调用该对象方法实现各种方式的滚动。 调用此属性返回一个`Scroll`对象,调用该对象方法实现各种方式的滚动。
| 方法 | 参数说明 | 功能 | | 方法 | 参数说明 | 功能 |
| :---------------: | :----------: | :------------------------------: | |:-----------------:|:------:|:----------------:|
| to_top() | 无 | 滚动到顶端,水平位置不变 | | to_top() | 无 | 滚动到顶端,水平位置不变 |
| to_bottom() | 无 | 滚动到底端,水平位置不变 | | to_bottom() | 无 | 滚动到底端,水平位置不变 |
| to_half() | 无 | 滚动到垂直中间位置,水平位置不变 | | to_half() | 无 | 滚动到垂直中间位置,水平位置不变 |