📒 v1.5-v2.x

v1.5 至 v2.x 版本，基于 selenium 控制浏览器，用作者自制的功能收发数据包。

v2.7.3

• 页面对象和元素对象的screenshot_as_bytes()方法合并到screenshot()
• input()方法接收非文本参数时自动转成文本输入

v2.7.2

• d 模式页面和元素对象增加screenshot_as_bytes()方法

v2.7.1

• DriverPage
  • 增加get_session_storage()、get_local_storage()、set_session_storage()、set_local_storage()、clean_cache()方法
  • run_cdp()的cmd_args参数改为**cmd_args
• 关闭 driver 时会主动关闭 chromedriver.exe 的进程
• 优化关闭浏览器进程逻辑

v2.6.2

• d 模式增加stop_loading()方法
• 优化完善监听器功能

v2.6.0

• 新增Listener类
  • 可监听浏览器数据包
  • 可异步监听
  • 可实现每监听到若干数据包执行操作
• 放弃对selenium4.1以下的支持
• 解决使用新版浏览器时出现的一些问题

v2.5.9

• 优化 s 模式创建连接的逻辑

v2.5.7

• 列表元素select()、deselect()等方法添加timeout参数，可等待列表元素加载
• 优化了对消息提示框的处理
• drag()和drag_to()不再检测是否拖拽成功，改成返回None
• DriverOptions对象从父类继承的方法也支持链式操作
• 其它优化和问题修复

v2.5.5

• DriverPage添加run_cdp()方法
• get()和post()方法删除go_anyway参数
• 连接重试默认不打印提示

v2.5.0

• 用 DownloadKit 库替代原来的download()方法，支持多线程并发
• DriverPage增加set_ua_to_tab()方法
• 删除scroll_to()方法
• 其它优化和问题修复

v2.4.3

• wait_ele()、to_frame()、scroll_to()改用类的方式，避免使用字符串方式选择功能
• scroll_to()方法改为scroll属性
• 滚动页面或元素增加to_location()方式
• 优化Select类用法

v2.3.3

• DriverPage添加forward()方法
• DriverPage的close_current_tab()改为close_tabs()，可一次过关闭多个标签页
• DriverPage添加run_async_script()
• DriverPage添加timeouts属性
• DriverPage添加set_timeouts()方法
• DriverElement添加scroll_to()方法，可在元素内滑动滚动条
• DriverOptions添加set_page_load_strategy()方法
• ini 文件增加page_load_strategy、set_window_rect、timeouts三个属性
• 其它优化和问题修复

v2.2.1

• 新增基于页面布局的相对定位方法left()，right()，below()，above()，near()，lefts()，rights()，belows()，aboves()，nears()
• 修改基于 DOM 的相对定位方法：删除parents()方法，parent属性改为 parent()方法，next属性 改为next()方法，prev属性改为prev()方法，nexts()和prevs() 方法改为返回多个对象
• 增加after()，before()，afters()，before()等基于 DOM 的相对定位方法
• 定位语法增加@@和@@-语法，用于同时匹配多个条件和排除条件
• 改进ShadowRootElement功能，现在在 shadow-root 下查找元素可用完全版的定位语法。
• DriverElement的after和before属性改为pseudo_after和pseudo_before
• DriverElement的input()增加timeout参数
• DriverElement的clear()增加insure_clear参数
• 优化DriverElement的submit()方法
• DriverPage增加active_ele属性，获取焦点所在元素
• DriverPage的get_style_property()改名为style()
• DriverPage的hover()增加偏移量参数
• DriverPage的current_tab_num改名为current_tab_index
• DriverPage的to_frame()方法返回页面对象自己，便于链式操作
• 优化自动下载 driver 逻辑
• set_paths()增加local_port参数
• 默认使用9222端口启动浏览器
• 其它优化和问题修复

v2.0.0

• 支持从DriverElement或 html 文本生成SessionElement，可把 d 模式的页面信息爬取速度提高几个数量级（使用新增的s_ele()和s_eles()方法）
• 支持随时隐藏和显示浏览器进程窗口（只支持 Windows 系统）
• s 模式和 d 模式使用相同的提取文本逻辑，d 模式提取文本效率大增
• input()能自动检测以确保输入成功
• click()支持失败后不断重试，可用于确保点击成功及等待页面遮罩层消失
• 对 linux 和 mac 系统路径问题做了修复
• download()能更准确地获取文件名
• 其它稳定性和效率上的优化

v1.11.7

• SessionOptions增加set_headers()方法
• 调整MixPage初始化参数
• click()增加timeout参数，修改逻辑为在超时时间内不断重试点击。可用于监视遮罩层是否消失
• 处理process_alert()增加timeout参数
• 其他优化和问题修复

v1.11.0

• set_property()方法改名为set_prop
• 增加prop()
• clear()改用 selenium 原生
• 增加r_click()和r_click_at()
• input()返回None
• 增加input_txt()

v1.10.0

• 优化启动浏览器的逻辑
• 用 debug 模式启动时可读取启动参数
• 完善select标签处理功能
• MixPage类的to_iframe()改名为to_frame()
• MixPage类的scroll_to()增加'half'方式，滚动半页
• Drission 类增加kill_browser()方法

v1.9.0

• 元素增加click_at()方法，支持点击偏移量
• download()支持重试
• 元素input()允许接收组合键，如ctrl+a
• 其它优化

v1.8.0

• 添加retry_times和retry_interval属性，可统一指定重连次数
• 元素对象增加raw_text属性
• 元素查找字符串支持极简模式，用x表示xpath、c表示css、t表示tag、tx表示text
• s 模式元素text尽量与 d 模式保持一致
• 其它完善和问题修复

v1.7.7

• 创建WebDriver时可自动下载 chromedriver.exe
• 修复获取不到content-type时会出现的问题

v1.7.1

• d 模式如指定了调试端口，可自动启动浏览器进程并接入
• 去除对 cssselect 库依赖
• 提高查找元素效率
• 调整获取元素 xpath 和 css_path 逻辑

v1.7.0

• 优化cookies相关逻辑
• MixPage增加get_cookies()和set_cookies()方法
• 增加SessionOptions类
• 浏览文件DriverElement增加remove_attr()方法
• 修复MixPage初始化时Session导入cookies时的问题
• MixPage的close_other_tabs()方法现在可以接收列表或元组以保留多个 tab
• 其它优化

v1.6.1

• 增加.和#方式用于查找元素，相当于@Class和@id
• easy_set 增加识别 chrome 版本并自动下载匹配的 chromedriver.exe 功能
• 改进配置功能
• 修复 shadow-root 方面的问题

v1.5.4

• 优化获取编码的逻辑
• 修复下载不能显示进度的问题

v1.5.2

• 修复获取 html 时会把元素后面的文本节点带上的问题
• 修复获取编码可能出现的错误
• 优化download()和获取编码代码

v1.5.1

• 修复获取编码可能出现的 bug

v1.5.0

• s 模式使用 lxml 库代替 requests_html 库
• 可直接调用页面对象和元素对象获取下级元素，element('@id=ele_id')等价于element.ele('@id=ele_id')
• nexts()、prevs()方法可获取文本节点
• 可获取伪元素属性及文本
• 元素对象增加link和inner_html属性
• 各种优化