配置环境
python2.7
运行工具pycharm2017
简介
Page Object模式是Selenium中的一种测试设计模式,主要是将每一个页面设计为一个class(封装在一个class类中),其中包含页面中需要测试的所有元素(按钮,输入框,标题等)的属性和操作,这样在Selenium测试页面中可以通过调用页面类来获取页面元素,这样巧妙的避免了当页面元素id或者位置变化时,需要改测试页面代码的情况。当页面元素id变化时,只需要更改测试页Class中页面的属性即可。
强调测试、逻辑、数据和驱动相互分离
目的: 测试代码与被测页面对象代码分离,后期如果有页面元素发生了更改,只需要修改相应页面对象的代码(即对应Class文件),而不需要修改测试代码
它的好处如下:
¥集中管理元素对象
¥集中管理一个page内的公共方法
¥后期维护方便
一、测试用例:使用单元测试框架
二、业务模块:使用 Page Object 设计模式,设计 Common 类
三、封装驱动:
封装单一的工具,或者多个工具都可以
封装 WebDriver(Selenium)成为 BoxDriver,支持Web UI 自动化测试
封装其他特定工具 成为 DbDriver,支持数据库测试
封装接口测试工具 成为 ServiceDriver,支持集成测试,接口测试
封装 Appium工具 成为 AppDriver,支持移动APP UI自动化测试
详细教程参看虫师的博客http://www.cnblogs.com/fnng/
以下整理的是工作中自动化项目的知识内容,包括怎样搭建自动化测试框架、执行自动化测试用例、生成自动化测试报告、发送测试报告邮件....
一、项目结构介绍
下面逐级介绍此目录与文件的作用
1.UITest测试项目
IEMS:用于存放IEMS项目的测试用例、测试报告和测试数据等。
driver:用于存放浏览器驱动。如selenium-server-standalone-2.47.0jar、chromedriver.exe、IEDriverServer.exe等。在执行测试前根据执行场景将浏览器驱动复制到系统环境path目录下。
package:用于存放自动化所用到的扩展包。例如:HTMLTestRunner.py属于一个单独模块
run_IEMS_test.py:项目主程序。用来运行IEMS自动化用例。
startup.bat:用于启动selenium server,默认启动driver目录下的selenium-server-standalone-2.44.0.jar。
自动化测试说明文档.docx:介绍当前项目的架构、配置和使用说明。
2.IEMS目录
data:该目录用来存放测试相关数据。
report:用于存放HTML测试报告。其下面创建了image目录用于存放测试过程中的截图。
test_case:测试用例目录,用于存放测试用例及相关模块。
3.test_case
models:该目录下存放了一些公共的配置函数及公共类。
page_obj:该目录用于存放测试用例的页面对象(Page Object)。根据自定义规则,以“*Page.py”命名的文件为封装的页面对象文件。
*_sta.py:测试用例文件。根据测试文件匹配规则,以“*_sta.py”命名的文件被当作自动化测试用例执行。
二、编写公共模块
首先定义驱动文件: ...\UITest\IEMS\test_case\models\driver.py
定义浏览器驱动函数browser(),该函数可以进行配置,根据我们的需要,配置测试用例在不同的主机及浏览器下运行。
自定义测试框架类: ...\UITest\IEMS\test_case\models\myunit.py
定义初始函数: 定义MyTest()类用于继承unittest.TestCase类,因为创建的所有测试类中setUp()初始条件与tearDown()结束条件所做的事情相同,所以,将他们抽象为MyTest()类,好处就是在编写测试用例时不再考虑这两个方法的实现。
...\UITest\bbs\test_case\models\function.py
创建截图函数insert_img(),为了保持自动化项目的移植性,采用相对路径的方式将测试截图保持到.\report\image目录中。
三、编写Page Object
首先创建基础Page基础类(iems为例):...\UITest\IEMS\test_case\page_obj\base.py
创建页面基础类,通过__init__()方法初始化参数:浏览器驱动、URL地址、超时时长等。定义基本方法:open()用于打开IEMS地址:find_element()和find_elements()分别用来定位单个与多个元素;创建script()方法可以更简便地调用JavaScript代码。当然还可以对更多的WebDriver方法进行重定义。
创建IEMS登录对象类:
...\UITest\IEMS\test_case\page_obj\loginPage.py
创建登录页面对象,对用户登录页面上的用户名/密码输入框、登录按钮和提示信息等元素的定位进行封装。除此之外,还创建user_login()方法作为系统统一登录的入口。关于对操作步骤的封装可以放在Page Object当中,也可以放在测试用例当中,这个主要根据具体的需求来衡量。这里之所以要放在Page Object当中,主要考虑到还会有其他的测试用例调用到该登录方法。为username 和 password 入参数设置了默认值是为了方便其他用例在调用user_login()时不用再传递登录用户信息,因为该系统大多用例的执行使用该账号即可,同时也方便了在账号失效时的修改。
创建选择工程对象类:
...\UITest\IEMS\test_case\page_obj\projectPage.py
projectPage.py
from selenium.webdriver.common.by import By
from base import Page
import unittest
class project(Page):
url = '/selectProject'
selection_project1_loc = (By.XPATH, "//div[@id='system-selector-main']/div/div[2]/div[1]")
def selection_project_success(self):
projectname = self.find_element(*self.selection_project1_loc).text
return projectname
def selection_project1_action(self):
return self.driver.find_element(*self.selection_project1_loc).click()
if __name__ == "__main__":
unittest.main()
创建首页对象类:
...\UITest\IEMS\test_case\page_obj\homePage.py
homePage.py
from selenium.webdriver.common.by import By
from base import Page
import unittest
class home(Page):
url = '/home'
project_name_loc = (By.XPATH, "//div[@id='system-selector-main']/div/div[2]/div[1]")
project_introducion_loc = (By.XPATH, "//*[@id='scroll']")
def project_name_success(self):
project_name = self.find_element(*self.project_name_loc).text
return project_name
def project_introduction_loc(self):
return self.driver.find_element(*self.project_introduction_loc).text
if __name__ == "__main__":
unittest.main()
四、编写测试用例
现在开始编写测试用程序,因为前面已经做好了基础工作,此时测试用例的编写将会简单的许多,更能集中精力考虑用例的设计和事项。
创建IEMS登录类:
...\UITest\IEMS\test_case\login_sta.py
此处需要注意文件名的创建。例如,假设登录页的对象命名为loginPage.py,那么关于测试登录的用例文件应该命名为login_sta.py,这样方便后期用例报错时问题跟踪。尽量把一个页面上的元素定位封装到一个“*Page.py”文件中,把针对这个页面的测试用例集中到一个“*_sta.py”文件中
注:对文本描述的判断,添加以下判断语句
try:
self.assertEqual(po.project_introduction_success(), u'我是文字信息')
print('测试通过')
except Exception as e:
print 'the error content is %s' % po.project_introduction_success()
login_sta.py
#-*-coding:utf-8-*-
from time import sleep
import unittest, random ,sys
sys.path.append("./models")
sys.path.append("./page_obj")
from models import myunit, function
from page_obj.loginPage import login
class loginTest(myunit.MyTest):
'''测试用户登录'''
def user_login_verify(self, username='',password=''):
login(self.driver).user_login(username,password)
def test_login1(self):
'''用户名、密码为空登录'''
self.user_login_verify()
po = login(self.driver)
self.assertEqual(po.user_error_hint(),"账号不能为空")
self.assertEqual(po.pawd_error_hint()."密码不能为空")
function.insert_img(self.driver,"user_pawd_empty.jpg")
def test_login2(self):
'''用户名正确,密码为空登录'''
self.user_login_verify(username="*******")
po = login(self.driver)
self.assertEqual(po.pawd_error_hint(),"密码不能为空")
function.insert_img(self.driver,"paqd_empty.jpg")
def test_login3(self):
'''用户名为空,密码正确'''
self.user_login_verify(password="*******")
po = login(self.driver)
self.assertEqual(po.user_error_hint(),"账号不能为空")
function.insert_img(self.driver,"user_empty.jpg")
def test_login4(self):
'''用户名与密码不匹配'''
character = random.choice('abcdefghijklmnopqrstuvwxyz')
username = "zhangsan" + character
self.user_login_verify(username=username,password="123456")
po = login(self.driver)
self.assertEqual(po.pawd_error_hint(),"密码与账号不匹配")
function.insert_img(self.driver,"user_pwad_error.jpg")
def test_login5(self):
'''用户名、密码正确'''
self.user_login_verify(username='********@qq.com',password='********')
sleep(2)
po = login(self.driver)
self.assertEqual(po.user_login_success(), u'Ztiny')
function.insert_img(self.driver ,"user_pwd_ture.jpg")
if __name__ == '__main__':
unittest.main()
首先创建loginTest()类,继承myunit.Mytest()类,关于Mytest()类的实现,请翻看前面代码。这样就省去了在每一个测试类中实现一遍setUp()和tearDown()方法。
创建user_login_verify()方法,并调用loginPage.py中定义的user_login()方法。为什么不直接调用呢?因为user_login()的入参已经设置了默认值,原因前面已经解释,这里需要重新将其入参的默认值设置为空即可。
前三条测试用例很好理解,分别验证:
用户名密码为空,点击登录
用户名正确,密码为空,点击登录
用户名为空,密码正确,点击登录
第四条用例验证错误用户名和密码登录。在当前系统中如果反复使用固定错误的用户名和密码,系统会弹出验证码输入框。为了避免这种情况的发生,就需要用户名进行随机变化,此处的做法用固定前缀“zhangsan”,末尾字符从a~z中随机一个字符与前缀进行拼接。
第五条用例验证正确的用户名和密码登录,通过获取用户名作为断言信息
在上面的测试用例中,每条测试用例结束时都调用function.py文件中的insert_img函数进行截图。当用例运行完成后,打开...\report\image\目录将会看到用例执行的截图文件.
创建工程选择类:
...\UITest\IEMS\test_case\SelectionPage_sta.py
#-*-coding:utf-8-*-
from time import sleep
import unittest, random ,sys
sys.path.append("./models")
sys.path.append("./page_obj")
from models import myunit, function
from page_obj.loginPage import login
from page_obj.projectPage import project
class selectionProjectTest(myunit.MyTest):
login(self.driver).user_login(username='qqq',password='1234')
sleep(2)
po = project(self.driver)
self.assertEqual(po.selection_project_success(),u"选择第一个")
function.insert_img(self.driver,"selection_project.jpg")
if __name__ == '__main__':
unittest.main()
创建首页类:
...\UITest\IEMS\test_case\HomePage_sta.py
#-*-coding:utf-8-*-
from time import sleep
import unittest, random ,sys
sys.path.append("./models")
sys.path.append("./page_obj")
from models import myunit, function
from page_obj.loginPage import login
from page_obj.projectPage import project
from page_obj.homePage import home
class homeProjectTest(myunit.MyTest):
def test_project_name(self):
login(self.driver).user_login(username='qqq',password='1234')
sleep(2)
project(self.driver).selection_project1_action()
sleep(2)
po = home(self.driver)
self.assertEqual(po.project_name_success(),u"选择第一个")
function.insert_img(self.driver,"projectname.jpg")
if __name__ == '__main__':
unittest.main()
五、执行测试用例
为了在测试用例运行过程中不影响做其他事,笔者选择调用远程主机或虚拟机来运行测试用例,那么这里就需要使用Selenium Grid(其包含Selenium Server)来调用远程节点。
创建...\UITest\startup.bat文件,用于启动...\UITest\driver\目录下的Selenium Server。
startup.bat
@echo off
echo 启动hub
java -jar .\mztestpro\driver\selenium-server-standalone-2.40.0.jar -role hub -host 192.168.0.102 -port 4444
echo 启动node
java -jar .\mztestpro\driver\selenium-server-standalone-2.40.0.jar -role node -port 5555 -hub http://192.168.0.102:4444/grid/register
创建用例执行程序:...\UITest\run_IEMS_test.py 双击startup.bat文件,启动Selenium Server创建主hub节点。在远程主机或虚拟机中通样需要启动Selenium Server创建node节点。
run_IEMS_test.py
#-*-coding:utf-8-*-
from HTMLTestRunner import HTMLTestRunner
from email.mime.text import MIMEText
import smtplib
import unittest
import time
import os
# =========================邮件接收者============================
mailto_list=["********@qq.com"]
#============= 设置服务器,用户名、口令以及邮箱的后缀===============
mail_host="smtp.163.com"
mail_user="******@163.com"
mail_pass="*******"
#===========================发送邮件============================
def send_mail(to_list,file_new):
'''''
to_list:发给谁
sub:主题
content:内容
send_mail("aaa@126.com","sub","content")
'''
f = open(file_new, 'rb')
mail_body = f.read()
f.close()
me=mail_user
msg = MIMEText(mail_body,'html','utf-8')
msg['Subject'] = u'自动化测试报告'
msg['From'] = me
msg['To'] = ";".join(to_list)
try:
s = smtplib.SMTP()
s.connect(mail_host,25)
s.login(mail_user,mail_pass)
s.sendmail(me, to_list, msg.as_string())
s.close()
return True
except Exception, e:
print str(e)
return False
#==============查找测试报告目录,找到最新生成的测试报告文件==========
def new_report(testreport):
lists = os.listdir(testreport)
lists.sort(key=lambda fn:os.path.getatime(testreport + "\\" + fn))
file_new = os.path.join(testreport,lists[-1])
print(file_new)
return file_new
if __name__ == '__main__':
now = time.strftime("%Y-%m-%d %H_%M_%S")
filename = './bbs/report/' + now +'result.html'
fp = open(filename,'wb')
runner = HTMLTestRunner(stream=fp,
title=u'百度登录自动化测试报告',
description=u'环境 :window 7 浏览器:firefox')
discover = unittest.defaultTestLoader.discover('./bbs/test_case',
pattern='*_sta.py')
runner.run(discover)
fp.close()
file_path = new_report('./bbs/report/')
if send_mail(mailto_list,file_path):
print u"发送成功"
else:
print u"发送失败"
打开...\UITest\driver.py 文件,修改脚本运行的节点及浏览器。现在可以通过运行run_IEMS_test.py来执行测试项目了。 执行过程中并没有任何改动,集成HTMLTestRunner生成的HTML测试报告,以及集成自动发邮件功能等。唯一需要注意的是,脚本中的路径建议使用相对路径,以便于项目被移动到任意目录下执行。
小结:
如果你完成了前面的操作,那么这只是自动化项目的开始,不过,我们已经把基本架构设计完成,后面大部分工作就是编写各个页面的*Page.py以及测试用*_sta.py。在这个过程中会遇到各种各样的问题,如元素定位、架构的扩展,需要读者自己去克服这些问题。
参考资料: