简介

DrissionPage，即 driver 和 session 的合体，是个基于 python 的 Web 自动化操作集成工具。
它实现了 selenium 和 requests 之间的无缝切换。
因此可以兼顾 selenium 的便利性和 requests 的高效率。
它集成了页面常用功能，两种模式系统一致的 API，使用便捷。它用 POM 模式封装了页面元素常用的方法，很适合自动化操作功能扩展。
更棒的是，它的使用方式非常简洁和人性化，代码量少，对新手友好。

项目地址：

示例地址： 使用DrissionPage的网页自动化及爬虫示例

联系邮箱： g1879@qq.com

理念及背景

理念

简洁、易用、可扩展

背景

requests 爬虫面对要登录的网站时，要分析数据包、JS 源码，构造复杂的请求，往往还要应付验证码、JS 混淆、签名参数等反爬手段，门槛较高。若数据是由JS计算生成的，还须重现计算过程，体验不好，开发效率不高。
使用 selenium，可以很大程度上绕过这些坑，但 selenium 效率不高。因此，这个库将 selenium 和 requests 合而为一，不同须要时切换相应模式，并提供一种人性化的使用方法，提高开发和运行效率。
除了合并两者，本库还以网页为单位封装了常用功能，简化了 selenium 的操作和语句，在用于网页自动化操作时，减少考虑细节，专注功能实现，使用更方便。
一切从简，尽量提供简单直接的使用方法，对新手更友好。

特性

以简洁的代码为第一追求。
允许在 selenium 和 requests 间无缝切换，共享 session。
两种模式提供一致的 API，使用体验一致。
人性化的页面元素操作方式，减轻页面分析工作量和编码量。
对常用功能作了整合和优化，更符合实际使用需要。
兼容 selenium 代码，便于项目迁移。
使用 POM 模式封装，便于扩展。
统一的文件下载方法，弥补浏览器下载的不足。
简易的配置方法，摆脱繁琐的浏览器配置。

项目结构

结构图

Drission类

管理负责与网页通讯的 WebDriver 对象和 Session 对象，相当于驱动器的角色。

MixPage类

MixPage 封装了页面操作的常用功能，它调用 Drission 类中管理的驱动器，对页面进行访问、操作。可在 driver 和 session 模式间切换。切换的时候会自动同步登录状态。

DriverElement类

driver 模式下的页面元素类，可对元素进行点击、输入文本、修改属性、运行 js 等操作，也可在其下级搜索后代元素。

SessionElement类

session 模式下的页面元素类，可获取元素属性值，也可在其下级搜索后代元素。

简单演示

与selenium代码对比

以下代码实现一模一样的功能，对比两者的代码量：

用显性等待方式查找所有文本包含 some text 的元素

# 使用selenium：
element = WebDriverWait(driver).until(ec.presence_of_all_elements_located((By.XPATH, '//*[contains(text(), "some text")]')))

# 使用DrissionPage：
element = page('some text')

跳转到第一个标签页

# 使用selenium：
driver.switch_to.window(driver.window_handles[0])

# 使用DrissionPage：
page.to_tab(0)

按文本选择下拉列表

# 使用selenium：
from selenium.webdriver.support.select import Select
select_element = Select(element)
select_element.select_by_visible_text('text')

# 使用DrissionPage：
element.select('text')

拖拽一个元素

# 使用selenium：
ActionChains(driver).drag_and_drop(ele1, ele2).perform()

# 使用DrissionPage：
ele1.drag_to(ele2)

滚动窗口到底部（保持水平滚动条不变）

# 使用selenium：
driver.execute_script("window.scrollTo(document.documentElement.scrollLeft, document.body.scrollHeight);")

# 使用DrissionPage：
page.scroll_to('bottom')

设置 headless 模式

# 使用selenium：
options = webdriver.ChromeOptions()
options.add_argument("--headless")

# 使用DrissionPage：
set_headless()

获取伪元素内容

# 使用selenium：
text = webdriver.execute_script('return window.getComputedStyle(arguments[0], "::after").getPropertyValue("content");', element)

# 使用DrissionPage：
text = element.after

获取 shadow-root

# 使用selenium：
shadow_element = webdriver.execute_script('return arguments[0].shadowRoot', element)

# 使用DrissionPage：
shadow_element = element.shadow_root

用 xpath 获取属性或节点

# 使用selenium：
不支持该用法

# 使用DrissionPage：
class_name = element('xpath://div[@id="div_id"]/@class')
text = element('xpath://div[@id="div_id"]/text()[2]')

与requests代码对比

以下代码实现一模一样的功能，对比两者的代码量：

获取元素内容

url = 'https://baike.baidu.com/item/python'

# 使用requests：
from lxml import etree
headers = {'User-Agent':'Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36'}
response = requests.get(url, headers = headers)
html = etree.HTML(response.text)
element = html.xpath('//h1')[0]
title = element.text

# 使用DrissionPage：
page = MixPage('s')
page.get(url)
title = page('tag:h1').text

Tips: DrissionPage 自带默认 headers

下载文件

url = 'https://www.baidu.com/img/flexible/logo/pc/result.png'
save_path = r'C:\download'

# 使用requests：
r = requests.get(url)
with open(f'{save_path}\\img.png', 'wb') as fd:
   for chunk in r.iter_content():
       fd.write(chunk)
        
# 使用DrissionPage：
page.download(url, save_path, 'img')  # 支持重命名，处理文件名冲突

模式切换

用 selenium 登录网站，然后切换到requests读取网页。两者会共享登录信息。

page = MixPage()  # 创建页面对象，默认driver模式
page.get('https://gitee.com/profile')  # 访问个人中心页面（未登录，重定向到登录页面）

page.ele('@id:user_login').input('your_user_name')  # 使用selenium输入账号密码登录
page.ele('@id:user_password').input('your_password\n')

page.change_mode()  # 切换到session模式
print('登录后title：', page.title, '\n')  # 登录后session模式的输出

输出：

登录后title： 个人资料 - 码云 Gitee.com

获取并打印元素属性

# 接上段代码
foot = page.ele('@id:footer-left')  # 用id查找元素
first_col = foot.ele('css:>div')  # 使用css selector在元素的下级中查找元素（第一个）
lnk = first_col.ele('text:命令学')  # 使用文本内容查找元素
text = lnk.text  # 获取元素文本
href = lnk.attr('href')  # 获取元素属性值

print(text, href, '\n')

# 简洁模式串联查找
text = page('@id:footer-left')('css:>div')('text:命令学').text
print(text)

输出：

