selenium3基础知识

环境搭建

• Python3+Selenium3自动化测试-(准备)
  （一）安装selenium
  （二）selenium3 浏览器驱动

Python安装  
selenium安装  pip install selenium
浏览器驱动driver安装(zip文件解压至python安装目录或推荐放置在Python/scripts目录中)

测试搭建情况:

from selenium import webdriver
from time import sleep

#引入浏览器启动
driver = webdriver.Chrome()
#driver = webdriver.Firefox()
#driver = webdriver.Ie()
driver.get("https://www.baidu.com")
sleep(5)  #停5秒
driver.quit()

selenium定位方法

*（三）selenium元素定位

Selenium提供了8种定位方式。

Chrome插件 Ranorex Selocity

Ranorex Selocity 是一个类似firepath的chrome插件，也是selenium官方推荐的一款插件。 简单易用，通过插件可以快速获取页面元素的css定位和xpath定位，甚至linktext定位。

Firefox在55版本后包括55版本（如果没记错的话），用了全新的内核引擎，旧插件都不在支持。而Firebug也不再维护，最新一次更新看了下是停留在2017.03。

一、十八种定位方法

前八种是大家都熟悉的，经常会用到的

1.id定位：find_element_by_id(self, id_)
2.name定位：find_element_by_name(self, name)
3.class定位：find_element_by_class_name(self, name)
4.tag定位：find_element_by_tag_name(self, name)
5.link定位：find_element_by_link_text(self, link_text)
6.partial_link定位find_element_by_partial_link_text(self, link_text)
7.xpath定位：find_element_by_xpath(self, xpath)
8.css定位：find_element_by_css_selector(self, css_selector）

这八种是复数形式

9.id复数定位find_elements_by_id(self, id_)
10.name复数定位find_elements_by_name(self, name)
11.class复数定位find_elements_by_class_name(self, name)
12.tag复数定位find_elements_by_tag_name(self, name)
13.link复数定位find_elements_by_link_text(self, text)
14.partial_link复数定位find_elements_by_partial_link_text(self, link_text)
15.xpath复数定位find_elements_by_xpath(self, xpath)
16.css复数定位find_elements_by_css_selector(self, css_selector)

这两种就是快失传了的

find_element(self, by='id', value=None)
find_elements(self, by='id', value=None)

二、element和elements傻傻分不清

1.element方法定位到是是单数，是直接定位到元素
2.elements方法是复数，这个学过英文的都知道，定位到的是一组元素，返回的是list队列
3.可以用type()函数查看数据类型
4.打印这个返回的内容看看有什么不一样

以百度首页为例:

# coding:utf-8
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("http://www.baidu.com")

# 这里是定位的单个id
element = driver.find_element_by_id("kw")
print(type(element))
print(element)

# 这里定位是多个class
elements = driver.find_elements_by_class_name("mnav")
print(type(elements))
print(elements)

# 这里用的css语法
s = driver.find_elements("css selector", ".mnav")
# '视频'在第四个位置
print(s[3].text)
s[3].click()

# 这个写法也是可以的
# driver.find_elements("css selector", ".mnav")[3].click()

定位方法的用法

假如我们有一个Web页面，通过前端工具（如，Firebug）查看到一个元素的属性是这样的。

我们的目的是要定位input标签的输入框。

通过id定位:
dr.find_element_by_id("kw")
通过name定位:
dr.find_element_by_name("wd")
通过class name定位:
dr.find_element_by_class_name("s_ipt")
通过tag name定位:
dr.find_element_by_tag_name("input")
通过xpath定位，xpath定位有N种写法，这里列几个常用写法:
dr.find_element_by_xpath("//*[@id='kw']")
dr.find_element_by_xpath("//*[@name='wd']")
dr.find_element_by_xpath("//input[@class='s_ipt']")
dr.find_element_by_xpath("/html/body/form/span/input")
dr.find_element_by_xpath("//span[@class='soutu-btn']/input")
dr.find_element_by_xpath("//form[@id='form']/span/input")
dr.find_element_by_xpath("//input[@id='kw' and @name='wd']")
通过css定位，css定位有N种写法，这里列几个常用写法:
dr.find_element_by_css_selector("#kw")
dr.find_element_by_css_selector("[name=wd]")
dr.find_element_by_css_selector(".s_ipt")
dr.find_element_by_css_selector("html > body > form > span > input")
dr.find_element_by_css_selector("span.soutu-btn> input#kw")
dr.find_element_by_css_selector("form#form > span > input")

接下来，我们的页面上有一组文本链接。

新闻
hao123

通过link text定位:
dr.find_element_by_link_text("新闻")
dr.find_element_by_link_text("hao123")
通过link text定位:
dr.find_element_by_partial_link_text("新")
dr.find_element_by_partial_link_text("hao")
dr.find_element_by_partial_link_text("123")

关于xpaht和css的定位比较复杂，请参考：
xpath语法
css选择器

webdriver常用方法

1.控制浏览器操作的一些方法

（四）控制浏览器操作

方法	说明
get_window_size()	返回浏览器的大小
set_window_size()	设置浏览器的大小
fullscreen_window()	设置浏览器全屏
maximize_window()	设置浏览器最大化
minimize_window()	设置浏览器最小化
back()	控制浏览器后退
forward()	控制浏览器前进
refresh()	刷新当前页面

以百度首页为例:

# -*- coding: utf-8 -*-
from selenium import webdriver
from time import sleep

driver = webdriver.Chrome()
#driver.maximize_window()  #设置浏览器最大化
driver.set_window_size(800,600)  #设置浏览器800x600
driver.get("http://www.baidu.com")
driver.find_elements("css selector", ".mnav")[1].click()
sleep(3)
print(driver.title)
driver.back()   #设置浏览器最大化
sleep(3)
driver.refresh() #刷新当前页面
print(driver.title)
sleep(3)
driver.forward() #控制浏览器前进
print(driver.title)

（五）WebDriver常用方法

方法	说明
clear()	清除文本
send_keys (value)	模拟按键输入
click()	单击元素
submit()	用于提交表单(“回车”操作)
size	返回元素的尺寸
text	获取元素的文本
get_attribute(name)	获取元素属性值
is_displayed()	设置该元素是否用户可见

以百度首页为例:

from selenium import webdriver

driver = webdriver.Chrome()
driver.get("https://www.baidu.com")

driver.find_element_by_id("kw").clear()  #清除文本
driver.find_element_by_id("kw").send_keys("selenium") #模拟按键输入
driver.find_element_by_id("su").click() #单击元素

driver.quit()

from selenium import webdriver

driver = webdriver.Chrome()
driver.get("https://www.baidu.com")

search_text = driver.find_element_by_id('kw')
search_text.send_keys('selenium')
search_text.submit() #用于提交表单(“回车”操作)

driver.quit()

from selenium import webdriver

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

# 获得输入框的尺寸
size = driver.find_element_by_id('kw').size
print(size)

# 返回百度页面底部备案信息
text = driver.find_element_by_id("cp").text
print(text)

# 返回元素的属性值， 可以是 id、 name、 type 或其他任意属性
attribute = driver.find_element_by_id("kw").get_attribute('type')
print(attribute)

# 返回元素的结果是否可见， 返回结果为 True 或 False
result = driver.find_element_by_id("kw").is_displayed()
print(result)

driver.quit()

2.鼠标事件

在 WebDriver 中， 将这些关于鼠标操作的方法封装在 ActionChains 类提供。
（六）鼠标事件
鼠标事件和键盘事件

方法	说明
ActionChains(driver)	构造ActionChains对象
context_click()	执行鼠标悬停操作
move_to_element(above)	右击
double_click()	双击
drag_and_drop()	拖动
move_to_element(above)	执行鼠标悬停操作
context_click()	用于模拟鼠标右键操作， 在调用时需要指定元素定位
perform()	执行所有 ActionChains 中存储的行为，可以理解成是对整个操作的提交动作

以百度首页为例:

from selenium import webdriver
# 引入 ActionChains 类
from selenium.webdriver.common.action_chains import ActionChains

driver = webdriver.Chrome()
driver.get("https://www.baidu.cn")

# 定位到要悬停的元素
above = driver.find_element_by_link_text("设置")
# 对定位到的元素执行鼠标悬停操作
ActionChains(driver).move_to_element(above).perform()

相关解释:

from selenium.webdriver import ActionChains
导入提供鼠标操作的 ActionChains 类。

ActionChains(driver)
调用 ActionChains()类， 将浏览器驱动 driver 作为参数传入。

move_to_element(above)
context_click()方法用于模拟鼠标右键操作， 在调用时需要指定元素定位。

perform()
执行所有 ActionChains 中存储的行为， 可以理解成是对整个操作的提交动作。 

3.键盘事件

Selenium中的Key模块为我们提供了模拟键盘按键的方法，那就是send_keys()方法。它不仅可以模拟键盘输入，也可以模拟键盘的操作。

#导入Keys 模块，然后我们看看Keys 模块定义了那些按键
from selenium.webdriver.common.keys import Keys

常用的键盘操作如下：

模拟键盘按键	说明
send_keys(Keys.BACK_SPACE)	删除键（BackSpace）
send_keys(Keys.SPACE)	空格键(Space)
send_keys(Keys.TAB)	制表键(Tab)
send_keys(Keys.ESCAPE)	回退键（Esc）
send_keys(Keys.ENTER)	回车键（Enter）

组合键的使用

模拟键盘按键	说明
send_keys(Keys.CONTROL,‘a’)	全选（Ctrl+A）
send_keys(Keys.CONTROL,‘c’)	复制（Ctrl+C）
send_keys(Keys.CONTROL,‘x’)	剪切（Ctrl+X）
send_keys(Keys.CONTROL,‘v’)	粘贴（Ctrl+V）
send_keys(Keys.F1…Fn)	键盘 F1…Fn

以百度首页为例:

from selenium import webdriver
# 引入 Keys 模块
from selenium.webdriver.common.keys import Keys

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

# 输入框输入内容
driver.find_element_by_id("kw").send_keys("seleniumm")

# 删除多输入的一个 m
driver.find_element_by_id("kw").send_keys(Keys.BACK_SPACE)


# 输入空格键+“教程”
driver.find_element_by_id("kw").send_keys(Keys.SPACE)
driver.find_element_by_id("kw").send_keys("教程")

# ctrl+a 全选输入框内容
driver.find_element_by_id("kw").send_keys(Keys.CONTROL, 'a')

# ctrl+x 剪切输入框内容
driver.find_element_by_id("kw").send_keys(Keys.CONTROL, 'x')

# ctrl+v 粘贴内容到输入框
driver.find_element_by_id("kw").send_keys(Keys.CONTROL, 'v')

# 通过回车键来代替单击操作
driver.find_element_by_id("su").send_keys(Keys.ENTER)
driver.quit()

4.获取断言信息

断言的本质是验证某个功能点或脚本行为是否符合预期
python自带的assert语句，unittest框架的assert方法，甚至用try…except捕获异常来断言等。
Selenium断言中的三个模式：assert 、verify、waitfor
assert ：断言失败时，测试终止。
Verify ：断言失败时，测试会继续执行，但会将错误信息写入日志。
Waitfor 用于等待某些条件变为真。可用于 AJAX 应用程序的测试。
　　如果该条件为真，他们将立即成功执行。如果该条件不为真，则将失败并暂停测试。直到超过当前所设定的超过时间。
一般跟setTimeout时间一起使用。

四 常用断言总结
assertLocation：（判断当前是在正确的页面）
assertTitle：（检查当前页面的 title 是否正确）
assertValue：（检查 input 的值， checkbox 或 radio，有值为”on”无为”off”）
assertSelected：（检查 select 的下拉菜单中选中是否正确）
assertSelectedOptions：（检查下拉菜单中的选项的是否正确）
assertText：（检查指定元素的文本）
assertTextPresent：（检查在当前给用户显示的页面上是否有出现指定的文本）
assertTextNotPresent：（检查在当前给用户显示的页面上是否没有出现指定的文本）
assertAttribute：（检查当前指定元素的属性的值）
assertTable：（检查 table 里的某个 cell 中的值）
assertEditable：（检查指定的 input 是否可以编辑）
assertNotEditable：（检查指定的 input 是否不可以编辑）
assertAlert：（检查是否有产生带指定 message 的 alert 对话框）

verifyTitle （检查预期的页面标题）
verifyTextPresent （验证预期的文本是否在页面上的某个位置）
verifyElementPresent（验证预期的UI元素，它的HTML标签的定义，是否在当前网页上）
verifyText（核实预期的文本和相应的HTML标签是否都存在于页面上）
verifyTable（验证表的预期内容）
waitForPageToLoad（暂停执行，直到预期的新的页面加载）
waitForElementPresent （等待检验某元素的存在。为真时，则执行。)

