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_cachecurrent_url
获取当前url
l使用示例:
driver.current_urlcurrent_window_handle
获取当前窗口的句柄
l使用示例:
Main_window=driver.current_window_handlename
获取当前运行实例的底层浏览器的名称
l使用示例:
print driver.namePage_source
获取当前页面的源代码
l使用示例:
driver.page_source#要print的人请自重，网页较大时不是一般的卡title
获取当前页面的标题
l使用示例:
Print driver.titleWindow_handles
获取当前会话中所有的窗口句柄
l返回值:
一个list，包含所有窗口句柄
l使用示例:
Print driver.title转载于:https://blog.51cto.com/4867394/1338146
1981
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
