selenium测试框架快速搭建（UI自动化测试）

一、介绍

        selenium目前主流的web自动化测试框架；支持多种编程语言Java、pythan、go、js等；selenium 提供一系列的api 供我们使用，因此在web测试时我们要点页面中的某一个按钮，那么我们只需要获取页面，然后根据id或者name找到对应的按钮，然后执行click操作就可以完成点击这一个动作。测试点点点虽然容易复现，但做回归测试的时候会出现大量重复的工作，因此可以通过自动化，每次做回归测试我们只需要运行相关的脚本即可。Selenium2:使用Selenium自动化测试框架，主要用到Selenium Webdriver模块，能模拟提供浏览器、页面元素定位、元素操作、鼠标键盘等相关的操作和方法； 

        ui自动化测试主要应用在回归测试、兼容性测试、冒烟测试等测试场景；适合的是需求稳定、项目周期长、测试脚本可以复用的项目。
 

二、selenium安装及配置

        浏览器：谷歌chrome（推荐）、火狐、IE等
        驱动：chromedriver.exe（谷歌） 地址：ChromeDriver - WebDriver for Chrome - Downloads
        安装selenium包：pip install selenium -U   ，-U 表示已安装则更新
 

        下载对应浏览器版本 的chromedriver.exe，否则有可能会报找不到驱动的错；把驱动包放到python的根目录下

        WebDriver原理图：WebDriver是一个基于HTTP的协议，它提供了一系列的接口用于发现和控制 Web 文档中的 DOM 元素，几乎可以操作浏览器做任何事情。总的来说就是python编写代码，通过webdriver控制浏览器。

 三、脚本实例

from selenium import webdriver
import time
 
#打开浏览器
driver = webdriver.Chrome()
#浏览器最大化
driver.maximize_window()
# 打开baidu
driver.get("http://www.baidu.com")
#打印浏览器地址
print(driver.current_url)
#打印网页标题
print(driver.title)
#暂停一会,3 秒
time.sleep(3)
#关闭当前窗口
driver.close()
#关闭整个浏览器，并且关闭驱动chromedriver
driver.quit()

 

     Unittest：Python的单元测试框架模块，在此框架下编写具体的业务测试用例脚本，另外此框架能组织测试用例集的执行和测试场景恢复

        标准库 time 模块主要提供对时间的相关操作， os.path 模块主要提供对文件路径相关的操作，logging模块主要提供对日志相关的设置 ，smtplib 模块主要负责发送邮件等

       第三方模块库：HTMLTestRunner 模块主要用于生成HTML格式的可视化测试报告，xlrd模块是读取excel文件数据的模块，xlwt模块是向excel文件中写入数据的模块

四、元素定位

在测试时，浏览器 点击F12打开控制台， 即可以看到页面的所有按钮、输入框等id属性；激活元素选择器；点击对应的按钮、输入框，就可以在控制台看到对应信息；根据id属性定位元素；调用driver提供给的方法定位。

        id定位：driver.find_element_by_id('id')

#打开百度，输入软件测试，点击百度一下
driver.find_element_by_id('kw').send_keys('软件测试')
driver.find_element_by_id('su').click()

   name定位：el = driver.find_element_by_name('name')

#输入selenium 自动化，点击百度一下
driver.find_element_by_name('wd').send_keys('selenium自动化')
#百度一下按钮没提供名字
driver.find_element_by_id('su').click()

     class定位：el = driver.find_element_by_class_name('bt_class')

         tagName定位：el = driver.find_element_by_tag_name(tagName)

        xpath定位（绝对路径定位）：el = driver.find_element_by_xpath(xpath)

        css定位：el = driver.find_element_by_css_selector(css)

        link_text 定位（根据它的超链接定位）：el = driver.find_element_by_link_text(linkText)

        partial_link_text定位（）：el = driver.find_element_by_partial_link_text(linkPartText)

        获取当前 页面的url：driver.current_url

        获取元素的文本值：driver.find_element_by_id("iptUsername").text

        浏览器窗口最大化：driver.maximize_window()

        查看浏览器名字：driver.name

        打开网页：driver.get("www.baidu.com")

        打开浏览器：driver = webdriver.Chrome()

        关闭窗口：driver.close()
    

五、元素操作

   元素赋值： el = driver.find_element_by_id("iptUsername").send_keys('admin')

        清空元素值  el.clear() 
        获取元素文本： el.text
        获取元素指定属性的值： get_attribute(obj)

        上传文件：找到 type=file 的按钮，点击按钮，然后把按钮的文字改为图片名；
        driver.find_element_by_css_selector('[type="file"]').click（）；
        driver.find_element_by_css_selector('[type="file"]').send_keys('helloword.jpg')；

六、执行JavaScript操作

   当webdriver 遇到无法完成的操作时，可以使用javascript来完成，webdriver提供了execute_script()接口来调用js代码。 方法：execute_script(script, *args)；执行 JavaScript代码是一个非常强大的功能，可以实现WebElement 接口所有功能，甚至更多的功能。比如在web性能测试中可以调用Web API接口window.performance来测试Web性能。

