DrissionPage 用户教程

欢迎使用 DrissionPage！这是一个功能强大的 Python 网页自动化工具，既能控制浏览器，也能收发数据包，满足多种网页操作需求。

本教程分为初级、中级和高级三个部分，帮助不同基础的用户快速上手并掌握 DrissionPage。

📚 教程目录

🌱 初级教程（适合初学者）

1. DrissionPage 简介

   • 什么是 DrissionPage
   • 特点和优势
   • 与其他工具的对比

2. 环境配置

   • 安装 Python
   • 安装 DrissionPage
   • 配置浏览器

3. 快速入门

   • 创建页面对象
   • 简单的页面操作
   • 查找和操作元素

4. 基础概念

   • 三种页面对象介绍 (SessionPage, ChromiumPage, WebPage)
   • 页面和元素的关系
   • 配置对象

5. 基础页面操作

   • 打开网页
   • 获取页面信息
   • 页面截图

6. 元素查找基础

   • CSS 选择器查找
   • XPath 查找
   • 文本和属性查找

7. 元素操作基础

   • 点击元素
   • 输入文本
   • 获取元素属性和文本

8. 表单操作

   • 表单填写
   • 上传文件
   • 表单提交

9. 实战案例 - 简单网站登录

   • 分析登录页面
   • 编写登录脚本
   • 处理验证码

🚀 中级教程（适合有基础的用户）

1. SessionPage 详解

   • SessionPage 特性
   • 请求和响应处理
   • SessionElement 操作

2. ChromiumPage 详解

   • 浏览器控制
   • 标签页管理
   • 页面交互高级功能

3. WebPage 详解

   • 模式切换
   • 数据共享
   • 场景应用

4. 高级元素查找

   • 链式查找
   • 相对定位
   • 属性组合查找

5. 等待和超时处理

   • 显式等待
   • 隐式等待
   • 等待条件设置

6. 下载功能

   • DownloadKit 使用
   • 文件下载管理
   • 批量下载

7. iframe 处理

   • iframe 元素查找
   • 跨 iframe 操作
   • ChromiumFrame 对象

8. 处理 JavaScript

   • 执行 JavaScript
   • JavaScript 与页面交互
   • 处理动态内容

9. 实战案例 - 数据采集

   • 分析目标网站
   • 编写采集脚本
   • 数据存储

🔥 高级教程（适合进阶用户）

1. 多线程与多标签页

   • 多标签页控制
   • 多线程数据处理
   • 性能优化

2. 网络监听与拦截

   • 监听网络请求
   • 分析网络流量
   • 请求拦截与修改

3. Shadow DOM 处理

   • 查找 Shadow DOM
   • 操作 Shadow 元素
   • 处理复杂 UI 组件

4. 高级交互操作

   • 鼠标拖拽
   • 键盘组合键
   • 模拟复杂用户行为

5. 配置文件详解

   • 自定义配置文件
   • 配置项详解
   • 不同环境配置

6. 异常处理与调试

   • 常见异常处理
   • 调试技巧
   • 日志管理

7. 性能优化

   • 加速数据读取
   • 减少资源消耗
   • 优化执行效率

8. 无头模式与部署

   • 无头模式配置
   • Docker 部署
   • 服务器部署注意事项

9. 实战案例 - 复杂业务流程自动化

   • 业务流程分析
   • 模块化设计
   • 鲁棒性处理

📘 附录

1. 常用 API 参考
2. 常见问题解答
3. 配置文件参数表
4. 升级指南
5. 贡献指南

📞 获取帮助

• 官方文档：https://DrissionPage.cn
• GitHub 仓库：https://github.com/g1879/DrissionPage
• Gitee 仓库：https://gitee.com/g1879/DrissionPage
• QQ交流群：见官方文档