验证和断言的区别：验证失败后不影响脚本的继续执行，断言失败后将停止脚本的执行。

不管是在做功能测试还是自动化测试，最后一步需要拿实际结果与预期进行比较。这个比较的称之为断言。通过我们获取title 、URL和text等信息进行断言。

属性	说明
title	用于获得当前页面的标题
current_url	用户获得当前页面的URL
text	获取搜索条目的文本信息

以百度首页为例:

from selenium import webdriver
from time import sleep

driver = webdriver.Chrome()
driver.get("https://www.baidu.com")

print('Before search================')

# 打印当前页面title
title = driver.title
print(title)

# 打印当前页面URL
now_url = driver.current_url
print(now_url)

driver.find_element_by_id("kw").send_keys("selenium")
driver.find_element_by_id("su").click()
sleep(1)

print('After search================')

# 再次打印当前页面title
title = driver.title
print(title)

# 打印当前页面URL
now_url = driver.current_url
print(now_url)

# 获取结果数目
user = driver.find_element_by_class_name('nums').text
print(user)

driver.quit()

5.设置元素等待

Selenium 三种等待方式解读
Selenium有3种类型的等待：

1. 强制等待 time.sleep(x) ；
2. 显式等待 WebDriverWait ；
3. 隐式等待 implicitly_wait()；
   三种等待方法的作用和区别，如下：
   （强制等待是固定时间,隐式等待就是针对页面的，显式等待是针对元素的）