#打开百度页面，把百度一下 改成 test 
driver.get("http://www.baidu.com")
driver.execute_script('document.getElementById("su").value = "test"')

七、窗口切换

        浏览器窗口切换：
        例如浏览器打开多个窗口，需要从一个窗口跳转到另一个窗口做自动化测试。要转到另一个页面才能找到元素。原理是：每个打开的窗口都有唯一的标识，叫做句柄；可以通过不同的句柄实现窗口切换。

# 当前窗口url地址：
print(driver.current_url)
 
#暂停一会,10 秒
time.sleep(10)
 
# 打印所有窗口句柄
windows = driver.window_handles
print(windows,'\n')
 
 
#切换到最后的窗口
driver.switch_to.window(windows[-1])
#打印url，核对下是不是最后的窗口；或者根据网页名等校验
print(driver.current_url)
 
print('\n\n')
time.sleep(3)
 
#切换到第二个窗口
#先获取现在的窗口
current_window = driver.current_window_handle
 
# 获取第二个窗口的索引(由当前窗口索引+1)
next_window_index = windows.index(current_window) + 1
 
# 切换到第二个窗口
driver.switch_to.window(windows[next_window_index])
print(driver.current_url)

       iframe切换：

        如果元素包含在iframe中，也会导致无法找到元素！例如代码：也会找不到id为kw的input输入框；使用 driver.find_element_by_id('kw') 跑出无法找到的异常。

      selenium提供了switch_to.frame()方法用于实现frame的切换，此方法接收id、name、index以及selenium的WebElement对象用来实现切换，比如上述的代码中，要切换到iframe中，则可以使用以下代码实现：

from selenium import webdriver
 
driver = webdriver.Chrome()
# 通过id切换iframe
driver.switch_to.frame('myframe')  
# 通过name切换iframe
# driver.switch_to.frame('myframe')  
# 通过index切换iframe，0代表第一个
# driver.switch_to.frame(0)   
# 通过WebElement对象切换iframe
# driver.switch_to.frame(driver.find_element_by_tag_name("iframe"))  

   当操作完frame中的元素后，经常需要重新切换到主界面进行其他操作，切换回主页面使用方法如下：

driver.switch_to.default_content()

  若是frame里嵌套frame，这需要一层层切换下去。有多层frame，需要回到上一级的；用父frame：

driver.switch_to.parent_frame()

   alert弹窗切换：

        alert窗口是js提示框，不属于web界面，

#切换到alert窗口 ;获取alert 窗口
alert= driver.switch_to_alert
#获取alert的文本内容
print(alert.text)
#点击确定，关闭弹框
alert.accept()
#点击取消，关闭弹簧
alert.dismiss()

八、鼠标经过操作

        selenium鼠标事件(单击/双击/右击/拖动)详细解说，selenium鼠标事件用的是ActionChains。需要import相关模块。

from selenium.webdriver.common.action_chains import ActionChains

    如找到百度一下按钮，移到该位置；

from selenium.webdriver.common.action_chains import ActionChains
from selenium import webdriver
 
chr_driver = webdriver.Chrome()
chr_driver.maximize_window()
chr_driver.get("https://www.baidu.com/")
 
ele = chr_driver.find_element_by_id('su')
# 实例化,悬浮、点击，可以连续调用多个方法，是因为返回的都是self对象
ActionChains(chr_driver).move_to_element(ele).pause(0.5).click(ele).perform()

  ActionChains的常用方法：

#单击鼠标左键
click(on_element=None) 
#点击鼠标左键，不松开
click_and_hold(on_element=None)
#点击鼠标右键 
context_click(on_element=None) 
#双击鼠标左键
double_click(on_element=None) 
#拖拽到某个元素然后松开
drag_and_drop(source, target) 
#拖拽到某个坐标然后松开
drag_and_drop_by_offset(source, xoffset, yoffset) 
#按下某个键盘上的键
key_down(value, element=None) 
#松开某个键
key_up(value, element=None) 
#鼠标移动到某个元素，悬浮
move_to_element(to_element) 
#执行链中的所有动作
perform() 

九、拖拽

        如：打开百度地图拖拽、验证码验证的拖拽动作

from selenium.webdriver.common.action_chains import ActionChains
 
#打开浏览器
driver = webdriver.Chrome()
#浏览器最大化
driver.maximize_window()
#打开百度地图
driver.get('https://map.baidu.com/@12697919.69,2560977.31,12z')
 
#定位地图
mask = driver.find_element_by_id('mask')
 
#动作
ac = ActionChains(driver)
ac.move_to_element(mask).click_and_hold().move_by_offset(50,50).release().perform()