Git 命令学习 https://oschina.gitee.io/learn-git-branching/

Git 命令学习

下载文件

url = 'https://www.baidu.com/img/flexible/logo/pc/result.png'
save_path = r'C:\download'
page.download(url, save_path)

安装

pip install DrissionPage

只支持 python3.6 及以上版本，driver 模式目前只支持 chrome。
若要使用 driver 模式，须下载 chrome 和 对应版本 的 chromedriver。[chromedriver下载]
目前只在 Windows 环境下作了测试。

使用方法

导入模块

from DrissionPage import *

初始化

如果你只使用 session 模式，可跳过本节。

使用selenium前，必须配置 chrome.exe 和 chromedriver.exe 的路径，并确保它们版本匹配。

配置路径有三种方法：

将两个路径写入系统变量。
使用时手动传入路径。
将路径写入本库的ini文件（推荐）。

若你选择第三种方式，请在第一次使用本库前，运行这几行代码，把这两个路径记录到 ini 文件中，以后程序会自动安装 ini 文件中的配置运行。

from DrissionPage.easy_set import set_paths
driver_path = 'D:\\chrome\\chromedriver.exe'  # 你的chromedriver.exe路径，可选
chrome_path = 'D:\\chrome\\chrome.exe'  # 你的chrome.exe路径，可选
set_paths(driver_path, chrome_path)

该方法还会检查chrome和chromedriver版本是否匹配，显示：

版本匹配，可正常使用。

# 或

出现异常：
Message: session not created: Chrome version must be between 70 and 73
  (Driver info: chromedriver=73.0.3683.68 (47787ec04b6e38e22703e856e101e840b65afe72),platform=Windows NT 10.0.19631 x86_64)
chromedriver下载网址：https://chromedriver.chromium.org/downloads

检查通过后，即可正常使用driver模式。

除了上述两个路径，该方法还可以设置以下路径：

debugger_address  # 调试浏览器地址，如：127.0.0.1:9222
download_path  # 下载文件路径
global_tmp_path  # 临时文件夹路径
user_data_path # 用户数据路径
cache_path # 缓存路径

Tips：

不同项目可能须要不同版本的 chrome 和 chromedriver，你还可保存多个 ini 文件，按须使用。
推荐使用绿色版 chrome，并手动设置路径，避免浏览器升级造成与 chromedriver 版本不匹配。
调试项目时推荐设置 debugger_address，使用手动打开的浏览器调试，省时省力。

创建驱动器对象Drission

创建的步骤不是必须，若想快速上手，可跳过本节。MixPage 对象会自动创建该对象。

Drission 对象用于管理 driver 和 session 对象。在多个页面协同工作时，Drission 对象用于传递驱动器，使多个页面类可控制同一个浏览器或 Session 对象。
可直接读取 ini 文件配置信息创建，也可以在初始化时传入配置信息。

# 由默认ini文件创建
drission = Drission()  

# 由其它ini文件创建
drission = Drission(ini_path = 'D:\\settings.ini')  

# 不从ini文件创建
drission = Drission(read_file = False)

若要手动传入配置：

# 用传入的配置信息创建（忽略ini文件）
from DrissionPage.config import DriverOptions

# 创建driver配置对象，read_file = False表示不读取ini文件
do = DriverOptions(read_file = False)  

# 设置路径，若已在系统变量设置，可忽略
do.set_paths(chrome_path = 'D:\\chrome\\chrome.exe',
             driver_path = 'D:\\chrome\\chromedriver.exe')  

# 用于 s 模式的设置
session_options = {'headers': {'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6)'}}

# 传入配置，driver_options 和 session_options都是可选的，须要使用对应模式才须要传入
drission = Drission(driver_options, session_options)

使用页面对象MixPage

MixPage 页面对象封装了常用的网页操作，并实现 driver 和 session 模式之间的切换。
MixPage 须接收一个 Drission 对象并使用其中的 driver 或 session，如没有传入，MixPage 会自己创建一个 Drission（使用默认ini文件的配置）。

Tips: 多页面对象协同工作时，记得手动创建 Drission 对象并传递给页面对象使用。否则页面对象会各自创建自己的 Drission 对象，使信息无法传递。

创建对象

创建对象方式有3种：简易、传入 Drission 对象、传入配置。可根据实际需要选择。

# 简易创建方式，以ini文件默认配置自动创建Drission对象
page = MixPage()
page = MixPage('s')

# 以传入Drission对象创建
page = MixPage(drission)
page = MixPage(drission, mode='s', timeout=5)  # session模式，等待时间5秒（默认10秒）

# 以传入配置信息创建
page = MixPage(driver_options=do, session_options=so)  # 默认 d 模式

访问网页

若连接出错，程序会自动重试2次，可指定重试次数和等待间隔。

# 默认方式
page.get(url)
page.post(url, data, **kwargs)  # 只有session模式才有post方法

# 指定重试次数和间隔
page.get(url, retry=5, interval=0.5)

切换模式

在 s 和 d 模式之间切换，切换时会自动同步 cookies 和正在访问的 url。

page.change_mode(go=False)  # go为False表示不跳转url

页面属性

page.url  # 当前访问的url
page.mode  # 当前模式
page.drission  # 当前使用的Dirssion对象
page.driver  # 当前使用的WebDirver对象
page.session  # 当前使用的Session对象
page.cookies  # 获取cookies信息
page.html  # 页面源代码
page.title  # 当前页面标题

# d 模式独有：
page.tabs_count  # 返回标签页数量
page.tab_handles  # 返回所有标签页handle列表
page.current_tab_num  # 返回当前标签页序号
page.current_tab_handle  # 返回当前标签页handle

页面操作

调用只属于 d 模式的方法，会自动切换到 d 模式。详细用法见 APIs。

page.change_mode()  # 切换模式
page.cookies_to_session()  # 从WebDriver对象复制cookies到Session对象
page.cookies_to_driver()  # 从Session对象复制cookies到WebDriver对象
page.get(url, retry, interval, **kwargs)  # 用get方式访问网页，可指定重试次数及间隔时间
page.ele(loc_or_ele, timeout)  # 获取符合条件的第一个元素、节点或属性
page.eles(loc_or_ele, timeout)  # 获取所有符合条件的元素、节点或属性
page.download(url, save_path, rename, file_exists, **kwargs)  # 下载文件
page.close_driver()  # 关闭 WebDriver对象
page.close_session()  # 关闭 Session对象

# s 模式独有：
page.post(url, data, retry, interval, **kwargs)  # 以post方式访问网页，可指定重试次数及间隔时间

