如何快速搭建 Web 自动化测试框架

橙子0012

一、写在前面的话

在使用WebDriver框架之前，我先后使用了其他两款自动化测试框架，IBM Rational Robot（历史悠
久的老牌自动化工具）与TestComplete（功能强大，可支持Web、移动端和桌面程序自动化测试的
付费工具），相比较于WebDrIver，它们对于自动化脚本开发者而言都不够“开放”（可扩展）和“自
由”（可封装），或多或少都有一些局限性，当然这样并不是说WebDriver就没有局限性，对于GUI
桌面程序界面WebDriver目前就束手无策，必须借助其他辅助工具，但这并不妨碍我对WebDriver
的喜爱，因为对于Web端的自动化测试，使用WebDriver可以满足我对页面95%以上的覆盖，并且
在它的基础上快速写出一套符合自己项目的自动化测试框架。

二、准备工作

在开始自己项目的自动化测试之前，我们最好已经完成了下面的准备工作：
1、熟悉待测系统
对项目的待测系统整体功能和业务逻辑有比较清晰的认识。
2、编写系统的自动化测试用例大纲
这一步主要是让我们在编码前，按优先级将系统可实施自动化测试的部分划分出来。
3、选择合适的工具和框架
对于WebDriver，我们可以选择基于java或python，浏览器基于chrome或firefox，WebDriver版本、
浏览器版本，用例管理选择TestNG还是Junit等等都是考虑的因素，这里使用selenium-java 2.53.1/
firefox 45/TestNG 6.8.8。

三、实现步骤

1>创建测试用例的父类BaseCase类：
每个测试用例类都继承自BaseCase类，那么就可以将用例中的公共部分放到BaseCase类中去实现，
从而简化代码结构和减少代码冗余，比如：
a. 使用TestNG框架来管理用例，在BaseCase类中实现@BeforeSuite、@BeforeClass、@BeforeTest
、@BeforeMethod及其对应的After方法等；
b. 一些常用的与用例相关的方法；
c. 公共变量等。

