webdriver常用的API翻译与解析

2023年9月5日 215次阅读来源: bldevil

WebDriver是相当强大的，利用它几乎能模拟实现浏览器的一切操作行为。当然，它的功能虽强大，有时候操作却很不方便（我真的没有特指frame的切换问题）。下面我就介绍一下WebDriver一些常见的API。

WebDriver英文原版API传送门：http://selenium-python.readthedocs.org/en/latest/api.html

Webdriver初接触

要使用Webdriver，首先要把它导入进来。推荐的导入方式是:

from selenium import webdriver

然后把浏览器句柄赋给一个对象:

driver= webdriver.Chrome()

利用driver对象来调用下面的API

WebdriverAPI（按照首字母排序）

add_cookie(cookie_dict)

添加一个cookie到当前的会话。

l参数:

cookie_dict:字典对象，必要的keys有“name”和“value”，可选的keys有path”, “domain”,“secure”, “expiry”

l使用示例:

driver.add_cookie({"name" : "foo", "value" : "bar"})
driver.add_cookie({"name" : "foo", "value" : "bar", "path" : "/"})
driver.add_cookie({"name" : "foo", "value" : "bar", "path" : "/", "secure":True})

back()

控制浏览器后退

l使用示例:

driver.back()

close()

关闭当前窗口

l使用示例:

driver.close()

create_web_element(element_id)

创建一个具有特定element_id的web对象（有用吗？）

delete_all_cookies()

删除会话范围内所有的cookies

l使用示例:

driver.delete_all_cookies()

delete_cookie(name)

删除会话中指定名称为内name的cookie

l使用示例:

driver.delete_cookie("my_cookie")

execute(driver_command,params=None)

发送一个由command.CommandExecutor执行的命令

l参数:

driver_command:命令的名称，string类型

params:命令的参数，dictionary对象，可包括多个参数

l返回值:命令执行完毕的JSON响应，加载到一个dictionary对象

l使用示例:其实很多Webdriver的API都是基于这个函数封装的，如通用查找函数find_element的定义如下:

def find_element(self,by=By.ID, value=None):
if isinstance(by, tuple) or isinstance(value, int)or value==None:
raise InvalidSelectorException("Invalid locatorvalues passed in")
returnself.execute(Command.FIND_ELEMENT,
                             {"using": by, "value": value})["value"]

最后一句话执行了FIND_ELEMENT命令，参数是using(by)和value(value)，返回了dictionary类型的命令执行结果，并取其中的value。

execute_async_script(script,*args)

在当前窗口或框架中，异步执行 javascript脚本（可以边操作边执行）

l参数:

script:待执行的 javascript脚本

params:任何用于上述javascript的参数（很霸气有木有）

l返回值:无

l使用示例:

driver.execute_async_script("document.title")

execute_script(script,*args)

在当前窗口或框架中，同步执行javascript脚本

l参数:

script:待执行的javascript脚本

params:任何用于上述javascript的参数

l返回值:无

l使用示例:

driver.execute_script("document.title")

find_element(by,value)

查找元素，可适应所有的查找方式， find_element_by_*函数就是调用它来实现的。

l参数:

by:查找元素的方法，包括id、name、link text、xpath、class name…

value:需要查找的内容

l返回值:找到就返回元素的对象;找不到的话抛出异常

l使用示例:

driver.find_element("name","element_name")#注意两个参数都要加引号

find_element_by_(args*)

包括一批查找元素的方法，它们比较类似，所以一起写了。包括id、name、class_name、css_selector、link_text、partial_link_text、xpath，以后将在如何查找页面元素的博文里详细讲解

l参数:

args:待查找的内容

l返回值:找到就返回元素的对象;找不到的话抛出异常

l使用示例:

driver.find_element_by_class_name("foo")
driver.find_element_by_css_selector("#foo")
driver.find_element_by_id("foo")
driver.find_element_by_link_text("Sign In")
driver.find_element_by_name("foo")
driver.find_element_by_partial_link_text("Sign")
driver.find_elemdriver.find_element_by_tag_name("foo")
driver.find_element_by_xpath("//div/td[1]")

find_elements(by,value)

跟find_element函数类似，不同的是可查找多个匹配的元素

l参数:

by:查找元素的方法，包括id、name、link text、xpath、class name…

value:需要查找的内容

l返回值:返回所有匹配的元素对象，放在list中;找不到的话抛出异常

l使用示例:

driver.find_elements("name","element_name")

find_elements_by_(args*)

不用我赘述了吧，结合find_element_by_*和find_elements就懂了

foward()

控制浏览器前进

l使用示例:

driver.foward()

get(url)

在当前浏览器的中加载一个网页

l参数:

url:需要加载的网址（强烈建议使用完整的URL，否则会加载失败）

l使用示例:

driver.get("http://www.baidu.com")

get_cookie(name)

根据名称获取cookie

l返回值:

如果找到了就返回cookie；否则返回none

l使用示例:

driver.get_cookie("my_cookie")

get_cookies()

查找当前会话中所有的cookies

l返回值:

如果找到了就返回一个dictionaries对象，包含所有cookies

l使用示例:

driver.get_cookies()

get_window_position()

获取当前浏览器窗口的坐标，是根据浏览器左上角和屏幕左上角的相对位置计算的

l返回值:

一个包含x、y坐标的字典对象。

l使用示例:

print driver.get_window_position()

get_window_position(windowHandle=“current“)

获取当前浏览器窗口的坐标，是根据浏览器左上角和屏幕左上角的相对位置计算的

l参数:

windowHandle:默认是当前窗口，也可以指定一个窗口的句柄

