Selenium WebDriver 之 PageObjects 模式 by Example

目录
  1. 项目配置
  2. 一个WebDriver简单例子
  3. 使用Page Objects模式
  4. 总结
  5. Troubleshooting
  6. 参考文档

本篇文章通过例子来阐述一下Selenium2.0 WebDriver 之 Page Objects模式。

项目配置

maven 3, pom.xml配置如下

<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>2.46.0</version>
</dependency>

另外我是用TestNG 写Selenium tests, 加如下dependency

<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>6.8</version>
</dependency>

一个WebDriver简单例子

主要做如下几个动作：

1. 打开博客园首页

2. 断言页面标题出现

3. 在找找看输入框输入字符

4. 点击找找看按钮

5. 断言进入的页面标题

 package test.demo;

 import static org.testng.Assert.assertEquals;

 import org.openqa.selenium.By;
 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.firefox.FirefoxDriver;
 import org.openqa.selenium.firefox.FirefoxProfile;
 import org.testng.annotations.AfterTest;
 import org.testng.annotations.BeforeTest;
 import org.testng.annotations.Test;

 ;

 /**
  * @Description: A simple Test using WebDriver
  * @author wadexu
  *
  * @updateUser
  * @updateDate
  */
 public class WebPageTest {

     private WebDriver driver;

     @BeforeTest
     public void setUp() {
         FirefoxProfile firefoxProfile = new FirefoxProfile();
         // use proxy
         firefoxProfile.setPreference("network.proxy.type", 1);
         firefoxProfile.setPreference("network.proxy.http", "10.51.1.140");
         firefoxProfile.setPreference("network.proxy.http_port", "8080");

         driver = new FirefoxDriver(firefoxProfile);
     }

     @AfterTest
     public void tearDown() {
         driver.close();
     }

     @Test
     public void test() {
         driver.get("http://www.cnblogs.com/");
         assertEquals("博客园 - 开发者的网上家园", driver.getTitle());

         WebElement searchBox = driver.findElement(By.id("zzk_q"));
         searchBox.sendKeys("wadexu");

         WebElement searchBtn = driver.findElement(By.xpath("//*[@id='search_block']/div[1]/input[2]"));
         searchBtn.click();

         assertEquals("wadexu-博客园找找看", driver.getTitle());
     }

 }

这种写法缺点很多， 可读性差，页面元素，操作HTML，测试逻辑全部在一起。

##转载注明出处：http://www.cnblogs.com/wade-xu/p/4744937.html

使用Page Objects模式

PageObjects是对具体页面的抽象，使用时通过PageFactory来构造。

首先我们为博客园首页和找找看搜索页面定义两个page objects

-- CnBlogsHomePage

 package test.demo;

 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.support.FindBy;

 /**
  * @Description: 博客园首页
  * @author wadexu
  *
  * @updateUser
  * @updateDate
  */
 public class CnBlogsHomePage {

     @FindBy(id = "zzk_q") //找找看输入框
     protected WebElement searchBox;

     @FindBy(xpath = "//*[@id='search_block']/div[1]/input[2]") //找找看按钮
     protected WebElement searchBtn;

     public void searchFor(String content) {
         searchBox.sendKeys(content);
         searchBtn.click();
     }
 }

-- SearchResultPage

package test.demo;

import java.util.List;

import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;

/**
 * @Description: 博客园找找看頁面
 * @author wadexu
 *
 * @updateUser
 * @updateDate
 */
public class SearchResultPage {

    @FindBy(id = "searchResult")
    protected WebElement searchResult;

    //for tutorial purpose only
    public boolean searchResultListNotNull() {
        WebElement searchResultItems = searchResult.findElement(By.cssSelector(".forflow"));
        List<WebElement> resultItemTitleList = searchResultItems.findElements(By.tagName("a"));

        for (WebElement e : resultItemTitleList) {
            System.out.println(e.getText());
        }

        return resultItemTitleList.size() > 0;
    }
}

##转载注明出处：http://www.cnblogs.com/wade-xu/p/4744937.html