强制等待，也就是常说的死等待，使用time模块提供的sleep方法，脚本在等待sleep（x）
x秒后才执行，此时脚本也许出现了无效等待，即元素已经出现，可以继续操作，但因指定的时间未到，脚本无法执行，因而，在实际WebUI开发中应杜绝sleep等待；

显式等待，WebDriver提供的针对元素级别的、灵活、智能的等待方法，通过配合until()、until_not()、ExpectedCondition等条件的使用，默认每500ms检查一次条件状态，可以及时将脚本从等待中唤醒，避免无效等待，在实际应用中推荐使用该方法。
显示等待要用到WebDriverWait

>from selenium.webdriver.support.wait import WebDriverWait

该等待的调用方法如下：

>WebDriverWait(driver, timeout, poll_frequency=0.5,ignored_exceptions=None) 

主要有4个参数：
driver：浏览器驱动 
timeout：等待时间
poll_frequency：检测的间隔时间，默认0.5s
ignored_exceptions：超时后的异常信息，默认抛出NoSuchElementException

这个模块中，一共只有两种方法until与until_not

method: 在等待期间，每隔一段时间调用这个传入的方法，直到返回值不是False message:
如果超时，抛出TimeoutException，将message传入异常 
until
当某元素出现或什么条件成立则继续执行
until_not
当某元素消失或什么条件不成立则继续执行
两个方法的method，必须是含有____call____的可执行方法。所以我们引用selenium提供的一个模块

