📒 v3.x

v3.2.35

• 修复浏览器窗口最小化时不响应模拟操作的问题
• 接管浏览器无需'--remote-allow-origins=*'参数
• tabs属性忽略隐私声明
• 修复 8x 版浏览器选择下拉列表时报错问题
• 修复某些情况下下拉框不触发联动的问题
• 修复配置文件损坏时出现的问题
• 修复get()方法url参数含某些特殊字符时连接失败的问题

v3.2.33

• 无界面 Linux 自动进入无头模式
• 添加 MAC 和 Linux 系统默认浏览器路径
• 修复元素截图时可能出现的问题
• 修复quit()没有正确等待浏览器进程结束问题
• 屏蔽 MAC 和 Linux 系统多余的提示
• 修复set.timeouts()没有正确设置timeout属性的问题
• 修复关闭 tab 时小几率报错问题
• 修复某些情况下元素size不准确问题

v3.2.31

• 页面类增加user_agent属性
• get_src()方法增加base64_to_bytes参数
• 重新设计find_tabs()方法
• 使用新版的DownloadKit，下载增加追加模式
• new_tab()方法的switch_to属性默认改为False
• scroll.to_see()方法的center参数默认改为None
• ChromiumOptions执行set_argument('--headless')时能自动使用正确的写法
• get()支持 ipv6
• 元素屏幕坐标会乘以像素比再返回
• 问题修复
  • 修复wait.data_packets()出现的小概率丢失目标报错
  • 修复当网站 headers 不规范时获取不到编码问题
  • 解决滚动后点击被页面上固定元素遮挡问题
  • 修复某些情况下back()后退不准确的情况
  • 修复'Secure-aa'和'Host-'开头的 cookie 不能设置的问题
  • 修复WebPage的get_cookies()方法不能获取所有域名的问题
  • 修复wait.load_start()不能正确设置超时的问题
  • 修复录屏视频编码一些电脑不支持的问题

v3.2.30

• 优化抓取数据包逻辑，wait.data_packets()删除targets参数
• 动作链type()可接收list和tuple
• 浏览器页面对象现在可用 xpath 直接返回文本或注释
• 恢复对 python 3.6 支持
• 完全删除之前声明废弃的方法和属性
• 增加auto_port模式可使用端口范围
• 修复select.by_index()报错
• 修复get_session_storage()报错
• 修复下拉框没有触发onChange问题
• 修复<iframe>中元素使用s_ele()时出现的问题
• 微调run_js()逻辑

v3.2.26

• 新功能
  • 相对定位增加child()和children()方法
  • 相对定位增加ele_only参数
  • 页面对象增加get_frames()方法
  • 页面对象增加wait.new_tab()方法
  • 页面对象增加wait.data_packets()方法
  • ChromiumPge增加find_tabs()方法
  • 元素对象增加focus()方法
  • 元素对象增加states.is_checked属性
  • 录屏功能增加非节俭模式和 js 模式
  • 可设置无法点击时抛出异常
  • 元素和动作链增加双击方法
• api 和特性变更
  • click()删除wait_loading参数
  • click.at()增加count参数
  • drag()和drag_to()的speed参数改为duration
  • set_headless()方法适配新版浏览器
  • ChromiumPage创建时可只接受端口号
  • new_tab()现在会返回新标签页 id
  • get_frame()方法增加timeout参数，且可接收 id 或 name 为条件
  • ChromiumFrame的wait属性增加元素特征
  • 录屏功能 api 调整
• 优化和修复
  • 修复同域ChromiumFrame没有及时关闭连接问题
  • 改进 cookies 处理逻辑
  • 自动用'127.0.0.1'替换'localhost'以提高速度
  • 浏览器路径可接受文件夹路径
  • 提高ChromiumFrame和查找元素稳定性
  • 修复get_local_storage()和get_session_storage()获取所有数据时的问题
  • js 返回字典时能正确解析
  • 修复get_src()某情况下timeout失效问题
  • 修复Keys.ENTER没有正确回车问题

v3.2.19

• 修改click()策略，默认强制模拟点击
• click()增加timeout参数
• 页面对象添加重试次数和间隔设置
• 不使用 ini 文件时也能适配 Chrome 111 版

v3.2.16

• 适配 Chrome 111 版
• 修复 cookies 相关问题
• 修复浏览器页面对象set_headers()方法无效问题
• 浏览器页面对象get_cookiees()方法增加all_domains参数
• 优化输入文本前的点击
• WebPage的set_cookies()方法删除两个参数

v3.2.14

• 查找元素增加^和$符号，表示匹配开头和结尾内容
• 页面对象增加rect.window_state属性
• 页面对象增加is_alive属性
• 元素对象等待增加enabled()、disabled()、disable_or_deleted()方法
• 列表元素增加by_loc()、cancel_by_loc()、all()方法
• get_cookies()增加all_info参数
• Session对象重定向默认为True
• 去除对 tldextract 库依赖
• 改善<iframe>等待
• 提高启动速度
• 优化元素等待逻辑和下拉菜单逻辑

v3.2.12

• 支持对异域<iframe>元素内的元素截图
• 截图增加as_base64参数
• 页面对象增加滚动行为和等待滚动结束设置
• 优化连接浏览器和页面滚动逻辑
• 修复保存图片未正确等待问题
• 修正元素size属性返回顺序

v3.2.11

• 增加录屏功能
• click()删除retry和timeout参数
• get_src()和save()增加timeout参数
• 增加NoResourceError异常
• 允许指定使用系统安装的浏览器用户数据文件夹
• 一些其它优化

v3.2.7

• ActionChains导入路径改为from DrissionPage.common import ActionChains
• Keys导入路径改为from DrissionPage.common import Keys
• 增加By类
• 解决启动浏览器时冲突问题
• 修复图片保存和ChromiumPage创建时可能遇到的问题

