3.0.33更新文档

This commit is contained in:
g1879 2023-01-11 18:37:33 +08:00
parent 91479ee701
commit ad579c63dd

View File

@ -15,9 +15,7 @@
# ✔️ 直接创建
这种方式代码最简洁,程序会从配置文件中读取配置,自动生成页面对象。可以保持代码简洁。
在基本概念一节我们提到过,本库使用配置文件记录常用配置信息,也可以直接把配置写在代码里。
?>**Tips**<br>默认配置文件中,程序使用 9222 端口启动浏览器,浏览器路径为 Chrome。如路径中没找到浏览器执行文件Windows 系统下程序会在注册表中查找路径,如果还是没找到,则要用下一种方式手动配置路径。
在基本概念一节我们提到过,本库使用配置文件记录常用配置信息,它会自动读取配置。
```python
# 默认以 d 模式创建页面对象
@ -33,6 +31,10 @@ page = ChromiumPage()
page = SessionPage()
```
默认配置文件中,程序使用 9222 端口启动浏览器,浏览器路径为`'chrome'`。如路径中没找到浏览器执行文件Windows 系统下程序会在注册表中查找路径。
如果都没找到,则要用下一种方式手动配置路径。
# ✔️ 通过配置信息创建
本库有两种管理配置信息的对象,`DriverOptions``SessionOptions`,分别对应控制浏览器和收发数据包的配置。须要时,可以创建相应的配置对象进行设置。
@ -54,8 +56,8 @@ page = SessionPage()
# 导入 DriverOptions
from DrissionPage import WebPage, DriverOptions
# 创建浏览器配置对象,指定浏览器路径和运行端口
do = DriverOptions().set_paths(chrome_path=r'D:\chrome.exe', local_port=9333)
# 创建浏览器配置对象,指定浏览器路径
do = DriverOptions().set_paths(browser_path=r'D:\chrome.exe')
# 用该配置创建页面对象
page = WebPage(driver_or_options=do)
```
@ -92,6 +94,8 @@ page = SessionPage(session_or_options=so)
page = WebPage(session_or_options=so, driver_or_options=do)
```
?>**Tips**<br>您可以把配置保存到配置文件以后自动读取,详见”启动配置“章节。
## 📍 直接指定地址创建
`ChromiumPage`可以直接接收浏览器地址来创建,格式为 'ip:port'。
@ -107,7 +111,9 @@ page = ChromiumPage(addr_driver_opts='127.0.0.1:9333')
```python
from DrissionPage import WebPage, DriverOptinos
# 创建配置对象时指定要读取的ini文件路径
do = DriverOptinos(ini_path=r'./config1.ini')
# 使用该配置对象创建页面
page = WebPage(driver_or_options=do)
```
@ -195,12 +201,15 @@ page = WebPage(driver_or_options=do)
```python
from DrissionPage import ChromiumPage, DriverOptions
# 创建多个配置对象,每个指定不同的端口号和用户文件夹路径
do1 = DriverOptions().set_paths(local_port=9111, user_data_path=r'D:\data1')
do2 = DriverOptions().set_paths(local_port=9222, user_data_path=r'D:\data2')
# 创建多个页面对象
page1 = ChromiumPage(driver_or_options=do1)
page2 = ChromiumPage(driver_or_options=do2)
# 每个页面对象控制一个浏览器
page1.get('https://www.baidu.com')
page2.get('http://www.163.com')
```