# d 模式独有：
page.wait_ele(loc_or_ele, mode, timeout)  # 等待元素从dom删除、显示、隐藏
page.run_script(js, *args)  # 运行js语句
page.create_tab(url)  # 新建并定位到一个标签页,该标签页在最后面
page.to_tab(num_or_handle)  # 跳转到标签页
page.close_current_tab()  # 关闭当前标签页
page.close_other_tabs(num)  # 关闭其它标签页
page.to_iframe(iframe)  # 切入iframe
page.screenshot(path)  # 页面截图
page.scrool_to_see(element)  # 滚动直到某元素可见
page.scroll_to(mode, pixel)  # 按参数指示方式滚动页面，可选滚动方向：'top', 'bottom', 'rightmost', 'leftmost', 'up', 'down', 'left', 'right'
page.refresh()  # 刷新当前页面
page.back()  # 浏览器后退
page.et_window_size(x, y)  # 设置浏览器窗口大小，默认最大化
page.check_page()  # 检测页面是否符合预期
page.chrome_downloading()  # 获取chrome正在下载的文件列表
page.process_alert(mode, text)  # 处理提示框

查找元素

ele() 返回第一个符合条件的元素，eles() 返回所有符合条件的元素列表。
你可在页面对象或元素对象下使用这两个函数，以查找下级元素。

page.eles() 和 element.eles() 查找返回符合条件的所有元素列表。

说明：

元素查找超时默认为10秒，你也可以按需要设置。
下面的查找语句中，冒号 : 表示模糊匹配，等号 = 表示精确匹配
查询字符串有 @属性名、tag、text、xpath、css五种

# 根据属性查找，@后面可跟任意属性
page.ele('@id:ele_id', timeout = 2)  # 查找id为ele_id的元素，设置等待时间2秒  
page.eles('@class')  # 查找所有拥有class属性的元素
page.eles('@class:class_name')  # 查找所有class含有ele_class的元素 
page.eles('@class=class_name')  # 查找所有class等于ele_class的元素 

# 根据tag name查找
page.ele('tag:li')  # 查找第一个li元素  
page.eles('tag:li')  # 查找所有li元素  

# 根据tag name及属性查找
page.ele('tag:div@class=div_class')  # 查找class为div_class的div元素
page.ele('tag:div@class:ele_class') # 查找class含有ele_class的div元素
page.ele('tag:div@class=ele_class') # 查找class等于ele_class的div元素
page.ele('tag:div@text():search_text') # 查找文本含有search_text的div元素
page.ele('tag:div@text()=search_text') # 查找文本等于search_text的div元素

# 根据文本内容查找
page.ele('search text')  # 查找包含传入文本的元素  
page.eles('text:search text')  # 如文本以@、tag:、css:、xpath:、text:开头，则在前面加上text:避免冲突  
page.eles('text=search text')  # 文本等于search_text的元素

# 根据xpath或css selector查找
page.eles('xpath://div[@class="ele_class"]')  
page.eles('css:div.ele_class')  

# 根据loc查找
loc1 = By.ID, 'ele_id'
loc2 = By.XPATH, '//div[@class="ele_class"]'
page.ele(loc1)
page.ele(loc2)

# 查找下级元素
element = page.ele('@id:ele_id')
element.ele('@class:class_name')  # 在element下级查找第一个class为ele_class的元素
element.eles('tag:li')  # 在ele_id下级查找所有li元素

# 根据位置查找
element.parent  # 父元素  
element.next  # 下一个兄弟元素  
element.prev  # 上一个兄弟元素  

# 获取shadow-dom，只支持open的shadow-root
ele1 = element.shadow_root.ele('tag:div')

# 串连查找
page.ele('@id:ele_id').ele('tag:div').next.ele('some text').eles('tag:a')

# 简化写法
eles = page('@id:ele_id')('tag:div').next('some text').eles('tag:a')
ele2 = ele1('tag:li').next('some text')

获取元素属性

element.html  # 返回元素outerHTML
element.inner_html  # 返回元素innerHTML
element.tag  # 返回元素tag name
element.text  # 返回元素innerText值
element.link  # 返回元素href或src绝对url
element.texts()  # 返回元素内所有直接子节点的文本，包括元素和文本节点，可指定只返回文本节点
element.attrs  # 返回元素所有属性的字典
element.attr(attr)  # 返回元素指定属性的值
element.css_path  # 返回元素绝对css路径
element.xpath  # 返回元素绝对xpath路径
element.parent  # 返回元素父元素
element.next  # 返回元素后一个兄弟元素
element.prev  # 返回元素前一个兄弟元素
element.parents(num)  # 返回第num级父元素
element.nexts(num, mode)  # 返回后面第几个元素或节点
element.prevs(num, mode)  # 返回前面第几个元素或节点
element.ele(loc_or_str, timeout)  # 返回当前元素下级第一个符合条件的子元素、属性或节点文本
element.eles(loc_or_str, timeout)  # 返回当前元素下级所有符合条件的子元素、属性或节点文本

# d 模式独有：
element.before  # 获取伪元素before内容
element.after  # 获取伪元素after内容
element.is_valid  # 用于判断元素是否还在dom中
element.size  # 获取元素大小
element.location  # 获取元素位置
element.shadow_root  # 获取元素下的ShadowRoot元素
element.get_style_property(style, pseudo_ele)  # 获取元素样式属性值，可获取伪元素的
element.is_selected()  # 返回元素是否被选中
element.is_enabled()  # 返回元素是否可用
element.is_displayed()  # 返回元素是否可见

元素操作

元素操作为 d 模式独有，调用以下方法会自动切换到 d 模式。

element.click(by_js)  # 点击元素，可选择是否用js方式点击
element.input(value)  # 输入文本
element.run_script(js)  # 对元素运行JavaScript脚本
element.submit()  # 提交
element.clear()  # 清空元素
element.screenshot(path, filename)  # 对元素截图
element.select(text)  # 根据文本选择下拉列表
element.set_attr(attr, value)  # 设置元素属性值
element.drag(x, y, speed, shake)  # 拖动元素相对距离，可设置速度和是否随机抖动
element.drag_to(ele_or_loc, speed, shake)  # 拖动元素到另一个元素或某个坐标，可设置速度和是否随机抖动
element.hover()  # 在元素上悬停鼠标

与selenium代码对接

DrissionPage 代码可与 selenium 代码无缝拼接，既可直接使用 selenium 的 WebDriver 对象，也可到处自身的 WebDriver 给 selenium 代码使用。使已有项目的迁移非常方便。

selenium转DrissionPage