v3.2.5

• 浏览器元素增加是否被遮盖属性
• 浏览器元素增加等待被遮盖和等待遮盖取消方法
• 增加WebPageTab对象，从WebPage生成，可切换模式
• WebPage的get_tab()方法返回WebPageTab对象
• to_tab()、close_tabs()、close_other_tabs()方法可接收标签页对象
• to_front()方法移到set属性，并增加可指定标签页功能
• 修复用 driver 创建ChromiumPage时初始化不正确的问题

v3.2.3

• 特性改变

  • WebPage取消自动模式切换
  • 找不到元素时返回NoneElement，还支持抛出异常
  • 下载默认使用浏览器
  • 元素wait_ele()方法取消，改为等待自身状态改变

• 大量整合同类型的 api

• 新增功能

  • 拦截上传控件自动填写路径
  • 优先读取项目路径下的 ini 文件
  • 查找元素增加或语法
  • 新增一批异常
  • 新增命令行工具
  • 页面和元素对象新增一批位置属性
  • SessionPage新增一批设置方法
  • 新增几个等待方法
  • 新增get_frame()方法

• 优化和修复

  • 对程序底层和业务逻辑进行了重新梳理，优化程序逻辑，大幅增强稳定性
  • 新旧版本完全隔离，新版以后开发可放飞自我，无需担心影响以前用MixPage开发的程序
  • 现在会返回开发者能看懂的异常信息
  • 修复页面加载和退出触发弹窗引起的问题
  • 修复<iframe>加载时可能出现的 500 错误
  • 修复异域<iframe>点击问题
  • 没有位置和大小信息的元素在获取这些信息时，现在会抛出异常
  • 修复内存没有正确释放的问题
  • 修复点击被固定栏遮挡问题
  • 接管新出现的<iframe>会自动等待内容加载
  • 修复<iframe>在同域和异域间互相跳转时会卡住的问题
  • 修复<iframe>内元素截图出现偏移问题

v3.1.6

• ChromiumPage添加latest_tab属性

• WebPage初始化删除tab_id参数

• 修复页面未加载完可能获取到空元素的问题

• 修复新标签页重定向时获取文档不正确问题

• 修复使用多标签页或 iframe 时内存未释放问题

• 增强稳定性

v3.1.1

• 增强下载功能

  • ChromiumPage也可以使用内置下载器下载文件
  • 可拦截并接管浏览器下载任务
  • 新增download_set属性对下载参数进行设置
  • 增加wait_download_begin()方法

• 改进浏览器启动设置

  • 优化 ini 文件结构
  • 新增ChromiumOptions取代DriverOptions，完全摆脱对 selenium 的依赖
  • 新增自动分配端口功能
  • 优化SessionOptions设计，增加一系列设置参数的方法
  • 改进对用户配置文件的设置

• 对部分代码进行重构

  • 优化页面对象启动逻辑
  • 优化配置类逻辑
  • 优化项目结构

• 细节

  • 上传文件时支持传入相对路径

• bug 修复

  • 修复get_tab()出错问题
  • 修复新浏览器第一次新建标签页时不正确切换的问题
  • 修复关闭当前标签页出错问题
  • 修复改变浏览器窗口大小出错问题

v3.0.34

• WebPage删除check_page()方法
• DriverOptions和easy_set的set_paths()增加browser_path参数
• DriverOptions增加browser_path属性
• ChromiumFrame现在支持页面滚动
• 改进滚动到元素功能
• 修改SessionElement相对定位参数顺序
• SessionPage也可以从 ini 文件读取 timeout 设置
• ini 文件中session_options增加timeout项
• SessionOptions增加timeout属性、set_timeout()方法
• 优化和修复一些问题

v3.0.31

• run_script()、run_async_script()更名为run_js和run_async_js()
• 返回的坐标数据全部转为int类型组成的tuple
• 修改注释

v3.0.30

• 元素增加m_click()方法
• 动作链增加type()、m_click()、r_hold()、r_release()、m_hold()、m_release()方法
• 动作链的on_ele参数可接收文本定位符
• WebPage、SessionPage、ChromiumPage增加set_headers()方法

v3.0.28

• 各种大小、位置信息从dict改为用tuple返回
• 改进ChromiumFrame
• 修复小窗时定位不准问题，修复 iframe 内元素无法获取 s_ele() 问题
• 增加wait_loading方法和参数
• 其它优化和问题修复

v3.0.22

• change_mode()增加copy_cookies参数
• 调整WebPage生成的元素对象的prev()、next()、before()、after()参数顺序
• 修复读取页面时小概率失效问题
• 用存根文件取代类型注解

v3.0.20

重大更新。推出WebPage，重新开发底层逻辑，摆脱对 selenium 的依赖，增强了功能，提升了运行效率。支持 chromium 内核的浏览器（如 chrome 和 edge）。比MixPage有以下优点：

• 无 webdriver 特征
• 无需为不同版本的浏览器下载不同的驱动
• 运行速度更快
• 可以跨 iframe 查找元素，无需切入切出
• 把 iframe 看作普通元素，获取后可直接在其中查找元素，逻辑更清晰
• 可以同时操作浏览器中的多个标签页，即使标签页为非激活状态
• 可以直接读取浏览器缓存来保持图片，无需用 GUI 点击保存
• 可以对整个网页截图，包括视口外的部分（90以上版本浏览器支持）

其它更新：

• 增加ChromiumTab和ChromiumFrame类用于处理 tab 和 frame 元素
• 新增与WebPage配合的动作链接ActionChains
• ini 文件和DriverOption删除set_window_rect属性
• 浏览器启动配置实现对插件的支持
• 浏览器启动配置实现对experimental_options的prefs属性支持