from selenium.webdriver.support import expected_conditions as Ec

隐式等待，WebDriver提供的针对driver级别的适用整个生命周期的等待方法，该等待是全局设置，因而只需在实例化driver后设置一次即可。从等待作用上看，是可以满足需要的，但是考虑到实际应用场景，driver要等待的元素和脚本要操作的元素未必相同，也就是说，脚本要操作的元素已经出现，但因为设置了全局等待，driver也会继续等待页面上其他无关元素，直至整个页面加载完毕。因而，与显式等待相比，可能出现无效等待的情况。

以百度首页为例:

import time
from selenium import webdriver
from selenium.webdriver.support.wait import WebDriverWait
# 启动浏览器
driver = webdriver.Chrome()
driver.get(r'https://www.baidu.com/')
starttime = time.time()
driver.find_elements("css selector", ".mnav")[3].click()
# time.sleep(3)            #强制等待
driver.implicitly_wait(3)  #隐式等待
#显式等待
text=WebDriverWait(driver,3,0.5).until(lambda x:x.find_element_by_link_text("美食")).text
print(text)
print(driver.title)
endtime = time.time()
dtime = endtime - starttime
print("程序运行时间：%.8s s" % dtime)  #显示到微秒

print(driver.title)
driver.back()
print(driver.title)
driver.quit()

6.定位一组元素

WebDriver还提供了8种用于定位一组元素的方法。

find_elements_by_id()
find_elements_by_name()
find_elements_by_class_name()
find_elements_by_tag_name()
find_elements_by_link_text()
find_elements_by_partial_link_text()
find_elements_by_xpath()
find_elements_by_css_selector()

定位一组元素的方法与定位单个元素的方法类似，唯一的区别是在单词element后面多了一个s表示复数。

以百度搜索为例:

from selenium import webdriver
from time import sleep

driver = webdriver.Chrome()
driver.get("https://www.baidu.com")

driver.find_element_by_id("kw").send_keys("selenium")
driver.find_element_by_id("su").click()
sleep(1)

# 定位一组元素
texts = driver.find_elements_by_xpath('//div/h3/a')

# 循环遍历出每一条搜索结果的标题
for t in texts:
    print(t.text)

driver.quit()

7.多表单切换

在Web应用中经常会遇到frame/iframe表单嵌套页面的应用，WebDriver只能在一个页面上对元素识别与定位，对于frame/iframe表单内嵌页面上的元素无法直接定位。这时就需要通过switch_to.frame()方法将当前定位的主体切换为frame/iframe表单的内嵌页面中。

方法	说明
switch_to.frame()	将当前定位的主体切换为frame/iframe表单的内嵌页面中
switch_to.default_content()	跳回最外层的页面

  
    ...