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