Skip to content

🔨 Drission 对象

Drission对象用于管理WebDriver和Session对象。在多个页面协同工作时，Drission对象用于传递驱动器，使多个页面类可控制同一个浏览器或Session对象。
可直接读取 ini 文件配置信息创建，也可以在初始化时传入配置信息。
在“使用方法->创建页面对象”章节已经涉及过Drission的用法，这里介绍属性和方法。

✅️️ Drission类

初始化参数：

  • driver_or_options：WebDriver对象或DriverOptions、Options类，传入False则创建空配置对象
  • session_or_options：Session对象或设置字典，传入False则创建空配置对象
  • ini_path：ini 文件路径
  • proxy：代理设置，dict类型。格式：{'http': '127.0.0.1:1080', 'https': '127.0.0.1:1080'}

前两个参数可直接接收WebDriver和Session对象，这时后面两个参数无效。
若接收配置对象，则按照配置创建WebDriver和Session对象。

用 ini 文件信息创建：

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

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

传入配置创建：

from MixPage import DriverOptions, Drission

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

📌 session

此属性返回该对象管理的Session对象。

📌 driver

此属性返回该对象管理的WebDriver对象。

📌 driver_options

此属性返回用于创建WebDriver对象的DriverOptions对象。

📌 session_options

此属性以dict形式返回用于创建 Session 对象的配置参数。可传入dict或SessionOptions赋值。

📌 proxy

此属性返回代理信息，dict形式。可传入dict赋值。格式：{'http': '127.0.0.1:1080', 'https': '127.0.0.1:1080'}

📌 debugger_progress

此属性返回浏览器进程（如有）。

📌 kill_browser()

此方法用于关闭浏览器进程。

参数： 无

返回：None

📌 get_browser_progress_id()

此方法用于获取浏览器进程 id。

参数： 无

返回：None

📌 hide_browser()

此方法用于隐藏浏览器进程窗口。

参数： 无

返回：None

📌 show_browser()

此方法用于显示浏览器进程窗口。

参数： 无

返回：None

📌 set_cookies()

此方法用于设置cookies。可选择对某个对象设置。

参数：

  • cookies：cookies信息，可为CookieJar,list,tuple,str,dict
  • set_session：是否设置Session对象的cookies
  • set_driver：是否设置浏览器的cookies

返回：None

📌 cookies_to_session()

此方法用于把WebDriver对象的cookies复制到Session对象。

参数：

  • copy_user_agent：是否复制 user agent 信息

返回：None

📌 cookies_to_driver()

此方法用于把Session对象的cookies复制到WebDriver对象。
复制cookies到浏览器必须指定域名。

参数：

  • url：作用域

返回：None

📌 close_driver()

此方法用于关闭WebDriver对象，可选择是否关闭浏览器进程。

参数：

  • kill：是否关闭浏览器进程

返回：None

📌 close_session()

此方法用于关闭Session对象。

参数： 无

返回：None

📌 close()

此方法用于关闭Session和WebDriver对象。

参数： 无

返回：None