l返回值:

一个包含x、y坐标的字典对象。

l使用示例:

print driver.get_window_position()

get_window_size(windowHandle=“current“)

获取当前浏览器窗口的高度和宽度

l参数:

windowHandle:默认是当前窗口，也可以指定一个窗口的句柄

l返回值:

一个包含width、height的字典对象。

l使用示例:

print driver.get_window_size()

implicitly_wait(time_to_wait)

设置一个超时时间，隐式地等待元素的查找和命令的执行。每次会话中，这个函数只需要被调用一次。如果要设置execute_async_script函数的超时时间，参阅set_script_timeout函数。

l参数:

time_to_wait:超时时间，以秒为单位

l使用示例:

driver.implicitly_wait(30)

is_online()

判断浏览器是否在线。（我把网络断开了，返回值还是TRUE，谁能告诉我是怎么回事）

l返回值:

在线返回True，不在线返回false

l使用示例:

print driver.is_online()

maximize_window()

浏览器窗口最大化

l使用示例:

driver.maximize_window()

quit()

退出，并且关闭所有相关的窗口

l使用示例:

driver.quit()

refresh()

刷新当前页面

l使用示例:

driver.refresh()

save_screenshot(filename)

获取当前浏览器窗口的截图

l参数:

filename:保存截图的文件名，使用完整路径

l返回值:

如果有任何IOError,返回false；否则返回true

l使用示例:

driver.save_screenshot("/Screenshots/foo.png")
driver.save_screenshot("D:/Screenshots/foo.png")

set_page_load_timeout(time_to_wait)

设置等待网页加载的时间，直到抛出错误

l参数:

time_to_wait:等待时间，以秒为单位

l使用示例:

driver.set_page_load_timeout(30)

set_script_timeout(time_to_wait)

设置等待execute_async_script函数执行javascript的时间，直到抛出错误

l参数:

time_to_wait:等待时间，以秒为单位

l使用示例:

driver.set_script_timeout(30)

set_window_position(x,y,windowHandle=“current“)

设置浏览器窗口的x、y坐标

l参数:

x:设置窗口位置的x坐标像素

y:设置窗口位置的y坐标像素

windowHandle:窗口的句柄，默认是当前窗口，也可以指定窗口

l使用示例:

driver.set_window_position(0,0)

set_window_size(width,height,windowHandle=“current“)

设置浏览器窗口的高度和宽度

l参数:

width:设置窗口位置的宽度像素值

height:设置窗口位置的高度像素值

windowHandle:窗口的句柄，默认是当前窗口，也可以指定窗口

l使用示例:

driver.set_window_size(800,600)

switch_to_active_element()

切换至焦点所在的元素，如果没有焦点，就切换至BODY

l使用示例:

driver.switch_to_active_element()

switch_to_alert()

把焦点切换至页面上的一个弹出框

l使用示例:

driver.switch_to_alert()

switch_to_default_content()

把焦点切换至默认的frame上

l使用示例:

driver.switch_to_default_content()

switch_to_frame(frame_reference)

把焦点切换至特定的frame中，可以根据id、name、webelement指定frame

l参数:

frame_reference:可以是frame的名称，也可以是frame的序号，也可以是一个iframe元素

l使用示例:

driver.switch_to_frame("frame_name")
driver.switch_to_frame(1)
driver.switch_to_frame(driver.find_elements_by_tag_name("iframe")[0])

switch_to_window(window_name)

把焦点切换至特定的窗口中

l参数:

window_name:可以是窗口的名称也可以是窗口的句柄

l使用示例:

driver.switch_to_window("main")
driver.switch_to_window(driver.window_handles[1])

Webdriver属性

application_cache

获取一个ApplicationCache对象，来跟浏览器缓存进行交互

l使用示例:

driver.application_cache

current_url

获取当前url

l使用示例:

driver.current_url

current_window_handle

获取当前窗口的句柄

l使用示例:

Main_window=driver.current_window_handle

name

获取当前运行实例的底层浏览器的名称

l使用示例:

print driver.name

Page_source

获取当前页面的源代码

l使用示例:

driver.page_source#要print的人请自重，网页较大时不是一般的卡

title

获取当前页面的标题

l使用示例:

Print driver.title

Window_handles

获取当前会话中所有的窗口句柄

l返回值:

一个list，包含所有窗口句柄

l使用示例:

Print driver.title

    原文作者：bldevil
    原文地址: https://blog.51cto.com/4867394/1338146
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。

Webdriver初接触

WebdriverAPI（按照首字母排序）

add_cookie(cookie_dict)

back()

close()

create_web_element(element_id)

delete_all_cookies()

delete_cookie(name)

execute(driver_command,params=None)

execute_async_script(script,*args)

execute_script(script,*args)

find_element(by,value)

find_element_by_*(args)

find_elements(by,value)

find_elements_by_*(args)

foward()

get(url)

get_cookie(name)

get_cookies()

get_window_position()

get_window_position(windowHandle=“current“)

get_window_size(windowHandle=“current“)

implicitly_wait(time_to_wait)

is_online()

maximize_window()

quit()

refresh()

save_screenshot(filename)

set_page_load_timeout(time_to_wait)

set_script_timeout(time_to_wait)

set_window_position(x,y,windowHandle=“current“)

set_window_size(width,height,windowHandle=“current“)

switch_to_active_element()

switch_to_alert()

switch_to_default_content()

switch_to_frame(frame_reference)

switch_to_window(window_name)

Webdriver属性

application_cache

current_url

current_window_handle

name

Page_source

title

Window_handles

find_element_by_(args*)

find_elements_by_(args*)