1. public class BaseCase {
   
2.     public static String url = "";
   
3.     public static String username = "";
   
4.     public static String password = "";
   
5. 
   
6.     public static WebDriver driver;
   
7. 
   
8.     @BeforeSuite
   
9.     public void initSuite(){
   
10.         //初始化整个项目，如配置数据同步
    
11.     }
    
12. 
    
13.     @BeforeClass
    
14.     public void initTest(){
    
15.         //初始化测试类，如打开浏览器
    
16.                 driver = new FirefoxDriver();
    
17.     }
    
18. 
    
19.     @AfterClass
    
20.     public void close(){
    
21.                 //关闭浏览器等操作，当然你也可以放在@AfterTest或@AfterMethod
    
22.         driver.close();
    
23.     }
    
24.         ……
    
25. 2>创建用例的操作类TestAction类：
    
26. TestAction类主要封装一些界面动作，比如点击、输入、移动、刷新等，与界面用户操作（动作）相关的都可以封装在这个类里面。
    
27. 
    
28. public class TestAction {
    
29.     private WebDriver driver;
    
30.     public TestAction(WebDriver driver){
    
31.         this.driver = driver;
    
32.     }
    
33.     public void refresh(){
    
34.         driver.navigate().refresh();
    
35.         Log.info("F5刷新页面");
    
36.         sleep(1);
    
37.     }
    
38. 
    
39.     public void moveToElement(WebElement e){
    
40.         if(e != null){
    
41.             Actions action = new Actions(driver);
    
42.             Log.info("鼠标移动到：" + getText(e));
    
43.             action.moveToElement(e).perform();//鼠标移动到元素上面
    
44.         }else{
    
45.             Log.error("未找到对象");
    
46.         }
    
47.     }
    
48. 
    
49.     public void click(WebElement e){
    
50.         if(e != null){
    
51.             Log.info("点击对象：" + getText(e));
    
52.             e.click();
    
53.         }else{
    
54.             Log.error("未找到对象");
    
55.         }
    
56.     }
    
57. 
    
58.     public void setText(WebElement element, Object content, boolean isPrintLog){
    
59.         if(element != null){
    
60.             element.clear();
    
61.             element.sendKeys(String.valueOf(content));
    
62.             if(isPrintLog){
    
63.                 assertEquals(getText(element), content+"", "输入");
    
64.             }
    
65.         }else{
    
66.             Log.error("文本框元素未找到");
    
67.         }
    
68.     }
    
69. }
    
70. 3>封装常用基础控件的Hanlder类：
    
71. 这一步其实放到TestAction中也没毛病，但是将一些常用的基础控件的操作单独封装起来也是可以的（看个人习惯），比如：文本控件操作类TextHandler，表格操作类TableHandler，日期选择控件操作类DatePickerHandler等等，下面以DatePickerHandler类举例：
    
72. 
    
73. public class DatePickerHandler {
    
74.     public static WebElement getDatePicker(){
    
75.         By by = By.xpath("//*[@class='mz-datepicker']/input");
    
76.         return BaseCase.isElementExist(by) ? Page.driver.findElement(by) : null;
    
77.     }
    
78. 
    
79.     public static List<WebElement> getDateLinks(){
    
80.         By by = By.xpath("//*[@class='mz-calendar-top']/a");
    
81.         return BaseCase.isElementsExist(by) ? Page.driver.findElements(by) : null;
    
82.     }
    
83. 
    
84.     public static String setDate(String text){
    
85.         TestAction.click(getDatePicker(), 0.5);
    
86.         if(getDateLinks()==null || getDateLinks().size() < 1){
    
87.             return "";
    
88.         }
    
89.         for(WebElement link : getDateLinks()){
    
90.             if(BaseCase.getText(link).equals(text)){
    
91.                 TestAction.click(link, 0.2);
    
92.                 break;
    
93.             }
    
94.         }
    
95.         Log.info("选择日期范围：" + BaseCase.getText(getDatePicker()));
    
96.         return BaseCase.getText(getDatePicker());
    
97.     }
    
98. 
    
99.     public static String setDateText(String dateRange){
    
100.         ((JavascriptExecutor)Page.driver).executeScript("arguments[0].removeAttribute(\"readOnly\");",getDatePicker());
     
101.         getDatePicker().clear();
     
102.         getDatePicker().sendKeys(dateRange);
     
103.         if(! dateRange.equals(BaseCase.getText(getDatePicker()))){
     
104.             Log.writeInfo("选择日期范围失败，实际："+ BaseCase.getText(getDatePicker()) +"，期望：" + dateRange);
     
105.             return "";
     
106.         }
     
107.         Log.writeInfo("选择日期范围：" + BaseCase.getText(getDatePicker()));
     
108.         return BaseCase.getText(getDatePicker());
     
109.     }
     
110. }
     
111. 4>元素对象管理：
     
112. 前面已经封装了BaseCase类和操作类，但是页面的元素对象该如何管理呢？这可能要根据项目的大小和元素的多少来定，下面我提供几种常用方式：
     
113. a. 直接将元素定位的id 、name或 xpath写在代码中；
     
114. b. 将元素定位的表达式提取出来存放在文本、XML、yaml或json中；
     
115. c. 将元素定位的表达式提取出来存放到数据库中；
     
116. 将元素定位写在代码中，好处就不言而喻了，方便调试嘛，但是对于页面元素上万这种就不推荐了，元素对象将会变得很难管理（估计代码中会遗留很多无用对象），但是对于页面元素不多的情况下还是推荐它的，下面就用PageObject的方式将元素定位写在代码中举例：
     
117. 
     
118. public class HomePage {
     
119.         private WebDriver driver;
     
120.     public HomePage (WebDriver driver){
     
121.                 this.driver = driver;
     
122.         }
     
123.     public WebElement getLeftNavHome(){
     
124.         By by = By.xpath("//a[text()='首页']");
     
125.         return BaseCase.isElementExist(by) ? driver.findElement(by) : null;
     
126.     }
     
127.     public WebElement getUser(){
     
128.         By by = By.xpath("//*[@class='name']/b");
     
129.         return BaseCase.isElementExist(by) ? driver.findElement(by) : null;
     
130.     }
     
131. }
     
132. 5>用例编写：
     
133. 根据页面创建测试用例类，类中根据页面功能点可以写一个或多个@Test，用例的粒度自己把握。
     
134. 
     
135. public class TestHomePage extends BaseCase {
     
136.     private HomePage homePage;
     
137. 
     
138.     @Test
     
139.     public void testHeaderUsername(){
     
140.         if(isLogged){
     
141.             TestAction.refresh();
     
142.             homePage = new HomePage();
     
143. 
     
144.             if(assertEquals(getText(homePage.getUser()), user_name, "用户名")){
     
145.                 TestAction.moveToElement(homePage.getUser());
     
146.                 TestAction.sleep(0.5);
     
147.                 if(homePage.getQuit().isDisplayed()){
     
148.                     TestAction.click(homePage.getQuit(), 0.5);
     
149.                     if(driver.getTitle().contains("登录") || driver.getTitle().contains("Login")){
     
150.                         Log.writeInfo("退出登陆成功");
     
151.                     }else{
     
152.                         Log.writeErrorInfo("退出登陆失败");
     
153.                     }
     
154.                 }
     
155.             }
     
156. 
     
157.         }
     
158.     }
     
159.         @Test
     
160.     public void testXXXXX1(){……}
     
161.         @Test
     
162.     public void testXXXXX2(){……}
     
163. ……
     
164. 6>用例管理：
     
165. 采用TestNG的xml文件来管理用例
     
166. 
     
167. <suite name="WebAutomationTest" parallel="tests" thread-count="1">
     
168.     <listeners>
     
169.         <listener class-name="your Listener" />
     
170.     </listeners>
     
171. 
     
172.     <test name="测试用例" preserve-order="true">
     
173.         <classes>
     
174.                       <class name="com.alany.testcase.TestHomePage"></class>
     
175.                       用例类往后继续添加
     
176.         </classes>
     
177.     </test>         
     
178. </suite>

复制代码

至此这个基于WebDriver+TestNG框架的自动化测试框架就搭起来了，随着项目用例的增加和技能的
提升，你还可以再进一步的优化调整…

梦想家