Selenium3 Python WebDriver API源码探析（20）WebDriver协议概述

最新推荐文章于 2024-07-11 17:03:01 发布
最新推荐文章于 2024-07-11 17:03:01 发布
阅读量3w 收藏 6
点赞数 3
分类专栏： Selenium 文章标签： selenium Python webdriver协议 api 原理
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/mighty13/article/details/115255539
版权

WebDriver协议

早期Selenium和WebDriver是两个独立的项目，Selenium早期主要依靠将操作转换为JavaScript然后注入浏览器实现浏览器的自动化，WebDriver将浏览器原生API封装成一套更加面向对象的API，但是由于不同浏览器内核的差异，因此为了适配，必须对不同浏览器实现不同的API。在Selenium2之后两个项目合并，我们常说的Selenium其实主要指的就是WebDriver API。当前Selenium稳定版本的主版本为3，beta版本的Selenium4已经在路上。

Selenium或者WebDriver与浏览器交互的基础是WebDriver协议（W3C推荐标准）。WebDriver协议是一个与操作系统、编程语言无关的通过HTTP协议使用JSON作为传输格式的RESTful Web服务。

WebDriver协议目前有两个版本：

WebDriver协议之前还有一个废弃的JsonWireProtocol协议，具体见https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol

在WebDriver协议模型中牵扯三个对象：

  • 客户端（Client或local end）：可以简单认为就是调用WebDriver API的程序或机器。我们常用的Python WebDriver API就是客户端的一个Python语言绑定。
  • 服务端（Server或remote end）：运行RemoteWebDriver的机器，或者支持WebDriver协议的浏览器，比如支持geckodriver的Firefox浏览器、支持chromedriver的Chrome浏览器。WebDriver协议其实只定义了服务端的行为。
  • WebDriver：即各种浏览器的WebDriver协议实现，比如geckodriver、chromedriver，WebDriver则相当于客户端和服务端的中介，提供WebDriver协议RESTful 服务。客户端通过WebDriver操控服务端（浏览器）。比如Firefox依靠webdriver.xpi扩展来控制浏览器。

客户端运行后，启动1个会话（session），客户端在该会话中通过WebDriver协议 RESTful 服务端点（endpoint，可简单理解为url）向服务端请求，服务器端接受请求后向客户端返回响应。
!在这里插入图片描述

WebDriver协议将端点映射为命令（command）。端点与命令的关系如下（https://www.w3.org/TR/webdriver/#endpoints）：

MethodURI TemplateCommand
POST/sessionNew Session
DELETE/session/{session id}Delete Session
GET/statusStatus
GET/session/{session id}/timeoutsGet Timeouts
POST/session/{session id}/timeoutsSet Timeouts
POST/session/{session id}/urlNavigate To
GET/session/{session id}/urlGet Current URL
POST/session/{session id}/backBack
POST/session/{session id}/forwardForward
POST/session/{session id}/refreshRefresh
GET/session/{session id}/titleGet Title
GET/session/{session id}/windowGet Window Handle
DELETE/session/{session id}/windowClose Window
POST/session/{session id}/windowSwitch To Window
GET/session/{session id}/window/handlesGet Window Handles
POST/session/{session id}/window/newNew Window
POST/session/{session id}/frameSwitch To Frame
POST/session/{session id}/frame/parentSwitch To Parent Frame
GET/session/{session id}/window/rectGet Window Rect
POST/session/{session id}/window/rectSet Window Rect
POST/session/{session id}/window/maximizeMaximize Window
POST/session/{session id}/window/minimizeMinimize Window
POST/session/{session id}/window/fullscreenFullscreen Window
GET/session/{session id}/element/activeGet Active Element
POST/session/{session id}/elementFind Element
POST/session/{session id}/elementsFind Elements
POST/session/{session id}/element/{element id}/elementFind Element From Element
POST/session/{session id}/element/{element id}/elementsFind Elements From Element
GET/session/{session id}/element/{element id}/selectedIs Element Selected
GET/session/{session id}/element/{element id}/attribute/{name}Get Element Attribute
GET/session/{session id}/element/{element id}/property/{name}Get Element Property
GET/session/{session id}/element/{element id}/css/{property name}Get Element CSS Value
GET/session/{session id}/element/{element id}/textGet Element Text
GET/session/{session id}/element/{element id}/nameGet Element Tag Name
GET/session/{session id}/element/{element id}/rectGet Element Rect
GET/session/{session id}/element/{element id}/enabledIs Element Enabled
GET/session/{session id}/element/{element id}/computedroleGet Computed Role
GET/session/{session id}/element/{element id}/computedlabelGet Computed Label
POST/session/{session id}/element/{element id}/clickElement Click
POST/session/{session id}/element/{element id}/clearElement Clear
POST/session/{session id}/element/{element id}/valueElement Send Keys
GET/session/{session id}/sourceGet Page Source
POST/session/{session id}/execute/syncExecute Script
POST/session/{session id}/execute/asyncExecute Async Script
GET/session/{session id}/cookieGet All Cookies
GET/session/{session id}/cookie/{name}Get Named Cookie
POST/session/{session id}/cookieAdd Cookie
DELETE/session/{session id}/cookie/{name}Delete Cookie
DELETE/session/{session id}/cookieDelete All Cookies
POST/session/{session id}/actionsPerform Actions
DELETE/session/{session id}/actionsRelease Actions
POST/session/{session id}/alert/dismissDismiss Alert
POST/session/{session id}/alert/acceptAccept Alert
GET/session/{session id}/alert/textGet Alert Text
POST/session/{session id}/alert/textSend Alert Text
GET/session/{session id}/screenshotTake Screenshot
GET/session/{session id}/element/{element id}/screenshotTake Element Screenshot
POST/session/{session id}/printPrint Page

WebDriver Python API执行流程（反推）

WebDriver客户端API其实就是实现属性或方法到命令，再到WebDriver协议端点的变换过程。

例如：WebDriver类的current_url特性

  1. current_url特性其实是命令Command.GET_CURRENT_URL的执行结果。

    @property
def current_url(self):
     return self.execute(Command.GET_CURRENT_URL)['value']

  2. WebDriver类的execute方法通过command_executor.execute(driver_command, params)执行命令。
    command_executor是一个字符串（服务器url）或者remote_connection.RemoteConnection对象。

  3. remote_connection.RemoteConnection类位于selenium\webdriver\remote\remote_connection.py。
    remote_connection.RemoteConnection类的_commands属性定义了命令和端点之间的关系。
    Command.GET_CURRENT_URL: ('GET', '/session/$sessionId/url')
    remote_connection.RemoteConnection类的execute方法控制服务端执行命令。

  4. WebDriver类在实例化时会传入command_executor参数，command_executor参数即服务端地址。

WebDriver Python API执行流程（正推）

from selenium import webdriver

driver = webdriver.Firefox()
driver.get("http://www.baidu.com")
# 服务端地址
url = driver.command_executor._url  
print(url)

上述代码的执行流程大致如下：

  1. driver = webdriver.Firefox()即对selenium\webdriver\firefox\webdriver.py中的WebDriver类实例化，WebDriver类继承自selenium\webdriver\remote\webdriver.py中的WebDriver类。WebDriver类构造方法中command_executor参数即服务端地址。
    此时WebDriver启动浏览器，加载webdriver.xpi扩展，监听基于WebDriver协议的请求。
    在日志文件geckodriver.log中可以看到类似1116855012551 geckodriver INFO Listening on 127.0.0.1:54499的记录。

  2. driver.get("http://www.baidu.com")相当于执行Command.GET命令。 WebDriver对象依靠remote_connection.RemoteConnection对象command_executor执行命令。 remote_connection.RemoteConnection类中实现了命令到WebDriver协议的映射Command.GET: ('POST', '/session/$sessionId/url')。执行命令相当于向浏览器发送对应请求。WebDriver将请求发送给浏览器。

     def get(self, url):
     self.execute(Command.GET, {'url': url})

  3. 浏览器在接受请求后执行操作（打开百度页面）并返回响应（服务端地址）。WebDriver将响应结果传递给代码。