下面是使用Page Objects 的测试

 package test.demo;

 import static org.testng.Assert.assertTrue;

 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.firefox.FirefoxDriver;
 import org.openqa.selenium.firefox.FirefoxProfile;
 import org.openqa.selenium.support.PageFactory;
 import org.testng.annotations.AfterTest;
 import org.testng.annotations.BeforeTest;
 import org.testng.annotations.Test;

 /**
  * @Description: UsingPageObjectsTest
  * @author wadexu
  *
  * @updateUser
  * @updateDate
  */
 public class UsingPageObjectsTest {

     private WebDriver driver;

     @BeforeTest
     public void setUp() {
         FirefoxProfile firefoxProfile = new FirefoxProfile();
         // use proxy
         firefoxProfile.setPreference("network.proxy.type", 1);
         firefoxProfile.setPreference("network.proxy.http", "10.51.1.149");
         firefoxProfile.setPreference("network.proxy.http_port", "8080");

         driver = new FirefoxDriver(firefoxProfile);
     }

     @AfterTest
     public void tearDown() {
         driver.close();
     }

     @Test
     public void test() {
         driver.get("http://www.cnblogs.com/");
         CnBlogsHomePage homePage = PageFactory.initElements(driver, CnBlogsHomePage.class);
         homePage.searchFor("wadexu");

         SearchResultPage resultPage = PageFactory.initElements(driver, SearchResultPage.class);
         assertTrue(resultPage.searchResultListNotNull());
     }

 }

WebDriver为了支持PageObject模式,支持库包含一个叫PageFactory的工厂类， 我们通过PageFactory的initElements方法来实例化PageObject的实例.

这种方式看上去简洁明了，可读性高，封装了界面交互细节，可以使测试更关注业务逻辑而非页面细节，就像在写功能测试用例。

Run as TestNG 测试结果如下

就是这么简单！使用Rest-assured 测试Restful Web Services
WadeXu
这些年我们一起搞过的持续集成~Jenkins+Perl and Shell script
WadeXu
Postman (Chrome插件)
HackerVirus
VC/MFC如何设置对话框背景颜色
youxin
玩转单元测试之DBUnit
WadeXu
性能分析神器VisualVM
WadeXu
性能分析神器VisualVM
qingchen1984
玩转单元测试之WireMock -- Web服务模拟器
WadeXu
写在离职前夕
平静缓和用胸音说爱
带你入门带你飞Ⅰ 使用Mocha + Chai + Sinon单元测试Node.js
WadeXu
PASSED: test

===============================================
    Default test
    Tests run: 1, Failures: 0, Skips: 0
===============================================

[TestNG] Time taken by org.testng.reporters.JUnitReportReporter@288051: 4 ms
[TestNG] Time taken by org.testng.reporters.SuiteHTMLReporter@4d865b28: 28 ms
[TestNG] Time taken by org.testng.reporters.XMLReporter@45d64c37: 6 ms
[TestNG] Time taken by [TestListenerAdapter] Passed:0 Failed:0 Skipped:0]: 0 ms
[TestNG] Time taken by org.testng.reporters.EmailableReporter@68e6ff0d: 3 ms

##转载注明出处：http://www.cnblogs.com/wade-xu/p/4744937.html

运行的很慢， 主要是因为博客园的页面加载的许多Script 都是在线引入，很多这种source <script async="" type="text/javascript" src="http://www.googletagservices.com/tag/js/gpt.js"></script>

而我又不能禁用script，否则点不了找找看button。

测试截图

总结

本文我们学到的知识点有：

• 使用Selenium WebDriver查找元素，通过By id, xpath, cssSelector, tagName 例子里尽可能的运用了这些方式。
• 通过FirefoxProfile 设置代理， 也可以设置页面不加载一些对象如image, script, stylesheet 设置方式：firefoxProfile.setPreference("permissions.default.image", 2); //2表示关闭
• Page Objects模式， 优点很多，分离页面元素及操作元素的步骤，便于维护， 降低代码冗余度，提升复用率。

(此图来源于网络)

##转载注明出处：http://www.cnblogs.com/wade-xu/p/4744937.html

Troubleshooting

1. org.openqa.selenium.firefox.NotConnectedException: Unable to connect to host 127.0.0.1 on port 7055 after 45000 ms

firefox浏览器版本太高，selenium不兼容，要么降低firefox的版本，要么用新的selenium webDriver

2. Selenium WebDriver正常打开浏览器，但是无法访问页面

跟环境有关，使用FirefoxProfile setPreference 设置个代理， 有几种方式供参考。

WebDriver每次启动一个Firefox的实例时，会生成一个匿名的profile，并不会使用当前Firefox的profile。这点一定要注意。比如如果访问被测试的web服务需要通过代理，你想直接设置Firefox的代理是行不通的，因为WebDriver启动的Firefox实例并不会使用你这个profile，正确的做法是通过FirefoxProfile来设置。

3. org.openqa.selenium.NoSuchElementException: Unable to locate element

代码问题，不能定位元素

参考文档

SeleniumHQ Website

Selenium API JavaDocs

感谢阅读，如果您觉得本文的内容对您的学习有所帮助，您可以点击右下方的推荐按钮，您的鼓励是我创作的动力。

##转载注明出处：http://www.cnblogs.com/wade-xu/p/4744937.html