driver = webdriver.Chrome()
driver.get('https://www.baidu.com')

page = MixPage(Drission(driver))  # 把driver传递给Drission，创建MixPage对象
print(page.title)  # 打印结果：百度一下，你就知道

DrissionPage转selenium

page = MixPage()
page.get('https://www.baidu.com')

driver = page.driver  # 从MixPage对象中获取WebDriver对象
print(driver.title)  # 打印结果：百度一下，你就知道

下载文件

selenium 缺乏对浏览器下载文件的有效管理，难以进行检测下载状态、重命名、失败管理。
使用 requests 下载文件能较好实现以上功能，但代码较为繁琐。
因此 DrissionPage 封装了 download 方法，整合了两者优点，可从 selenium 获取登录信息，用 requests 进行下载。
弥补了 selenium 的不足，使下载简洁高效。

功能

指定下载路径
重命名文件，可不填写扩展名，程序自动补充
存在同名文件时，可选择重命名、覆盖、跳过等处理方式
显示下载进度
支持 post 方式
支持自定义连接参数

演示

url = 'https://www.baidu.com/img/flexible/logo/pc/result.png'  # 文件url
save_path = r'C:\download'  # 存放路径

# 重命名为img.png，存在重名时自动在文件名末尾加上序号，显示下载进度
page.download(url, save_path, 'img', 'rename', show_msg=True)

Chrome快捷设置

chrome 的配置很繁琐，为简化使用，本库提供了常用配置的设置方法。

DriverOptions对象

DriverOptions 对象继承自 selenium.webdriver.chrome.options的Options 对象，在其基础上增加了以下方法：

remove_argument(value)  # 删除某argument值
remove_experimental_option(key)  # 删除某experimental_option设置
remove_all_extensions()  # 删除全部插件
save()  # 保存配置到默认ini文件
save('D:\\settings.ini')  # 保存到其它路径
set_argument(arg, value)  # 设置argument属性
set_headless(on_off)  # 设置是否使用无界面模式
set_no_imgs(on_off)  # 设置是否加载图片
set_no_js(on_off)  # 设置是否禁用js
set_mute(on_off)  # 设置是否静音
set_user_agent(user_agent)  # 设置user agent
set_proxy(proxy)  # 设置代理地址
set_paths(driver_path, chrome_path, debugger_address, download_path, user_data_path, cache_path)  # 设置浏览器相关的路径

使用方法

do = DriverOptions(read_file=False)  # 创建chrome配置对象，不从ini文件读取
do.set_headless(False)  # 显示浏览器界面
do.set_no_imgs(True)  # 不加载图片
do.set_paths(driver_path='D:\\chromedriver.exe', chrome_path='D:\\chrome.exe')  # 设置路径
do.set_headless(False).set_no_imgs(True)  # 支持链式操作

drission = Drission(driver_options=do)  # 用配置对象创建Drission对象
page = MixPage(drission)  # 用Drission对象创建MixPage对象

do.save()  # 保存配置到默认ini文件

保存配置

因 chrome 和 headers 配置繁多，故设置一个 ini 文件专门用于保存常用配置，你可使用 OptionsManager 对象获取和保存配置，用 DriverOptions 对象修改 chrome 配置。你也可以保存多个 ini 文件，按不同项目须要调用。

Tips：建议把常用配置文件保存到别的路径，以防本库升级时配置被重置。

ini文件内容

ini 文件默认拥有三部分配置：paths、chrome_options、session_options，初始内容如下。

[paths]
; chromedriver.exe路径
chromedriver_path =
; 临时文件夹路径，用于保存截图、文件下载等
global_tmp_path =

[chrome_options]
; 已打开的浏览器地址和端口，如127.0.0.1:9222
debugger_address =
; chrome.exe路径
binary_location =
; 配置信息
arguments = [
            ; 静音
            '--mute-audio',
            ; 不使用沙盒
            '--no-sandbox',
            ; 谷歌文档提到需要加上这个属性来规避bug
            '--disable-gpu',
            ; 忽略警告
            'ignore-certificate-errors',
            ; 不显示信息栏
            '--disable-infobars'
            ]
; 插件
extensions = []
; 实验性配置
experimental_options = {
                       'prefs': {
                       ; 下载不弹出窗口
                       'profile.default_content_settings.popups': 0,
                       ; 无弹窗
                       'profile.default_content_setting_values': {'notifications': 2},
                       ; 禁用PDF插件
                       'plugins.plugins_list': [{"enabled": False, "name": "Chrome PDF Viewer"}]
                       },
                       ; 设置为开发者模式，防反爬虫
                       'excludeSwitches': ["enable-automation"],
                       'useAutomationExtension': False
                       }

[session_options]
headers = {
          "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/10.1.2 Safari/603.3.8",
          "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
          "Connection": "keep-alive",
          "Accept-Charset": "utf-8;q=0.7,*;q=0.7"
          }

OptionsManager对象

OptionsManager 对象用于读取、设置和保存配置。

get_value(section, item) -> str  # 获取某个配置的值
get_option(section) -> dict  # 以字典格式返回配置全部属性
set_item(section, item, value)  # 设置配置属性
save()  # 保存配置到默认ini文件
save('D:\\settings.ini')  # 保存到其它路径

使用示例

from DrissionPage.configs import *

options_manager = OptionsManager()  # 从默认ini文件创建OptionsManager对象
options_manager = OptionsManager('D:\\settings.ini')  # 从其它ini文件创建OptionsManager对象
driver_path = options_manager.get_value('paths', 'chromedriver_path')  # 读取路径信息
options_manager.save()  # 保存到默认ini文件
options_manager.save('D:\\settings.ini')  # 保存到其它路径

drission = Drission(ini_path = 'D:\\settings.ini')  # 使用其它ini文件创建对象

注意：保存时若不传入路径，会保存到模块目录下的ini文件，即使读取的不是默认 ini 文件也一样。

easy_set方法

调用 easy_set 方法会修改默认ini文件相关内容。

set_headless(True)  # 开启 headless 模式
set_no_imgs(True)  # 开启无图模式
set_no_js(True)  # 禁用 JS
set_mute(True)  # 开启静音模式
set_user_agent('Mozilla/5.0 (Macintosh; Int......')  # 设置 user agent
set_proxy('127.0.0.1:8888')  # 设置代理
set_paths(paths)  # 见 [初始化] 一节
set_argument(arg, value)  # 设置属性，若属性无值（如'zh_CN.UTF-8'），value 为 bool 表示开关；否则value为str，当 value为''或 False，删除该属性项

POM模式

MixPage 封装了常用的页面操作，可方便地用于扩展。