十、页面等待

        强制等待 ：time.sleep()
        隐式等待：driver.implicitly_wait(t)   ，隐式等待在指定的时间 t 内等待页面加载完成，如果加载完成的时间小于 t ，剩余的时间就不再等；如果时间 t 内未加载完成则报错。作用范围：全局

        显式等待：WebDriverWait(driver , timeout , poll_frequency).until(element)
        导入：from selenium.webdriver.support.ui import WebDriverWait 
        显式等待可以看做是特殊的隐式等待，在指定的时间 t 内等待指定元素加载完成，如果加载完成时间小于 t ，剩余的时间就不再等待，如果没能在 t 时间内加载完成则报错。
        方法：WebDriverWait(driver , timeout , poll_frequency)
        driver：表示浏览器对象，timeout：表示超时时间，poll_frequency：扫描间隔时间一般0.5秒，扫描一次页面。
        element： 指定加载的元素
 

十一、截图

        driver.save_screeshot(file) ：file ，图片在本地保存的路径及名字；
                如： driver.save_screeshot('./首页.jpg')
        driver.get_screenshot_as_file(file)  
         使用场景：通常是断言失败，有错误的时候保存截图，方便还原现场。
 

十二、调用js代码

        excute_script(js)
        如：为只读元素设定值；设定日期；      

js = 'document.getElementById("date").value = 2022-05-27'
driver.execute_script(js)

十三、警告框处理

        警告框的三种类型：
                alert：只有确定按钮；
                confirm：有确定和取消按钮
                prompt：可以输入内容；
        方法：
                swtch_to.alert.text：获取警告框中的文本信息
                swtch_to.alert.accept()：在警告框中点击确定
                swtch_to.alert.dismiss()：在警告框中点击取消
                swtch_to.alert.send_keys(value)：在警告框中输入内容

#打印警告框中的文本信息
print(swtch_to.alert.text)
#在警告框中点击确定
driver.swtch_to.alert.accept()
#在警告框中点击取消
driver.swtch_to.alert.dismiss()
#在警告框中输入内容 100块
driver.swtch_to.alert.send_keys('100块')

十四、下拉框

        导入模块：from selenium.webdriver.support.select import select
        假设下拉框为 s ；选择下拉框中的选项 Select(s).方法()
        方法：
        options ：返回下拉框中的所有选项
        select_by_index()：通过索引选择
        select_by_value()：通过选项的value属性值选择
        select_by_visible_text()：通过选项的文本值选择

#定位下拉框，内容是省份
s = driver.find_element_by_id('province')
#获取下拉框里的所有选项内容
opt = Select(s).options
#通过索引选择;若是通过value选择，则html代码要写有value属性
Select(s).select_by_index(-1)
 
 

十五、ActionChains 动作链

        ActionChains 可以帮助模拟鼠标操作；如单击、双击、点击鼠标右键、拖拽等等。使用actionchains对象方法，行为事件是存储在actionchains对象队列。当你使用perform()，事件按顺序执行。

        调用方法有两种：

#链式写法
ActionChains(driver).click(click_btn).double_click(doubleclick_btn).perform()
 
#分步写法
ActionChains(driver).click(click_btn)
ActionChains.double_click(doubleclick_btn)
ActionChains.perform()

   ActionChains常用方法：

click(on_element=None) ——单击鼠标左键
 
click_and_hold(on_element=None) ——点击鼠标左键，不松开
 
context_click(on_element=None) ——点击鼠标右键
 
double_click(on_element=None) ——双击鼠标左键
 
drag_and_drop(source, target) ——拖拽到某个元素然后松开
 
drag_and_drop_by_offset(source, xoffset, yoffset) ——拖拽到某个坐标然后松开
 
key_down(value, element=None) ——按下某个键盘上的键
 
key_up(value, element=None) ——松开某个键
 
move_by_offset(xoffset, yoffset) ——鼠标从当前位置移动到某个坐标
 
move_to_element(to_element) ——鼠标移动到某个元素
 
move_to_element_with_offset(to_element, xoffset, yoffset) ——移动到距某个元素（左上角坐标）多少距离的位置
 
perform() ——执行链中的所有动作
 
release(on_element=None) ——在某个元素位置松开鼠标左键
 
send_keys(*keys_to_send) ——发送某个键到当前焦点的元素
 
send_keys_to_element(element, *keys_to_send) ——发送某个键到指定元素

十六、table表格处理

        table表格代码如下：

    

        
row 1, cell 1
        
row 1, cell 2
    
    

        
row 2, cell 1
        
row 2, cell 2
    

获取表格里的内容，通过 table->tr->td 层层获取

#获取table
table = driver.find_elements_by_id('table')
 
#获取 tr
tr = table.find_elements_by_tag_name('tr')
 
#获取td
td = tr[1].find_elements_by_tag_name('td')
 
#输出内容
print(td[1].text)

十七、生产报告

        连接数据库，把所有的测试用例运行结果输入数据库，然后读取数据库，生成测试报告；如：项目的总测试用例数、成功用例数、失败用例数、跳过数；每个模块的测试用例数、成功用例数、失败用例数、跳过数；