mighty13
关注
专栏目录
Selenium实例化+WebDriver工作原理及协议
shan286的专栏
07-25 2172
1、在SE的执行过程中，一般都会有如下一行代码，代表着引入webdriver模板： from selenium import webdriver 因为我用的是Chrome浏览器来进行自动化测试，那么会这样进行一个webdriver的实例化： driver = webdriver.Chrome() 2、点击webdriver进入一个__init__.py的文件，可以看到有多个浏览器对应的webriver在这里做了个重命名，比如说火狐浏览器firefox等等，如下图所示： 3、点击上图中的“.
webdriver的协议是什么
qq_45376215的博客
04-19 345
client与driver之间的约定，无论client是使用java实现还是c#实现，只要通过这个约定，client就可以准确的告诉drier它要做什么以及怎么做。这里有webdriver协议的所有endpoint，稍微浏览下就知道这些endpoints涵盖了selenium的所有功能。webdriver协议本身是http协议，数据传输使用json。
WebDriver与浏览器通信的深度剖析与探索
最新发布
weixin_41605826的博客
07-11 824
在自动化测试的世界里，WebDriver无疑是连接测试脚本与浏览器之间的桥梁，它让复杂的自动化测试成为可能。本文将深入探讨WebDriver与浏览器之间的通信机制，揭示它们之间如何协同工作，以及这一过程中涉及的关键技术和挑战。
软件测试面试题：Webdriver的协议是什么？（ ）
一亿并发的博客
04-29 2043
Webdriver的协议是什么？（ ）
webdriver的协议是什么？
weixin_44110034的博客
05-12 295
client与driver之间的约定，无论client是使用java实现还是c#实现，只要通过这个约定，client就可以准确的告诉drier它要做什么以及怎么做。这里有webdriver协议的所有endpoint，稍微浏览下就知道这些endpoints涵盖了selenium的所有功能。webdriver协议本身是http协议，数据传输使用json。
webdriver原理、协议
qq_30235073的博客
06-02 4478
1、webdriver client的原理是什么？ 当测试脚本启动firefox的时候，selenium-webdriver 会首先在新线程中启动firefox浏览器。如果测试脚本指定了firefox的profile，那么就以该profile启动，否则的话就新启1个profile，并启动firefox； firefox一般是以-no-remote的方法启动，启动后selenium-...
selenium webdriver基于python源码案例.pdf
07-20
### selenium webdriver基于python源码案例 #### 一、Selenium简介与环境搭建 **1.1 Selenium概述** Selenium是一个强大的工具集，主要用于自动化Web应用的测试。它支持多种编程语言，如Java、C#、Python等，并能...
selenium webdriver基于python源码案例.zip
03-11
《Selenium WebDriver基于Python源码案例》是一份专为初学者设计的教程，旨在通过实践案例帮助用户快速掌握Selenium WebDriver与Python的结合使用。这个压缩包中的资源，特别是`.epub`格式的电子书，提供了丰富的...
selenium webdriver基于python源码案例.epub
09-27
selenium webdriver基于python源码案例,全是案例适合小白入门学习
selenium+webdriver中文帮助手册（python版）
04-15
个人最近开始学习Selenium，但发现对应python的有用的资料奇少无比，于是 自己努力收集并整理了一些资料 学会搭建环境后的同学，建议先抛弃其他一切资料，先看一遍这个python资料，保证收益匪浅，基本上可以动手做...
selenium webdriver基于python源码案例
04-22
Selenium WebDriver 基于 Python 源码案例 Selenium 是一个用于测试 Web 应用程序用户界面的常用框架。它是一款用于运行端到端功能测试的超强工具。您可以使用多个编程语言编写测试，并且 Selenium 能够在一个或多...
WebDriver 的协议标准 W3C
热门推荐
AI天才研究院
11-23 1万+
Selenium WebDriver 快速入门工程： https://github.com/Jason-Chen-2017/go-selenium import org.openqa.selenium.By import org.openqa.selenium.chrome.ChromeDriver import org.openqa.selenium.c...
web自动化——深刻理解selenium原理
wtf0712的博客
07-18 1185
selenium是一个web自动化测试的开源框架。 它支持多语言：python/java/c#… selenium支持多语言，是因为selenium与浏览器驱动之间是通过http协议进行通信的。 只关心通信的数据是否能够正确解读 ，并不关心这个数据是从哪个客户端来。无论来自python\java,还是jmeter,postman都没有问题。本篇文章中，以requests做为客户端，跳过sel...
selenium启动常用浏览器驱动方式
abcnull 的博客
02-26 2145
selenium 启动常用浏览器驱动方式 一.启动 Chrome 浏览器 方式一：// 驱动路径的 File File file = new File("src/main/resources/drivers/chromedriver-win32.exe"); // 设置系统属性，setProperty() 中两个参数分别是驱动名和 file 绝对路径 System.setProperty("we...
第四篇: Java-Selenium之WebDriver命令(Browser)
Zhen_learn的博客
02-18 401
WebDriver 命令(Browser) Command – driver.get(appUrl) - 打开网页 Command – driver.getTitle() - 获取网页标题 Command – driver.getCurrentUrl() - 获取当前网址 Command – driver.getPageSource() - 获取当前网页pagesource Command – d...
WebDriver 浅析
TAYA1995的博客
09-11 153
WebDriver与之前Selenium的JS注入实现不同，直接利用了浏览器native support来操作浏览器。所以对于不同平台，不同的浏览器，必须依赖一个特定的浏览器的native component来实现把WebDriver API的调用转化为浏览器的native invoke。 在我们new一个WebDriver的过程中，Selenium首先会确认浏览器的native co...
Selenium Webdriver 源码分析之remote/command.py
qq_29582947的博客
01-24 423
在了解command.py的源码前，我们需要先了解下webdriver json wire protocol的基础知识。 基本概念: 所有与浏览器或RemoteWebDriver服务器通信的WebDriver实现都应该使用Webdriver Json Wire Protocol。这个连接协议使用HTTP上的JSON定义了一个RESTful web服务。 注意： 这是所有webdriver客户端实现的基础协议，所有语言都遵循该协议与远程服务进行交互 该协议基于http协议，采用json格式进行数据交换 该协议
Selenium Webdriver 3.X源码分析之command.py
开源优测
10-08 122
点击上方“蓝字”带你去看小星星^_^> Selenium Webdriver3.X源码分析系列第12篇，该系列原则上会将整个源码分享一遍在了解command.py的源码前，我们先大...
Python Selenium WebDriver API详解与操作方法
Selenium WebDriver API 是一个强大的工具，用于自动化浏览器操作，特别是在Python编程环境中。它允许开发者通过编写脚本来控制浏览器行为，实现网站功能测试、数据抓取等任务。Python版的Selenium WebDriver API ...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值