例：扩展一个列表页面读取类

import re
from time import sleep
from DrissionPage import *

class ListPage(MixPage):
    """本类封装读取列表页面的方法，根据必须的4个元素，可读取同构的列表页面
    （中文变量真香）"""
    def __init__(self, drission: Drission, url: str = None, **xpaths):
        super().__init__(drission)
        self._url = url
        self.xpath_栏目名 = xpaths['栏目名']  # [xpath字符串, 正则表达式]
        self.xpath_下一页 = xpaths['下一页']
        self.xpath_行s = xpaths['行']
        self.xpath_页数 = xpaths['页数']  # [xpath字符串, 正则表达式]
        self.总页数 = self.get_总页数()
        if url:
            self.get(url)

    def get_栏目名称(self) -> str:
        if self.xpath_栏目名[1]:
            s = self.ele(f'xpath:{self.xpath_栏目名[0]}').text
            r = re.search(self.xpath_栏目名[1], s)
            return r.group(1)
        else:
            return self.ele(f'xpath:{self.xpath_栏目名[0]}').text

    def get_总页数(self) -> int:
        if self.xpath_页数[1]:
            s = self.ele(f'xpath:{self.xpath_页数[0]}').text
            r = re.search(self.xpath_页数[1], s)
            return int(r.group(1))
        else:
            return int(self.ele(f'xpath:{self.xpath_页数[0]}').text)

    def click_下一页(self, wait: float = None):
        self.ele(f'xpath:{self.xpath_下一页}').click()
        if wait:
            sleep(wait)

    def get_当前页列表(self, 待爬内容: list) -> list:
        """
        待爬内容格式：[[xpath1,参数1],[xpath2,参数2]...]
        返回列表格式：[[参数1,参数2...],[参数1,参数2...]...]
        """
        结果列表 = []
        行s = self.eles(f'xpath:{self.xpath_行s}')
        for 行 in 行s:
            行结果 = []
            for j in 待爬内容:
                行结果.append(行.ele(f'xpath:{j[0]}').attr(j[1]))
            结果列表.append(行结果)
            print(行结果)
        return 结果列表

    def get_列表(self, 待爬内容: list,  wait: float = None) -> list:
        列表 = self.get_当前页列表(待爬内容)
        for _ in range(self.总页数 - 1):
            self.click_下一页(wait)
            列表.extend(self.get_当前页列表(待爬内容))
        return 列表

其它

DriverPage 和 SessionPage

如果无须切换模式，可根据需要只使用 DriverPage 或 SessionPage，用法和 MixPage 一致。

from DrissionPage.session_page import SessionPage
from DrissionPage.drission import Drission

session = Drission().session
page = SessionPage(session)  # 传入 Session 对象
page.get('http://www.baidu.com')
print(page.ele('@id:su').text)  # 输出：百度一下

driver = Drission().driver
page = DriverPage(driver)  # 传入 Driver 对象
page.get('http://www.baidu.com')
print(page.ele('@id:su').text)  # 输出：百度一下

APIs

Drission类

class Drission()

Drission 类用于管理 WebDriver 对象和 Session 对象，是驱动器的角色。

参数说明：

driver_or_options: [WebDriver, dict, Options] - WebDriver 对象或 chrome 配置参数。
session_or_options: [Session, dict] - Session 对象配置参数
ini_path: str - ini 文件路径，默认为 DrissionPage 文件夹下的ini文件
proxy: dict - 代理设置

cookies_to_session()

把 driver 对象的 cookies 复制到 session 对象。

参数说明：

copy_user_agent: bool - 是否复制 user_agent 到 session
driver: WebDriver - 复制 cookies 的 WebDriver 对象
session: Session - 接收 cookies 的 Session 对象

返回: None

cookies_to_driver()

把 cookies 从 session 复制到 driver。

参数说明：

url: str - cookies 的域
driver: WebDriver - 接收 cookies 的 WebDriver对象
session: Session - 复制 cookies 的 Session对象

返回: None

user_agent_to_session()

把 user agent 从 driver 复制到 session。

参数说明：

driver: WebDriver - WebDriver 对象，复制 user agent
session: Session - Session 对象，接收 user agent

返回: None

close_driver()

关闭浏览器，driver 置为 None。

返回: None

close_session()

关闭 session 并置为 None。

返回: None

close()

关闭 driver 和 session。

返回: None

MixPage类

class MixPage()

MixPage 封装了页面操作的常用功能，可在 driver 和 session 模式间无缝切换。切换的时候会自动同步 cookies。
获取信息功能为两种模式共有，操作页面元素功能只有 d 模式有。调用某种模式独有的功能，会自动切换到该模式。
它继承自 DriverPage 和 SessionPage 类，这些功能由这两个类实现，MixPage 作为调度的角色存在。

参数说明：

drission: Drission - Drission 对象，如没传入则创建一个。传入 's' 或 'd' 时快速配置相应模式
mode: str - 模式，可选 'd' 或 's'，默认为'd'
timeout: float - 超时时间，driver 模式为查找元素时间，session 模式为连接等待时间

url_available

返回当前 url 有效性。

返回: bool

change_mode()

切换模式，'d' 或 's'。切换时会把当前模式的 cookies 复制到目标模式。

参数说明：

mode: str - 指定目标模式，'d' 或 's'。
go: bool - 切换模式后是否跳转到当前 url

返回: None

ele()

返回页面中符合条件的元素，默认返回第一个。
如查询参数是字符串，可选'@属性名:'、'tag:'、'text:'、'css:'、'xpath:'方式。无控制方式时默认用 text 方式查找。
如是loc，直接按照内容查询。

参数说明：

loc_or_str: [Tuple[str, str], str, DriverElement, SessionElement, WebElement] - 元素的定位信息，可以是元素对象，loc 元组，或查询字符串
mode: str - 'single' 或 'all‘，对应查找一个或全部
timeout: float - 查找元素超时时间，driver 模式下有效

示例：

接收到元素对象时：返回元素对象对象
用loc元组查找：
- ele.ele((By.CLASS_NAME, 'ele_class')) - 返回第一个class为ele_class的子元素
用查询字符串查找：

属性、tag name和属性、文本、xpath、css selector。

