mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
修改文档
This commit is contained in:
parent
01834e32c8
commit
dc01451c05
@ -14,8 +14,7 @@ page.get_cookies(all_domains=True)
|
|||||||
page.set_cookies(cookies)
|
page.set_cookies(cookies)
|
||||||
```
|
```
|
||||||
|
|
||||||
**Tips:**
|
?> **Tips:** <br>
|
||||||
|
d 模式设置`cookies`后要刷新页面才能看到效果。 <br>
|
||||||
- d 模式设置`cookies`后要刷新页面才能看到效果。
|
s 模式可在 ini 文件、`SessionOptions`、配置字典中设置`cookies`,在`MixPage`初始化时即可传入,d 模式只能用`set_cookies()`函数设置。
|
||||||
- s 模式可在 ini 文件、`SessionOptions`、配置字典中设置`cookies`,在`MixPage`初始化时即可传入,d 模式只能用`set_cookies()`函数设置。
|
|
||||||
|
|
||||||
|
@ -2,11 +2,11 @@
|
|||||||
默认情况下,`MixPage`对象启动时自动加载文件中的配置信息。
|
默认情况下,`MixPage`对象启动时自动加载文件中的配置信息。
|
||||||
也可以在默认配置基础上用简单的方法再次修改,再保存到 ini 文件。
|
也可以在默认配置基础上用简单的方法再次修改,再保存到 ini 文件。
|
||||||
也可以保存多个 ini 文件,按不同项目须要调用。
|
也可以保存多个 ini 文件,按不同项目须要调用。
|
||||||
**注意:**
|
|
||||||
|
|
||||||
- ini 文件仅用于管理启动配置,浏览器或`Session`创建后再修改 ini 文件内容是没有效果的。
|
!> **注意:** <br>
|
||||||
- 如果是接管已打开的浏览器,这些设置也没有用。
|
ini 文件仅用于管理启动配置,浏览器或`Session`创建后再修改 ini 文件内容是没有效果的。 <br>
|
||||||
- 每次升级本库,ini 文件都会被重置,可另存到其它路径以免重置。
|
如果是接管已打开的浏览器,这些设置也没有用。 <br>
|
||||||
|
每次升级本库,ini 文件都会被重置,可另存到其它路径以免重置。
|
||||||
|
|
||||||
# ini 文件内容
|
# ini 文件内容
|
||||||
|
|
||||||
@ -128,10 +128,10 @@ do.save(r'D:\config1.ini')
|
|||||||
# easy_set 方法
|
# easy_set 方法
|
||||||
|
|
||||||
Chrome 浏览器的配置繁琐且难以记忆,本库提供一些常用功能的快速设置方法,调用即可修改 ini 文件中该部分内容。
|
Chrome 浏览器的配置繁琐且难以记忆,本库提供一些常用功能的快速设置方法,调用即可修改 ini 文件中该部分内容。
|
||||||
**注意:**
|
|
||||||
|
|
||||||
- easy_set 方法仅用于设置 ini 文件,浏览器或 Session 创建后再调用没有效果的。
|
!> **注意:** <br>
|
||||||
- 如果是接管已打开的浏览器,这些设置也没有用。
|
easy_set 方法仅用于设置 ini 文件,浏览器或 Session 创建后再调用没有效果的。 <br>
|
||||||
|
如果是接管已打开的浏览器,这些设置也没有用。
|
||||||
|
|
||||||
## 简单示例
|
## 简单示例
|
||||||
|
|
||||||
|
@ -23,7 +23,9 @@ so = SessionOptions(read_file=False)
|
|||||||
page = MixPage(driver_options=do, session_options=so)
|
page = MixPage(driver_options=do, session_options=so)
|
||||||
```
|
```
|
||||||
|
|
||||||
**注意** ,这个时候`Drission`的两个参数都要输入内容,如果其中一个不需要设置可以输入`False`,如:
|
!> **注意** ,这个时候`Drission`的两个参数都要输入内容,如果其中一个不需要设置可以输入`False`.
|
||||||
|
|
||||||
|
如:
|
||||||
|
|
||||||
```python
|
```python
|
||||||
drission = Drission(driver_or_options=do, session_or_options=False)
|
drission = Drission(driver_or_options=do, session_or_options=False)
|
||||||
|
@ -383,7 +383,8 @@ ele2 = ele1.ele('tag:div@text():text')
|
|||||||
ele2 = ele1.ele('tag:div@@text():text')
|
ele2 = ele1.ele('tag:div@@text():text')
|
||||||
```
|
```
|
||||||
|
|
||||||
**Tips:** 注意, `tag:div@text():text` 和 `tag:div@@text():text` 是有区别的,前者只在`div`的直接文本节点搜索,后者搜索`div`的整个内部。
|
?> **Tips:** <br>
|
||||||
|
注意, `tag:div@text():text` 和 `tag:div@@text():text` 是有区别的,前者只在`div`的直接文本节点搜索,后者搜索`div`的整个内部。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
@ -152,7 +152,8 @@ print(page.timeouts)
|
|||||||
## current_tab_index
|
## current_tab_index
|
||||||
|
|
||||||
此属性返回当前标签页的序号。
|
此属性返回当前标签页的序号。
|
||||||
**注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
|
|
||||||
|
!> **注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
|
||||||
|
|
||||||
## current_tab_handle
|
## current_tab_handle
|
||||||
|
|
||||||
|
@ -12,13 +12,12 @@
|
|||||||
|
|
||||||
这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](查找页面元素)”章节。
|
这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](查找页面元素)”章节。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## change_mode()
|
## change_mode()
|
||||||
|
|
||||||
此方法用于转换`MixPage`对象的模式。
|
此方法用于转换`MixPage`对象的模式。
|
||||||
切换后默认在目标模式重新跳转到原模式所在 url。
|
切换后默认在目标模式重新跳转到原模式所在 url。
|
||||||
**注意:** s 模式转 d 模式时,若浏览器当前网址域名和 s 模式不一样,必定会跳转。
|
|
||||||
|
!> **注意:** s 模式转 d 模式时,若浏览器当前网址域名和 s 模式不一样,必定会跳转。
|
||||||
|
|
||||||
参数:
|
参数:
|
||||||
|
|
||||||
@ -279,7 +278,7 @@ page.to_frame(iframe)
|
|||||||
|
|
||||||
返回:None
|
返回:None
|
||||||
|
|
||||||
**注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
|
!> **注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
|
||||||
|
|
||||||
```python
|
```python
|
||||||
# 跳转到第一个标签页
|
# 跳转到第一个标签页
|
||||||
@ -306,7 +305,8 @@ page.create_tab('http://www.baidu.com')
|
|||||||
## close_tabs()
|
## close_tabs()
|
||||||
|
|
||||||
此方法用于关闭指定的标签页,标签页可以是序号或 handle 值,可关闭多个。默认关闭当前的。
|
此方法用于关闭指定的标签页,标签页可以是序号或 handle 值,可关闭多个。默认关闭当前的。
|
||||||
**注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
|
|
||||||
|
!> **注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
|
||||||
|
|
||||||
参数:
|
参数:
|
||||||
|
|
||||||
@ -325,7 +325,8 @@ page.close_tabs((0, 2))
|
|||||||
## close_other_tabs()
|
## close_other_tabs()
|
||||||
|
|
||||||
此方法用于关闭指定标签页以外的标签页,标签页可以是序号或 handle 值,可保留多个。默认保留当前的。
|
此方法用于关闭指定标签页以外的标签页,标签页可以是序号或 handle 值,可保留多个。默认保留当前的。
|
||||||
**注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
|
|
||||||
|
!> **注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
|
||||||
|
|
||||||
参数:
|
参数:
|
||||||
|
|
||||||
|
@ -33,7 +33,7 @@ page.get('https://www.baidu.com')
|
|||||||
|
|
||||||
## 手动配置方式
|
## 手动配置方式
|
||||||
|
|
||||||
**注意:** 这段代码只用于设置配置文件中的路径信息,**运行一次即可**,勿写到正式程序里 。
|
!> **注意:** 这段代码只用于设置配置文件中的路径信息,**运行一次即可**,勿写到正式程序里 。
|
||||||
|
|
||||||
有些版本的 Chrome 程序无法获取正确的 driver,就须要手动配置路径。
|
有些版本的 Chrome 程序无法获取正确的 driver,就须要手动配置路径。
|
||||||
新建一个**临时文件** ,修改并运行以下代码,可手动指定 Chrome 和 driver 路径,记录到配置文件,以后程序会自动读取其中的配置,无须再写。
|
新建一个**临时文件** ,修改并运行以下代码,可手动指定 Chrome 和 driver 路径,记录到配置文件,以后程序会自动读取其中的配置,无须再写。
|
||||||
|
@ -19,7 +19,7 @@ page.get(url)
|
|||||||
title = page('tag:h1').text
|
title = page('tag:h1').text
|
||||||
```
|
```
|
||||||
|
|
||||||
**Tips:** DrissionPage 自带默认 headers
|
?> **Tips:** DrissionPage 自带默认 headers
|
||||||
|
|
||||||
## 下载文件
|
## 下载文件
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user