一、介绍

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') 跑出无法找到的异常。

<iframe src="frame.html" id="myframe" name="myframe">

<input id="kw" / >

</iframe>

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表格代码如下：

<table border="1">

<tr>

<td>row 1, cell 1</td>

<td>row 1, cell 2</td>

</tr>

<tr>

<td>row 2, cell 1</td>

<td>row 2, cell 2</td>

</tr>

</table>

获取表格里的内容，通过 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)

十七、生产报告

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