其中，@表示属性，=表示精确匹配，:表示模糊匹配，无控制字符串时默认搜索该字符串。
- page.ele('@class:ele_class') - 返回第一个 class 含有 ele_class 的元素
- page.ele('@name=ele_name') - 返回第一个 name 等于 ele_name 的元素
- page.ele('@placeholder') - 返回第一个带 placeholder 属性的元素
- page.ele('tag:p') - 返回第一个 p 元素
- page.ele('tag:div@class:ele_class') - 返回第一个 class 含有 ele_class 的 div 元素
- page.ele('tag:div@class=ele_class') - 返回第一个 class 等于 ele_class 的 div 元素
- page.ele('tag:div@text():some_text') - 返回第一个文本含有 some_text 的 div 元素
- page.ele('tag:div@text()=some_text') - 返回第一个文本等于 some_text 的 div 元素
- page.ele('text:some_text') - 返回第一个文本含有 some_text 的元素
- page.ele('some_text') - 返回第一个文本含有 some_text 的元素（等价于上一行）
- page.ele('text=some_text') - 返回第一个文本等于 some_text 的元素
- page.ele('xpath://div[@class="ele_class"]') - 返回第一个符合 xpath 的元素
- page.ele('css:div.ele_class') - 返回第一个符合 css selector 的元素

返回: [DriverElement, SessionElement, str] - 元素对象或属性、文本节点文本

eles()

根据查询参数获取符合条件的元素列表。查询参数使用方法和 ele 方法一致。

参数说明：

loc_or_str: [Tuple[str, str], str] - 查询条件参数
timeout: float - 查找元素超时时间，driver 模式下有效

返回: [List[DriverElement or str], List[SessionElement or str]] - 元素对象或属性、文本节点文本组成的列表

cookies_to_session()

从 WebDriver 对象复制 cookies 到 Session 对象。

参数说明：

copy_user_agent:bool - 是否同时复制 user agent

返回: None

cookies_to_driver()

从 Session 对象复制 cookies 到 WebDriver 对象。

参数说明：

url:str - cookies 的域或 url

返回: None

get()

跳转到一个url，跳转前先同步 cookies，跳转后返回目标 url 是否可用。

参数说明：

url: str - 目标url
go_anyway: bool - 是否强制跳转。若目标 url 和当前 url 一致，默认不跳转。
show_errmsg: bool - 是否显示和抛出异常
retry: int - 连接出错时重试次数
interval: float - 重试间隔（秒）
**kwargs - 用于 requests 的连接参数

返回: [bool, None] - url 是否可用

post()

以post方式跳转，调用时自动切换到 session 模式。

参数说明：

url:str - 目标 url
data: dict - 提交的数据
go_anyway: bool - 是否强制跳转。若目标 url 和当前 url 一致，默认不跳转。
show_errmsg: bool - 是否显示和抛出异常
retry: int - 连接出错时重试次数
interval: float - 重试间隔（秒）
**kwargs - 用于 requests 的连接参数

返回: [bool, None] - url是否可用

download()

下载一个文件，返回是否成功和下载信息字符串。改方法会自动避免和目标路径现有文件重名。

参数说明：

file_url: str - 文件 url
goal_path: str - 存放路径，默认为 ini 文件中指定的临时文件夹
rename: str - 重命名文件，不改变扩展名
file_exists: str - 若存在同名文件，可选择 'rename', 'overwrite', 'skip' 方式处理
post_data: dict - post 方式时提交的数据
show_msg: bool - 是否显示下载信息
show_errmsg: bool - 是否显示和抛出异常
**kwargs - 用于 requests 的连接参数

返回: Tuple[bool, str] - 下载是否成功（bool）和状态信息（成功时信息为文件路径）的元组

以下方法和属性只有 driver 模式下生效，调用时会自动切换到 driver 模式

tabs_count

返回标签页数量。

返回: int

tab_handles

返回所有标签页 handle 列表。

返回: list

current_tab_num

返回当前标签页序号。

返回: int

current_tab_handle

返回当前标签页 handle。

返回: str

wait_ele()

等待元素从 dom 删除、显示、隐藏。

参数说明：

loc_or_ele: [str, tuple, DriverElement, WebElement] - 元素查找方式，与ele()相同
mode: str - 等待方式，可选：'del', 'display', 'hidden'
timeout: float - 等待超时时间

返回: bool - 等待是否成功

check_page()

d 模式时检查网页是否符合预期。默认由 response 状态检查，可重载实现针对性检查。

参数说明：

by_requests:bool - 强制使用内置 response 进行检查

返回: [bool, None] - bool 为是否可用，None 为未知

run_script()

执行JavaScript代码。

参数说明：

script: str - JavaScript 代码文本
*args - 传入的参数

返回: Any

create_tab()

新建并定位到一个标签页,该标签页在最后面。

参数说明：

url:str - 新标签页跳转到的网址

返回: None

close_current_tab()

关闭当前标签页。

返回: None

close_other_tabs()

关闭传入的标签页以外标签页，默认保留当前页。

参数说明：

num_or_handle:[int, str] - 要保留的标签页序号或 handle，序号第一个为0，最后为-1

返回: None

to_tab()

跳转到标签页。

参数说明：

num_or_handle:[int, str] - 标签页序号或handle字符串，序号第一个为0，最后为-1

返回: None

to_iframe()

跳转到 iframe，默认跳转到最高层级，兼容 selenium 原生参数。

参数说明：

loc_or_ele:[int, str, tuple, WebElement, DriverElement] - 查找 iframe 元素的条件，可接收 iframe 序号（0开始）、id 或 name、查询字符串、loc参数、WebElement对象、DriverElement 对象，传入 'main' 跳到最高层，传入 'parent' 跳到上一层

示例：

to_iframe('tag:iframe') - 通过传入 iframe 的查询字符串定位
to_iframe('iframe_id') - 通过 iframe 的 id 属性定位
to_iframe('iframe_name') - 通过 iframe 的 name 属性定位
to_iframe(iframe_element) - 通过传入元素对象定位
to_iframe(0) - 通过 iframe 的序号定位
to_iframe('main') - 跳到最高层
to_iframe('parent') - 跳到上一层

返回: None

scroll_to_see()

滚动直到元素可见。

参数说明：

loc_or_ele:[str, tuple, WebElement, DriverElement] - 查找元素的条件，和 ele() 方法的查找条件一致。

返回: None

scroll_to()

滚动页面，按照参数决定如何滚动。

参数说明：

mode: str - 滚动的方向，top、bottom、rightmost、leftmost、up、down、left、right
pixel: int - 滚动的像素

返回: None

refresh()

刷新页面。

返回: None

back()

页面后退。

返回: None

set_window_size()

设置窗口大小，默认最大化。

参数说明：

x: int - 目标宽度
y: int - 目标高度

返回: None

screenshot()

网页截图，返回截图文件路径。

参数说明：

