mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
修改文档
This commit is contained in:
g1879
parent
132d24a685
commit
8b843878c2
@ -3,10 +3,9 @@
|
||||
# get()
|
||||
|
||||
该方法在 d 模式和 s 模式下都可用，用于跳转到一个网址。
|
||||
当连接失败时，程序默认重试 3 次，每次间隔 2 秒，也可以通过参数设置重试次数和间隔。
|
||||
如果目标 url 和当前 url 一致，程序默认不跳转，可通过参数强制跳转。
|
||||
当连接失败时，程序默认重试 3 次，每次间隔 2 秒，也可以通过参数设置重试次数和间隔。
|
||||
在 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 秒
|
||||
- **kwargs：连接参数，s 模式专用
|
||||
|
||||
?> **Tips:** <br>
|
||||
虽然参数里没有`json`参数，但也和 requests 一样可以对`json`参数传值。
|
||||
?> **Tips:** <br>虽然参数里没有`json`参数，但也和 requests 一样可以对`json`参数传值。
|
||||
|
||||
```python
|
||||
from DrissionPage import MixPage
|
||||
@ -93,8 +91,6 @@ page.post(url, json='xxx')
|
||||
page.post(url, json={'xxx': 'xxx'})
|
||||
```
|
||||
|
||||
|
||||
|
||||
# 其它请求方式
|
||||
|
||||
本库只针对常用的 get 和 post 方式作了优化，但也可以通过提取页面对象内的`Session`对象以原生 requests 代码方式执行其它请求方式。当然，它们工作在 s 模式。
|
||||
|
||||
@ -4,13 +4,11 @@
|
||||
|
||||
## get()
|
||||
|
||||
此方法用于跳转到一个 url，详细用法见“[使用方法 -> 访问网页](访问网页.md)”章节。
|
||||
|
||||
|
||||
此方法用于跳转到一个 url，详细用法见“[使用方法 -> 访问网页](使用方法/访问网页.md)”章节。
|
||||
|
||||
## ele()、eles()、s_ele()、s_eles()
|
||||
|
||||
这些方法用于在页面中查找元素，详细用法见“[使用方法 -> 查找页面元素](查找页面元素)”章节。
|
||||
这些方法用于在页面中查找元素，详细用法见“[使用方法 -> 查找页面元素](使用方法/查找页面元素)”章节。
|
||||
|
||||
## change_mode()
|
||||
|
||||
@ -19,6 +17,8 @@
|
||||
|
||||
!> **注意：** <br>s 模式转 d 模式时，若浏览器当前网址域名和 s 模式不一样，必定会跳转。
|
||||
|
||||
|
||||
|
||||
参数：
|
||||
|
||||
- mode：目标模式字符串，`'s'`或`'d'`，默认转换到另一种
|
||||
@ -62,8 +62,6 @@ print('登录后title：', page.title)
|
||||
登录后title： 个人资料 - 码云 Gitee.com
|
||||
```
|
||||
|
||||
|
||||
|
||||
## set_cookies()
|
||||
|
||||
此方法用于设置`cookies`。
|
||||
@ -81,8 +79,6 @@ cookies = {'name': 'abc'}
|
||||
page.set_cookies(cookies)
|
||||
```
|
||||
|
||||
|
||||
|
||||
## cookies_to_session()
|
||||
|
||||
此方法用于从`WebDriver`对象复制`cookies`到`Session`对象。
|
||||
@ -93,8 +89,6 @@ page.set_cookies(cookies)
|
||||
|
||||
返回：`None`
|
||||
|
||||
|
||||
|
||||
## cookies_to_driver()
|
||||
|
||||
此方法用于从`Session`对象复制`cookies`到`WebDriver`对象。
|
||||
@ -105,14 +99,10 @@ page.set_cookies(cookies)
|
||||
|
||||
返回：`None`
|
||||
|
||||
|
||||
|
||||
## download()
|
||||
|
||||
此方法用于下载文件，详细用法见“[使用方法 -> 下载文件](下载文件.md)”章节。
|
||||
|
||||
|
||||
|
||||
## close_driver()
|
||||
|
||||
此方法用于关闭`WebDriver`对象和浏览器。
|
||||
@ -167,11 +157,11 @@ page.set_cookies(cookies)
|
||||
|
||||
方法：
|
||||
|
||||
| 方法 | 参数说明 | 功能 |
|
||||
| :-------: | :------: | :-----------------: |
|
||||
| display() | 无 | 等待元素从 DOM 显示 |
|
||||
| hidden() | 无 | 等待元素从 DOM 隐藏 |
|
||||
| delete() | 无 | 等待元素从 DOM 删除 |
|
||||
| 方法 | 参数说明 | 功能 |
|
||||
|:---------:|:----:|:------------:|
|
||||
| display() | 无 | 等待元素从 DOM 显示 |
|
||||
| hidden() | 无 | 等待元素从 DOM 隐藏 |
|
||||
| delete() | 无 | 等待元素从 DOM 删除 |
|
||||
|
||||
这些方法返回布尔值，代表是否等待成功。
|
||||
|
||||
@ -242,15 +232,15 @@ page.run_script('alert(arguments[0]+arguments[1])', 'Hello', ' world!')
|
||||
调用此属性返回一个`ToFrame`对象，调用该对象的方法实现焦点转移。
|
||||
这些方法返回值为当前页面对象，可实现下一步的链式操作。
|
||||
|
||||
| 方法 | 参数说明 | 功能 |
|
||||
| :-------------: | :------------: | :--------------------------: |
|
||||
| main() | 无 | 切换到顶层框架 |
|
||||
| parent(level) | 第几层上级框架 | 切换到上级框架，可指定多层 |
|
||||
| by_id(id) | id 属性 | 切换到`id`为该参数的框架 |
|
||||
| by_name(name) | name 属性 | 切换到`name`为该参数的框架 |
|
||||
| by_index(index) | 序号 | 切换到页面第几个框架，0 开始 |
|
||||
| by_loc(loc) | 定位符 | 切换到定位符所指框架 |
|
||||
| by_ele(ele) | 框架元素 | 传入框架元素，切换到该框架 |
|
||||
| 方法 | 参数说明 | 功能 |
|
||||
|:---------------:|:-------:|:----------------:|
|
||||
| main() | 无 | 切换到顶层框架 |
|
||||
| parent(level) | 第几层上级框架 | 切换到上级框架，可指定多层 |
|
||||
| by_id(id) | id 属性 | 切换到`id`为该参数的框架 |
|
||||
| by_name(name) | name 属性 | 切换到`name`为该参数的框架 |
|
||||
| by_index(index) | 序号 | 切换到页面第几个框架，0 开始 |
|
||||
| by_loc(loc) | 定位符 | 切换到定位符所指框架 |
|
||||
| by_ele(ele) | 框架元素 | 传入框架元素，切换到该框架 |
|
||||
|
||||
```python
|
||||
# 切换到主框架
|
||||
@ -382,18 +372,18 @@ page.close_other_tabs(reserve_list)
|
||||
此属性用于以某种方式滚动页面。
|
||||
调用此属性返回一个`Scroll`对象，调用该对象方法实现各种方式的滚动。
|
||||
|
||||
| 方法 | 参数说明 | 功能 |
|
||||
| :---------------: | :----------: | :------------------------------: |
|
||||
| to_top() | 无 | 滚动到顶端，水平位置不变 |
|
||||
| to_bottom() | 无 | 滚动到底端，水平位置不变 |
|
||||
| to_half() | 无 | 滚动到垂直中间位置，水平位置不变 |
|
||||
| to_rightmost() | 无 | 滚动到最右边，垂直位置不变 |
|
||||
| to_leftmost() | 无 | 滚动到最左边，垂直位置不变 |
|
||||
| to_location(x, y) | 滚动条坐标值 | 滚动到指定位置 |
|
||||
| up(pixel) | 滚动的像素 | 向上滚动若干像素，水平位置不变 |
|
||||
| down(pixel) | 滚动的像素 | 向下滚动若干像素，水平位置不变 |
|
||||
| right(pixel) | 滚动的像素 | 向左滚动若干像素，垂直位置不变 |
|
||||
| left(pixel) | 滚动的像素 | 向右滚动若干像素，垂直位置不变 |
|
||||
| 方法 | 参数说明 | 功能 |
|
||||
|:-----------------:|:------:|:----------------:|
|
||||
| to_top() | 无 | 滚动到顶端，水平位置不变 |
|
||||
| to_bottom() | 无 | 滚动到底端，水平位置不变 |
|
||||
| to_half() | 无 | 滚动到垂直中间位置，水平位置不变 |
|
||||
| to_rightmost() | 无 | 滚动到最右边，垂直位置不变 |
|
||||
| to_leftmost() | 无 | 滚动到最左边，垂直位置不变 |
|
||||
| to_location(x, y) | 滚动条坐标值 | 滚动到指定位置 |
|
||||
| up(pixel) | 滚动的像素 | 向上滚动若干像素，水平位置不变 |
|
||||
| down(pixel) | 滚动的像素 | 向下滚动若干像素，水平位置不变 |
|
||||
| right(pixel) | 滚动的像素 | 向左滚动若干像素，垂直位置不变 |
|
||||
| left(pixel) | 滚动的像素 | 向右滚动若干像素，垂直位置不变 |
|
||||
|
||||
```python
|
||||
# 页面滚动到底部
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user