DrissionPage 技术文档

DrissionPage 技术文档

【免费下载链接】DrissionPage 基于python的网页自动化工具。既能控制浏览器，也能收发数据包。可兼顾浏览器自动化的便利性和requests的高效率。功能强大，内置无数人性化设计和便捷功能。语法简洁而优雅，代码量少。 项目地址: https://gitcode.com/g1879/DrissionPage

1. 安装指南

系统要求

• 支持操作系统：Windows、Linux、MacOS
• Python版本要求：3.6及以上
• 浏览器要求：Chromium内核浏览器(如Chrome/Edge)或electron应用

安装方式

通过pip安装最新稳定版：

pip install DrissionPage

如需安装开发版：

pip install git+https://gitee.com/g1879/DrissionPage.git

2. 项目使用说明

基本功能

DrissionPage提供三种主要使用模式：

1. 浏览器控制模式：类似selenium的浏览器自动化功能
2. 数据包收发模式：类似requests的网络请求功能
3. 混合模式：可同时使用前两种模式

快速入门示例

from DrissionPage import ChromiumPage

# 创建页面对象
page = ChromiumPage()
# 访问网页
page.get('https://www.example.com')
# 查找元素并点击
ele = page.ele('text:点击我')
ele.click()

3. 项目API使用文档

核心类说明

• ChromiumPage: 浏览器控制主类
• SessionPage: 数据包收发主类
• MixPage: 混合模式主类

常用API方法

浏览器控制API

page.get(url)  # 访问网页
page.ele(locator)  # 查找单个元素
page.eles(locator)  # 查找多个元素
page.wait_ele(locator)  # 等待元素出现
page.screenshot()  # 网页截图

数据包收发API

page.post(url, data)  # 发送POST请求
page.get(url)  # 发送GET请求
page.json  # 获取响应json
page.html  # 获取响应html

元素操作API

ele.click()  # 点击元素
ele.input(text)  # 输入文本
ele.text  # 获取元素文本
ele.attr(attr_name)  # 获取元素属性

4. 项目安装方式详解

完整安装流程

1. 确保系统已安装Python 3.6+
2. 建议创建虚拟环境：

   python -m venv myenv
   source myenv/bin/activate  # Linux/Mac
   myenv\Scripts\activate  # Windows
   

3. 安装DrissionPage：

   pip install DrissionPage
   

浏览器配置

1. 自动模式(推荐)：

   • 程序会自动查找系统已安装的Chromium浏览器

2. 手动指定浏览器路径：

   from DrissionPage import ChromiumOptions
   
   co = ChromiumOptions().set_browser_path('/path/to/browser')
   page = ChromiumPage(co)
   

常见问题解决

• 如遇浏览器驱动问题，可尝试：

  from DrissionPage import ChromiumOptions
  
  co = ChromiumOptions().auto_port()
  page = ChromiumPage(co)
  

• 网络不稳定时可增加等待时间：

  page.set.timeout(20)  # 设置全局超时时间为20秒
  

【免费下载链接】DrissionPage 基于python的网页自动化工具。既能控制浏览器，也能收发数据包。可兼顾浏览器自动化的便利性和requests的高效率。功能强大，内置无数人性化设计和便捷功能。语法简洁而优雅，代码量少。 项目地址: https://gitcode.com/g1879/DrissionPage