|
一、WebDriver 浏览器的属性
WebDriver 提供了很多属性来支持对浏览器的操作，例如，获取测试地址、多窗口的处理、获取浏览器的名称等。
1、获取测试的地址
方法：current_url
| 1 2 3 4 5 6 7 8 | from?selenium?import?webdriver
driver?=?webdriver.Firefox()
driver.maximize_window()
driver.get('http://www.baidu.com/')
driver.implicitly_wait(30)
print('测试地址为：{0}'.format(driver.current_url))
driver.quit()
|
2、获取当前页面代码
方法：page_source
| 1 | print('页面代码如下：{0}'.format(driver.page_source))
|
3、获取当前 Title
方法：title
| 1 | print('当前的Title为：{0}'.format(driver.title))
|
4、页面的前进和后退
方法：前进用到的方法是 forward，后退用到的方法是 back
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | from?selenium?import?webdriver
import?time as t
driver?=?webdriver.Firefox()
driver.maximize_window()
driver.get('http://www.baidu.com/')
t.sleep(2)
driver.get('http://www.bing.com')
t.sleep(2)
#返回到百度
driver.back()
print('当前URL为：{0}'.format(driver.current_url))
t.sleep(2)
#前进到bing
driver.forward()
print('当前URL为：{0}'.format(driver.current_url))
driver.quit()
|
5、关闭程序
在 selenium 中，quit 方法用来退出驱动程序（Driver）并关闭执行的浏览器；而 close 方法用来关闭执行的浏览器，所以关闭程序建议使用 quit 方法。
6、加载测试地址
在 UI 自动化测试中，打开测试地址用到的方法是 get 方法，它的参数是要打开的测试页面的地址。
| 1 | driver.get('http://mail.sina.com.cn/')
|
7、多窗口实践
窗口处理的方法，current_window_handle 用来获取当前浏览器的窗口句柄，window_handles 用来获取浏览器的所有窗口句柄。如下，实现在新浪登录页面点击注册，在注册页面邮箱地址输入框中输入邮箱地址，再次跳转到登录页面。
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | from?selenium?import?webdriver
import?time
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.get('http://mail.sina.com.cn/')
#获取当前窗口句柄
now_handle?=?driver.current_window_handle
time.sleep(1)
#点击注册链接
driver.find_element_by_link_text('注册').click()
time.sleep(1)
#获取所有窗口句柄
handles??=?driver.window_handles
#对所有窗口句柄循环处理
for?handle?in?handles:
????if?handle !=?now_handle:
????????#窗口变化之后需要定位当前窗口
????????driver.switch_to.window(handle)
????????time.sleep(2)
????????driver.find_element_by_name('email').send_keys('bing')
????????time.sleep(2)
????????#关闭注册页面
????????driver.close()
driver.switch_to.window(now_handle)
time.sleep(2)
#在账号输入框输入邮箱
driver.find_element_by_id('freename').send_keys('bing')
time.sleep(2)
driver.quit()
|
8、浏览器最大化
方法：maximize_window，一般打开浏览器时，界面并不是最大化的，这对 UI 自动化测试的影响比较大，所以建议使用此方法让浏览器最大化。
| 1 | driver.maximize_window()
|
9、刷新
方法：refresh ，有些场景要用到页面刷新后查看效果。
10、获取执行的浏览器
方法：name
| 1 | print('测试执行的浏览器为：{0}'.format(driver.name))
|
二、WebElement 类的方法
1、清除
方法：clear
| 1 2 3 4 5 6 | em?=?driver.find_element_by_name('email')
#输入关键字
em.send_keys('selenium')
time.sleep(2)
#清除关键字
em.clear()
|
2、获取元素属性值
方法：get_attribute，在测试中，经常需要获取输入框中的值，或者获取输入框中的提示信息。
如，“请输入用户名”的元素属性是 place，获取提示信息。
| 1 2 | name?=?driver.find_element_by_name('username')
print('用户名输入框中提示信息为：{0}'.format(name.get_attribute('place')))
|
在输入框中输入的值一般都在 value 属性中，如在百度搜索输入框中输入的搜索关键存放在百度搜索 input 的 value 属性中。
| 1 2 3 | sr?=?driver.find_element_by_id('kw')
sr.send_keys('selenium')
print('填写的关键字为：{0}'.format(sr.get_attribute('place')))
|
3、检查元素是否可见
方法：is_displayed，用于测试该属性对用户是否可见，返回结果为布尔类型（True、False）。
| 1 2 | about?=?driver.find_element_by_partial_link_text('关于百度')
print('关于百度是否可见：{0}'.format(about.is_displayed()))
|
4、检查元素是否可编辑
方法：is_enabled，用于测试文本是否可编辑，返回结果是布尔类型。
| 1 2 | sr?=?driver.find_element_by_id('kw')
print('搜索输入框是否可编辑：{0}'.format(sr.is_enabled()))
|
5、检查是否已选中
方法：is_selected，主要针对单选按钮或复选按钮，判断它们是否选中，返回结果是布尔类型。
| 1 2 | zd?=?driver.find_element_by_id('st1')
print('自动登录是否默认选中：{0}'.format(zd.is_selected()))
|
6、提交表单
方法：submit，在 form 表单中，点击“提交”按钮，跳转到另一个页面。click 只是单纯的点击；submit 一般是有 form 表中，只是用在有 form 表单的提交。
form 表单的 HTML 代码中有：
| 1 2 3 4 5 6 7 8 | <form?action="index.html" method="get">
????<p>
????????昵称：<input?type="text" name="username">
????</p>
????<p>
????????<input?type="submit" name="form" value="提交">
????</P>
</form>
|
点击“提交”按钮跳转到 index.html 页面，实现交互的主要代码：
| 1 2 | driver.find_element_by_name('username').send_keys('user0')
driver.find_element_by_name('form').submit()
|
?三、下拉框实战
1、Select 类的详解
针对自动化中的下拉框，selenium 中提供了 select 类来处理，在 select 模块中导入方式是：from selenium.webdriver.support.select import Select 。
2、定位思路
在百度搜索设置中设置期望的搜索结果显示的条数为例，这部分的HTML 代码如下：
| 1 2 3 4 5 6 7 8 | <td?id="se-setting-3">
????<select?name="NR" id="nr">
????????<option?value="10" selected="">每页显示10条</option>
????????<option?value="20">每页显示20条</option>
????????<option?value="50">每页显示50条</option>
????</select>
????百度的原始设定10条最有效且快速
</td>
|
实现步骤：
1）首先定位到 Select 下拉框的元素属性，具体代码：nr = driver.find_element_by_name('NR')；
2）实例化 Select 类，参数为 nr，具体代码：select = Select(nr)；
3）Select 实例化后的对象 select 可以调用 Select 类的任何一个方法。
3、在 Select 类中的各种定位实践
方法1：select_by_index，参数是索引值，如实现每页显示 50 条，索引是 2；
方法2：select_by_value，本例子中的 value 值是 10、20、50；
方法3：select_by_visible_text，文本信息就显而易见了吧，注意空格等，最好复制文本信息保持一致，具体代码如下。
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | from?selenium?import?webdriver
from?selenium.webdriver.support.select?import?Select
from?selenium.webdriver.common.action_chains?import?ActionChains as AC
import?time as t
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('http://www.baidu.com')
#实现鼠标悬浮在百度首页的设置
#这里为a 的第8个元素
element?=?driver.find_element_by_css_selector('a.pf:nth-child(8)')
t.sleep(3)
AC(driver).move_to_element(element).perform()
t.sleep(3)
#点击设置中的搜索设置按钮
driver.find_element_by_link_text('搜索设置').click()
#driver.find_element_by_css_selector('.setpref').click()#没有成功
t.sleep(2)
#定位到下拉框元素属性
nr?=?driver.find_element_by_name('NR')
#实例化 Select 类
select?=?Select(nr)
select.select_by_index(2) # 索引定位
# select.select_by_value('50') # value 定位
# select.select_by_visible_text('每页显示20条') # 文本定位
print('下拉框选择的最新条数是：',nr.get_attribute('value'))
t.sleep(2)
driver.quit()
|
四、弹出框实践
1、Alert 类的详解
在HTML 的 Javascript 交互中主要有 Alert 警告框、Confirm 确认框、Prompt 消息对话框。
在 Selenium 中对于弹出框的处理方法可以使用 alert 模块中的 Alert 类，在 Alert 类中，方法 text 用来获取 Alert 弹出框的文本信息。accept 和 dismiss 方法主要应用在 Confirm 弹出确认框中，accept 用来接受确认框，dismiss 用来拒绝确认框。send_keys 主要应用在 Prompt 消息对话框中，在输入框中输入要输入的值。在 Selenium 中是通过 switch_to_alert 方法调用 Alert 类中的方法，而?switch_to_alert 方法是属于 WebDriver 类的方法。
2、警告框的处理
如在百度搜索设置中，设置后点击“保存设置”按钮，弹出 alert 对话框，点击“确认”按钮。
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | from?selenium?import?webdriver
from?selenium.webdriver.support.select?import?Select
from?selenium.webdriver.common.action_chains?import?ActionChains as AC
import?time as t
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('http://www.baidu.com')
#实现鼠标悬浮在百度首页的设置
element?=?driver.find_element_by_css_selector('a.pf:nth-child(8)')
t.sleep(3)
AC(driver).move_to_element(element).perform()
t.sleep(3)
#点击设置中的搜索设置按钮
driver.find_element_by_link_text('搜索设置').click()
#driver.find_element_by_css_selector('.setpref').click()#没有成功
t.sleep(2)
#点击搜索设置按钮
driver.find_element_by_css_selector('#gxszButton > a.prefpanelgo').click()
t.sleep(2)
#获取弹出框的文本信息
print('alert 弹出文本信息为：{0}'.format(driver.switch_to.alert.text))
#点击弹出框确认
driver.switch_to.alert.accept()
|
运行代码后，会打印出 Alert 的文本信息。
3、确认框的处理
Confirm 是弹出确认的对话框，可以选择“确认”或“取消”按钮，确认的方法是 accept；取消的方法是 dismiss。
| 1 2 | driver.switch_to.alert.accept()??#确认
driver.switch_to.alert.dismiss()?#取消
|
4、消息对话框的处理
Prompt 消息对话框，在 JavaScript 中用于询问一些需要与用户交互的信息，方法：send_keys。
| 1 2 | #在弹出输入框中输入
driver.switch_to.alert.send_keys('python 学习')
|
?五、WebDriverWait 类实战
在 UI 自动化测试中，首先要保障测试脚本的稳定运行。在实际的测试场景里，由于网络的因素导致需要测试的页面打不开或者打开延迟，从而导致页面元素找不到等各种错误的出现。
等待方式主要存在以下三种方式：
1）固定等待。如调用 time 模块中的 sleep 方法，固定等待几秒。
2）隐式等待。用到的方法是?implicitly_wait，隐式等待指设置最长的等待时间。
3）显示等待。主要是指程序会每隔一段时间执行自定义的程序判断条件，如果判断条件成功，程序就会继续执行；如果判断条件失败，程序就会报 TimeOutEcpection 的异常信息。
time.sleep(3) 增加了固定等待 3 秒时间，如果每个步骤都增加固定等待时间，那么一个测试用例执行下来等待时间将会增加十几秒，大大地延长了测试用例的执行的时间。因此，在 Selenium 中提供了 WebDriverWait 类，专门解决网络延迟等待等问题。
1、WebDriverWait 类详解
WebDriverWait 类放置在 wait 模块在，使用该类时，需要先导入并且对它进行实例化，导入的代码如下：
| 1 | from?selenium.webdriver.support.ui?import?WebDriverWait
|
WebDriverWait 类的参数分别是 driver 和 timeout 。driver 指的是 webdriver 实例化后的对象，timeout 指的是具体的等待时间。WebDriverWait 类的 until 方法中，参数 method 指的是需要调用的方法，调用方法来自 expected_conditions 模块中的类，也就是说?WebDriverWait 会与?expected_conditions 模块结合起来应用。
调用 expected_conditions 模块中的类后，一般返回两种形式的对象实例：一种是布尔型，返回 True 程序会继续执行，否则程序会报?TimeOutEcpection 的异常信息；另一种是返回某个具体实例对象，使用该对象就可以直接调用该类中的方法。
2、元素可以见并且可操作
element_to_be_clickable 判断某元素可见后执行输入、点击等操作。判断满足条件后返回的是 WebElement 类的实例对象，这样就可以调用?WebElement 类中的 send_keys 等方法。如下，实现点击百度首页的“百度一下”按钮，首先加载搜索的输入框，然后在输入框输入关键字，否则就返回错误的信息：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | from?selenium?import?webdriver
from?selenium.webdriver.support.ui?import?WebDriverWait
from?selenium.webdriver.support?import?expected_conditions
from?selenium.webdriver.common.by?import?By
import?time as t
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('http://www.baidu.com')
driver.implicitly_wait(30)
'''
WebDriverWait直接调用静态方法until，并且显示等待10s，
在until的方法中又调用了expected_conditions，
模块中的element_to_be_clickable类，
在element_to_be_clickable类中需要指定按ID或者其他元素属性来指定元素属性。
'''
so?=?WebDriverWait(driver,10).until(expected_conditions.element_to_be_clickable((By.ID,'kw')))
so.send_keys('Selenium')
t.sleep(3)
driver.quit()
|
如果对以上代码中，故意写错元素属性，把 kw 写成 kww，执行后，则会有?TimeOutEcpection 的错误提示。
3、指定元素的文本位置
text_to_be_present_in_element 指定元素文本的位置，一般用于验证一个文本信息或者错误的提示信息，返回的是布尔型，可以打印出来看结果。
| 1 2 3 4 | disText?=?WebDriverWait(driver,10).until(expected_conditions.
??????????text_to_be_present_in_element((By.
??????????XPATH,'输入具体的xpath'),'需要验证的文本信息'))
print('结果是：{0}'.format(disText))
|
4、判断元素是否可见
visibility_of_element_located 方法的作用是等元素可见后再执行操作。如下，百度首页的“关于百度”的链接：
| 1 2 | WebDriverWait(driver,10).until(expected_conditions.
????visibility_of_element_located(By.LINK_TEXT,'关于百度'))
|
?六、ActionChains 类实践
在功能自动化测试中，经常会用到鼠标事件。在 Selenium 中，主要在 action_chains 模块的?ActionChains 类中，导入方式为：
| 1 | from?selenium.webdriver.common.action_chains?import?ActionChains
|
1、ActionChains 类详解
在 ActionChains 类中提供了常用的鼠标操作方法，首先要对?ActionChains 类进行实例化，该类的构造函数参数为 driver，也就是 WebDriver 实例化后的对象，实例化后就可以调用它里面的方法了：
| 1 2 3 4 5 6 7 8 9 10 11 12 | from?selenium?import?webdriver
from?selenium.webdriver.common.action_chains?import?ActionChains as AC
import?time as t
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('http://www.baidu.com')
#对 AC 类进行实例化
actionChains?=?AC(driver)
#actionChains.?? #这里就会显示该类的方法了
driver.quit()
|
2、鼠标悬浮操作
move_to_element 方法用来使鼠标悬浮到某一元素上，以百度首页的搜索设置为例：
| 1 2 3 4 5 6 7 8 9 | #对 AC 类进行实例化
actionChains?=?AC(driver)
#实现鼠标悬浮在百度首页的设置
element?=?driver.find_element_by_css_selector('a.pf:nth-child(8)')
t.sleep(3)
#鼠标悬浮到“设置”
actionChains.move_to_element(element).perform()
#点击设置中的搜索设置按钮
driver.find_element_by_link_text('搜索设置').click()
|
3、鼠标右键操作
? context_click 是触发鼠标右键操作的方法。
| 1 2 3 4 5 | #对 AC 类进行实例化
actionChains?=?AC(driver)
kw?=?driver.find_element_by_id('kw')
#鼠标在百度输入框右键操作
actionChains.context_click(kw)
|
4、鼠标双击操作
double_click 是触发鼠标双击的操作方法，一般使用在有数据交互的地方。比如，有这样一个业务，点击按钮会向数据库插入一条数据，而且只能插入一条数据，如果前端没有对双击进行处理的话，双击按钮后就会向数据库插入两条数据。
| 1 2 3 | su?=?driver.find_element_by_id('su')
#对“百度一下”按钮双击操作
actionChains.double_click(su)
|
七、键盘事件实践
Selenium 中提供了keys 模块中的 Keys 类来处理键盘事件的操作，如下：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | from?selenium?import?webdriver
import?time as t
from?selenium.webdriver.common.keys?import?Keys
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('http://www.baidu.com')
so?=?driver.find_element_by_id('kw')
so.send_keys('python')
t.sleep(3)
'''
使用键盘事件，把复制的关键字粘贴到bing搜索输入框中
'''
#选中输入框的搜索关键字
so.send_keys(Keys.CONTROL,'a')
#复制搜索的关键字
so.send_keys(Keys.CONTROL,'c')
t.sleep(3)
#按下Backspace删除输入的关键字
so.send_keys(Keys.BACKSPACE)
t.sleep(3)
driver.get('http://www.bing.com')
bingso?=?driver.find_element_by_id('sb_form_q')
#复制搜索关键字到bing搜索输入框中
bingso.send_keys(Keys.CONTROL,'v')
t.sleep(3)
driver.quit()
|
八、获取截图
在自动化测试中，在测试执行期间有时需要获取截图信息，一方面可以定位错误的脚本，方便调试脚本，另一方面也可以以此为据，便于开发人员有效的交流。
1、获取当前截图
方法：save_screenshot
| 1 | driver.save_screenshot('tupian.png')?# 在当前目录下生成 tupian.png 的图片
|
2、保存当前屏幕快照
方法：get_screenshot_as_file，可以填写完整的文件路径。
| 1 | driver.get_screenshot_as_file('D:/tupian.png')
|
3、获取图片二进制数据
方法：get_screenshot_as_png，该方法测试场景中使用较少。
| 1 | print(driver.get_screenshot_as_png())
|
?九、JavaScript 的处理
在浏览器的滑动到底部或者顶部，对时间控件以及富文本等处理中，需要 JavaScript 的脚本配合，在 Selenium 中对 JavaScript 脚本调用的方法是 execute_script。
1、浏览器的滑动操作
如在百度搜索中，实现滑动到浏览器的底部或者顶部：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 | from?selenium?import?webdriver
import?time as t
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('http://www.baidu.com')
driver.implicitly_wait(30)
driver.find_element_by_id('kw').send_keys('selenium')
driver.find_element_by_id('su').click()
#浏览器活动到底部 js 代码
down?=?"var q=document.documentElement.scrollTop=10000"
t.sleep(3)
#操作 js 实现鼠标滑动到浏览器底部
driver.execute_script(down)
t.sleep(3)
#点击下一页
driver.find_element_by_link_text('下一页>').click()
t.sleep(3)
#浏览器活动到顶部 js 代码
up?=?"var q=document.documentElement.scrollTop=0"
#先滑到底部
driver.execute_script(down)
t.sleep(3)
#操作 js 实现鼠标滑动到浏览器顶部
driver.execute_script(up)
t.sleep(3)
driver.quit()
|
2、富文本的处理
在 Web 产品中，有时需要对富文本中写入内容。富文本一般都在 iframe 框架中，可以通过 iframe 的 ID 或者索引的方式进入 iframe 中，再通过 JavaScript 的方式在富文本中输入需要的内容。如 iframe 的 ID 为 ueditor_0，在富文本中写入内容，可以单独写个可调用函数，并进入相应的位置后调用：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | from?selenium?import?webdriver
import?time as t
def?richText(txt):
????'''往富文本中写入内容'''
????js?=?"document.getElementById('ueditor_0').contentwindow."\
????????"document.body.innerHTML='{0}'".format(txt)
????driver.execute_script(js)
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('富文本 URL 地址')
richText('一起来学 Python 吧！')
t.sleep(3)
driver.quit()
|
3、时间控件的处理
时间控件经常出现在查询中，需要按某一时间段查询出数据并且来验证查询功能是否正确。大多数时间控件是只读属性的，在自动化测试中，处理只读属性的时间控件中输入时间。用 js 把禁止输入的 readonly 属性去掉，把它当成一个普通的 input 框处理。
取消时间控件的只读属性，有四种方法：参考方法
| 1 2 3 4 5 6 7 8 9 10 | # 1.原生js，移除属性
# js = "document.getElementById('txtBeginDate').removeAttribute('readonly')"
# 2.jQuery，移除属性
# js = "$('input[id=txtBeginDate]').removeAttr('readonly')"
# 3.jQuery，设置为false
# js = "$('input[id=txtBeginDate]').attr('readonly',false)"
# 4.jQuery，设置为空（同3）
js?=?"$('input[id=txtBeginDate]').attr('readonly','')"
driver.execute_script(js)
|
步骤：首先取消时间控件的只读属性；然后在 input 输入框中给 value 赋值，填写需要输入的时间。
如在 input 中 value placeholder=“开始时间≥当前时间”，编写开始和结束时间的可调用函数：
| 1 2 3 4 5 6 7 8 9 | def?startJs(startTime):
????'''开始时间中输入自定义的时间，前一段是取消只读属性，后一段是输入开始时间'''
????js?=?"$(\"input[placeholder='开始时间≥当前时间']\").removeAttr('readonly');$(\"input[placeholder='开始时间≥当前时间']\").attr('value','{0}')".format(startTime)
????driver.execute_script(js)
def?endJs(endTime):
????'''结束时间中输入自定义的时间，前一段是取消只读属性，后一段是输入结束时间'''
????js?=?"$(\"input[placeholder='结束时间>开始时间']\").removeAttr('readonly');$(\"input[placeholder='结束时间>开始时间']\").attr('value','{0}')".format(endTime)
????driver.execute_script(js)
|
时间控件中实现自定义输入代码：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | from?selenium?import?webdriver
import?time as t
def?startJs(startTime):
????'''开始时间中输入自定义的时间，
????前一段是取消只读属性，后一段是输入开始时间'''
????js?=?"$(\"input[placeholder='开始时间≥当前时间']\")."?\
?????????"removeAttr('readonly');"?\
?????????"$(\"input[placeholder='开始时间≥当前时间']\")."?\
?????????"attr('value','{0}')".format(startTime)
????driver.execute_script(js)
def?endJs(endTime):
????'''结束时间中输入自定义的时间，
????前一段是取消只读属性，后一段是输入结束时间'''
????js?=?"$(\"input[placeholder='结束时间>开始时间']\")."?\
?????????"removeAttr('readonly');"?\
?????????"$(\"input[placeholder='结束时间>开始时间']\")."?\
?????????"attr('value','{0}')".format(endTime)
????driver.execute_script(js)
driver?=?webdriver.Chrome()
driver.maximize_window()
driver.implicitly_wait(30)
driver.get('时间控件的 URL 地址')
startJs('2019-01-01 09:00:00')
t.sleep(3)
endJs('2019-12-12 23:59:59')
t.sleep(3)
driver.quit()
|
|