path: str - 截图保存路径，默认为 ini 文件中指定的临时文件夹
filename: str - 截图文件名，默认为页面 title 为文件名

返回: str

chrome_downloading()

返回浏览器下载中的文件列表。

参数说明：

download_path: str - 下载文件夹路径

返回:list

process_alert()

处理提示框。

参数说明：

mode: str - 'ok' 或 'cancel'，若输入其它值，不会按按钮但依然返回文本值
text: str - 处理 prompt 提示框时可输入文本

返回: [str, None] - 提示框内容文本

close_driver()

关闭 driver 及浏览器。

返回: None

close_session()

关闭 session。

返回: None

DriverElement类

class DriverElement()

driver 模式的元素对象，包装了一个 WebElement 对象，并封装了常用功能。

参数说明：

ele: WebElement - WebElement 对象
page: DriverPage - 元素所在的页面对象
timeout: float - 查找元素超时时间（每次查找元素时还可单独设置）

text_node_only:bool - 是否只返回文本节点

返回: List[str]

parents()

返回第 N 层父级元素对象。

参数说明：

num: int - 第几层父元素

返回: DriverElement

nexts()

返回后面第 num 个兄弟元素或节点文本。

参数说明：

num: int - 后面第几个兄弟元素或节点
mode: str - 'ele', 'node' 或 'text'，匹配元素、节点、或文本节点

返回: [DriverElement, str]

prevs()

返回前面第 num 个兄弟元素或节点文本。

参数说明：

num: int - 前面第几个兄弟元素或节点
mode: str - 'ele', 'node' 或 'text'，匹配元素、节点、或文本节点

返回: [DriverElement, str]

attr()

获取元素某个属性的值。

参数说明：

attr: str - 属性名称

返回: str

ele()

返回当前元素下级符合条件的子元素、属性或节点文本。
如查询参数是字符串，可选'@属性名:'、'tag:'、'text:'、'css:'、'xpath:'方式。无控制方式时默认用text方式查找。
如是loc，直接按照内容查询。

参数说明：

loc_or_str: [Tuple[str, str], str] - 元素的定位信息，可以是 loc 元组，或查询字符串
mode: str - 'single' 或 'all'，对应查找一个或全部
timeout: float - 查找元素超时时间

示例：

用loc元组查找：
- ele.ele((By.CLASS_NAME, 'ele_class')) - 返回第一个class为ele_class的子元素
用查询字符串查找：

属性、tag name和属性、文本、xpath、css selector。

其中，@表示属性，=表示精确匹配，:表示模糊匹配，无控制字符串时默认搜索该字符串。
- ele.ele('@class:ele_class') - 返回第一个 class 含有e le_class 的元素
- ele.ele('@name=ele_name') - 返回第一个 name 等于 ele_name 的元素
- ele.ele('@placeholder') - 返回第一个带 placeholder 属性的元素
- ele.ele('tag:p') - 返回第一个 p 元素
- ele.ele('tag:div@class:ele_class') - 返回第一个 class 含有 ele_class 的 div 元素
- ele.ele('tag:div@class=ele_class') - 返回第一个 class 等于 ele_class 的 div 元素
- ele.ele('tag:div@text():some_text') - 返回第一个文本含有 some_text 的 div 元素
- ele.ele('tag:div@text()=some_text') - 返回第一个文本等于 some_tex t的 div 元素
- ele.ele('text:some_text') - 返回第一个文本含有 some_text 的元素
- ele.ele('some_text') - 返回第一个文本含有 some_text 的元素（等价于上一行）
- ele.ele('text=some_text') - 返回第一个文本等于 some_text 的元素
- ele.ele('xpath://div[@class="ele_class"]') - 返回第一个符合 xpath 的元素
- ele.ele('css:div.ele_class') - 返回第一个符合 css selector 的元素

返回: [DriverElement, str]

eles()

根据查询参数获取符合条件的元素列表。查询参数使用方法和 ele 方法一致。

参数说明：

loc_or_str: [Tuple[str, str], str] - 查询条件参数
timeout: float - 查找元素超时时间

返回: List[DriverElement or str]

get_style_property()

返回元素样式属性值。

参数说明：

style: str - 样式属性名称
pseudo_ele: str - 伪元素名称

返回: str

click()

点击元素，如不成功则用 js 方式点击，可指定是否用 js 方式点击。

参数说明：

by_js: bool - 是否用js方式点击

返回: bool

input()

输入文本，返回是否成功。

参数说明：

value: str - 文本值
clear: bool - 输入前是否清除文本框

返回: bool

run_script()

执行 js 代码，传入自己为第一个参数。

参数说明：

script: str - JavaScript文本
*args - 传入的参数

select()

在下拉列表中选择。

参数说明：

text: str - 选项文本

返回: bool - 是否成功

set_attr()

设置元素属性。

参数说明：

attr: str - 参数名
value: str - 参数值

返回: bool -是否成功

drag()

拖拽当前元素一段距离，返回是否拖拽成功。

参数说明：

x: int - 拖拽x方向距离
y: int - 拖拽y方向距离
speed: int - 拖拽速度
shake: bool - 是否随机抖动

返回: bool

drag_to()

拖拽当前元素，目标为另一个元素或坐标元组，返回是否拖拽成功。

参数说明：

ele_or_loc[tuple, WebElement, DrissionElement] - 另一个元素或相对当前位置，坐标为元素中点坐标。
speed: int - 拖拽速度
shake: bool - 是否随机抖动

返回: bool

hover()

在元素上悬停鼠标。

返回: None

SessionElement类

class SessionElement()

session 模式的元素对象，包装了一个Element对象，并封装了常用功能。

参数说明：

ele: HtmlElement - lxml 库的 HtmlElement 对象
page: SessionPage - 元素所在页面对象

parent

返回父级元素对象。

返回: SessionElement

parents()

返回第N层父级元素对象。

参数说明：

num:int - 第几层父元素

返回: SessionElement

nexts()

返回后面第 num 个兄弟元素或节点文本。

参数说明：

num - 后面第几个兄弟元素
mode: str - 'ele', 'node' 或 'text'，匹配元素、节点、或文本节点

返回: [SessionElement, str]

prevs()

返回前 N 个兄弟元素对象。

参数说明：

num - 前面第几个兄弟元素
mode: str - 'ele', 'node' 或 'text'，匹配元素、节点、或文本节点

返回: [SessionElement, str]

attr()

获取元素某个属性的值。

参数说明：

attr: str - 属性名称

返回: str

ele()

