diff --git a/docs/使用方法/访问网页.md b/docs/使用方法/访问网页.md index e6f7bc5..25a5f42 100644 --- a/docs/使用方法/访问网页.md +++ b/docs/使用方法/访问网页.md @@ -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:**
-虽然参数里没有`json`参数,但也和 requests 一样可以对`json`参数传值。 +?> **Tips:**
虽然参数里没有`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 模式。 diff --git a/docs/使用方法/页面操作.md b/docs/使用方法/页面操作.md index 0e5a3cb..7853115 100644 --- a/docs/使用方法/页面操作.md +++ b/docs/使用方法/页面操作.md @@ -4,13 +4,11 @@ ## get() -此方法用于跳转到一个 url,详细用法见“[使用方法 -> 访问网页](访问网页.md)”章节。 - - +此方法用于跳转到一个 url,详细用法见“[使用方法 -> 访问网页](使用方法/访问网页.md)”章节。 ## ele()、eles()、s_ele()、s_eles() -这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](查找页面元素)”章节。 +这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](使用方法/查找页面元素)”章节。 ## change_mode() @@ -19,6 +17,8 @@ !> **注意:**
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 # 页面滚动到底部