根据查询参数获取元素。
如查询参数是字符串，可选'@属性名:'、'tag:'、'text:'、'css:'、'xpath:'方式。无控制方式时默认用text方式查找。
如是loc，直接按照内容查询。

参数说明：

loc_or_str:[Tuple[str, str], str] - 查询条件参数
mode:str - 查找一个或多个，传入'single'或'all'

示例：

用loc元组查找：
ele.ele((By.CLASS_NAME, 'ele_class')) - 返回第一个class为ele_class的子元素
用查询字符串查找：

属性、tag name和属性、文本、xpath、css selector。

其中，@表示属性，=表示精确匹配，:表示模糊匹配，无控制字符串时默认搜索该字符串。

ele.ele('@class:ele_class') - 返回第一个 class 含有 ele_class 的元素
ele.ele('@name=ele_name') - 返回第一个 name 等于 ele_name 的元素
ele.ele('@placeholder') - 返回第一个带 placeholder 属性的元素
ele.ele('tag:p') - 返回第一个 p 元素
ele.ele('tag:div@class:ele_class') - 返回第一个 class 含有 ele_class 的div元素
ele.ele('tag:div@class=ele_class') - 返回第一个 class 等于 ele_class 的div元素
ele.ele('tag:div@text():some_text') - 返回第一个文本含有 some_text 的div元素
ele.ele('tag:div@text()=some_text') - 返回第一个文本等于 some_text 的div元素
ele.ele('text:some_text') - 返回第一个文本含有 some_text 的元素
ele.ele('some_text') - 返回第一个文本含有 some_text 的元素（等价于上一行）
ele.ele('text=some_text') - 返回第一个文本等于 some_text 的元素
ele.ele('xpath://div[@class="ele_class"]') - 返回第一个符合 xpath 的元素
ele.ele('css:div.ele_class') - 返回第一个符合 css selector 的元素

返回: [SessionElement, str]

eles()

根据查询参数获取符合条件的元素列表。查询参数使用方法和ele方法一致。

参数说明：

loc_or_str: [Tuple[str, str], str] - 查询条件参数

返回: List[SessionElement or str]

OptionsManager类

class OptionsManager()

管理配置文件内容的类。

参数说明：

path:str - ini文件路径，不传入则默认读取当前文件夹下的 configs.ini 文件

get_value()

获取配置的值。

参数说明：

section: str - 段落名称
item: str - 配置项名称

返回: Any

get_option()

以字典的格式返回整个段落的配置信息。

参数说明：

section: str - 段落名称

返回: dict

set_item()

设置配置值，返回自己，用于链式操作。

参数说明：

section: str - 段落名称
item: str - 配置项名称
value: Any - 值内容

返回: OptionsManager - 返回自己

save()

保存设置到文件，返回自己，用于链式操作。

参数说明：

path:str - ini 文件的路径，默认保存到模块文件夹下的

返回: OptionsManager - 返回自己

DriverOptions类

class DriverOptions()

chrome 浏览器配置类，继承自 selenium.webdriver.chrome.options 的 Options 类，增加了删除配置和保存到文件方法。

参数说明：

read_file:bool - 创建时是否从 ini 文件读取配置信息

driver_path

chromedriver.exe 的路径。

返回: str

chrome_path

chrome.exe 的路径

返回: str

save()

保存设置到文件，返回自己，用于链式操作。

参数说明：

path:str - ini 文件的路径，默认保存到模块文件夹下的

返回: DriverOptions - 返回自己

remove_argument()

移除一个设置。

参数说明：

value:str - 要移除的属性值

返回: DriverOptions - 返回自己

remove_experimental_option()

移除一个实验设置，传入 key 值删除。

参数说明：

key:str - 要移除的实验设置 key 值

返回: DriverOptions - 返回自己

remove_all_extensions()

移除所有插件，因插件是以整个文件储存，难以移除其中一个，故如须设置则全部移除再重设。

返回: DriverOptions - 返回自己

set_argument()

设置 chrome 属性，无值的属性可设置开关，有值的属性可设置属性的值。

参数说明：

arg:str - 属性名
value[bool, str] - 属性值，有值的属性传入值，没有的传入 bool

返回: DriverOptions - 返回自己

set_headless()

打开或关闭无界面模式。

参数说明：

on_off: bool - 打开或关闭

返回: DriverOptions - 返回自己

set_no_imgs()

是否加载图片。

参数说明：

on_off: bool - 打开或关闭

返回: DriverOptions - 返回自己

set_no_js()

是否禁用 js。

参数说明：

on_off: bool - 打开或关闭

返回: DriverOptions - 返回自己

set_mute()

是否静音。

参数说明：

on_off: bool - 打开或关闭

返回: DriverOptions - 返回自己

set_user_agent()

设置浏览器 user agent。

参数说明：

user_agent:str - user agent 字符串

返回: DriverOptions - 返回自己

set_proxy()

设置代理。

参数说明：

proxy:str - 代理地址

返回: DriverOptions - 返回自己

set_paths()

设置浏览器相关的路径。

参数说明：

driver_path:str - chromedriver.exe 的路径
chrome_path:str - chrome.exe 的路径
debugger_address:str - 调试浏览器地址，例：127.0.0.1:9222
download_path:str - 下载文件路径
user_data_path:str - 用户数据路径
cache_path:str - 缓存路径

参数说明：

driver_path: bool - chromedriver.exe路径
chrome_path: bool - chrome.exe路径

返回: bool

邓华锋 / DrissionPage .gitee-modal { width: 500px !important; }

简介

理念及背景

理念

背景

特性

项目结构

结构图

Drission类

MixPage类

DriverElement类

SessionElement类

简单演示

与selenium代码对比

与requests代码对比

模式切换

获取并打印元素属性

下载文件

安装

使用方法

导入模块

初始化

创建驱动器对象Drission

使用页面对象MixPage

创建对象

访问网页

切换模式

页面属性

页面操作

查找元素

获取元素属性

元素操作

与selenium代码对接

selenium转DrissionPage

DrissionPage转selenium

下载文件

功能

演示

Chrome快捷设置

DriverOptions对象

使用方法

保存配置

ini文件内容

OptionsManager对象

使用示例

easy_set方法

POM模式

其它

DriverPage 和 SessionPage

APIs

Drission类

class Drission()

session

driver

driver_options

session_options

session_options()

proxy

cookies_to_session()

cookies_to_driver()

user_agent_to_session()

close_driver()

close_session()

close()

MixPage类

class MixPage()

url

mode

drission

driver

session

response

cookies

html

title

url_available

change_mode()

ele()

eles()

cookies_to_session()

邓华锋 / DrissionPage