本文将使用Maven + TestNG + Java + Selenium 的项目来作为例子来讲解如何实现POM。
1.POM是什么
Page Object Model 是一种自动化测试的设计模式,为Web UI元素创建Object Repository。它的优点就是减少了代码的重复,提高了测试维护。
一般情况下,POM的项目需要包括3部分:
PageModle:每个页面都应该有自己的的PageClass文件,这个PageClass将标识该页面的Web元素,并包含对这些Web元素执行操作的方法
TestCase:测试用例管理部分,一个功能点可以对应一个或者多个case,尽可能的提高覆盖率
Utilities:可以包含一些报告等内容
按照上边的解释,我们可以把项目分为三部分,在项目中创建三个packages: pages,tests,utilities,如下图所示:
2.使用POM的好处
POM模式使得测试用例和页面元素操作分开,这样可以使我们的代码更干净,更容易理解,且更容易维护;
对象存储库独立于测试用例,因此我们可以使用不同的工具为不同的目的使用相同的对象存储库。 例如,我们可以将POM与用于功能测试的Test NG/JUnit集成,同时与用于验收测试的JBehave/Cucumber集成;
测试用例更加简短,而且可重用页面元素和方法,代码变得更少,更简洁;
方法使用更真实的名称,这些名称可以很容易地与UI中发生的操作映射。例如:如果单击按钮后,回返回主页面,方法名称将类似于gotoHomePage(),易于理解。
3.如何创建一个POM项目
接下来我们通过一个简单的测试用例(登录账户的验证)来进行扩展,一步一步演变成POM的模式的项目。
最原始的代码如下:
@Test
public void ValidPasswordLogin(){
//1. Open browser and open test url
System.setProperty("webdriver.chrome.driver", "Driver/chromedriver");
WebDriver driver;
driver = new ChromeDriver();
driver.manage().window().maximize();
driver.get("http://jinshuju.com");
//2. Test part
//2. 1 Home page: Click login button go to login page
driver.findElement(By.cssSelector(".login-link")).click();
//2. 2 Login page: Input username and password to login
driver.findElement(By.id("auth_key")).sendKeys("131****8959");
driver.findElement(By.cssSelector(".gd-btn.gd-btn-primary-solid")).click();
driver.findElement(By.id("password")).sendKeys("Abcdef");
driver.findElement(By.cssSelector(".gd-btn.gd-btn-primary-solid")).click();
Assert.assertEquals(driver.findElement(By.className("validate-invalid")).getText(),"密码错误,请输入正确的密码(还剩余4次)");
//3. Quite browser
driver.quit();
}
首先,通过上述代码,可以看到一些common的方法例如:sendKeys, click, getText, assert,几乎在每个页面,都会频繁使用这些方法。如果单纯的使用Selenium自己的这些方法,可能会遇到一些问题,例如因为加载慢某个按钮还没有加载完成,但是已经触发了点击事件,此时会因为找不到按钮而失败,等等很多类似的问题。基于这些问题,我们首先可以对selenium这些最基本的方法进行重写。在pages package下边创建一个BasePage.java文件来重写这些方法,之后所有的页面都继承于BasePage类。
BasePage.java
package pages;
import org.junit.Assert;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
public class BasePage {
public WebDriver driver;
public WebDriverWait wait;
//Constructor
public BasePage (WebDriver driver){
this.driver = driver;
wait = new WebDriverWait(driver,20);
}
//Wait
public void waitVisibility(By elementBy) {
wait.until(ExpectedConditions.visibilityOfAllElementsLocatedBy(elementBy));
}
//Click
public void click(By elementBy){
waitVisibility(elementBy);
driver.findElement(elementBy).click();
}
//Write Text
public void writeText (By elementBy, String text) {
waitVisibility(elementBy);
driver.findElement(elementBy).sendKeys(text);
}
//Read Text
public String readText (By elementBy) {
waitVisibility(elementBy);
return driver.findElement(elementBy).getText();
}
//Assert
public void assertEquals (By elementBy, String expectedText) {
waitVisibility(elementBy);
Assert.assertEquals(readText(elementBy), expectedText);
}
}
接下来,分析整个代码块,可以分为三部分:
在执行测试步骤之前,我们需要先打开浏览器,输入测试的地址;
执行测试用例;
执行完测试用例之后,关闭浏览器。
第1和3这两部分:
分析: 因为每条测试用例都会打开浏览器和关闭浏览器,所以我们可以将他们放在一个BaseTest类中,使用@BeforeMethod和@AfterMethod注解(这个是TestNG的注解,如果不知道请学习TestNG的注解),在每一个测试方法执行之前都会先执行@BeforeMethod,在每一个测试方法执行之后都会执行@AfterMethod。
做法: 在tests的Package下边创建一个BaseTest.java类,将1和3 两部分写在这个BaseTest类中:
BaseTest.java
package tests;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.annotations.*;
public class BaseTest {
public WebDriver driver;
@BeforeMethod
public void setUp() {
//1. Open browser and open test url
System.setProperty("webdriver.chrome.driver", "Driver/chromedriver");
driver = new ChromeDriver();
driver.manage().window().maximize();
driver.get("http://jinshuju.com");
}
@AfterMethod
public void quiteBrowser() {
//3. Quite browser
driver.quit();
}
}
第2部分
分析: 第2部分是测试代码部分,可以看到 1). 要对两个页面(Home page 和Login page)进行操作;2). 每个页面都有各自的元素和方法。所以我们可以按照页面进行拆分,每个页面为一个类,每个页面的类中包含对应页面的元素部分和方法部分,这样就比较清晰,而且当添加新的Case的时候也可以去复用现有的方法。
做法: 在pages这个package下边创建一个HomePage.java 类和一个LoginPage.java 类,将各自页面的方法也在各自页面中。 然后在每个page类中分为定位元素和方法两部分:
HomePage.java
package pages;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
public class HomePage extends BasePage{
//Constructor
public HomePage(WebDriver driver) {
super(driver);
}
//Elements
By loginButton = By.cssSelector(".btn-outline");
//Actions
public void clickLogin(){
click(loginButton);
}
}
LoginPage.java
package pages;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.testng.Assert;
public class LoginPage extends BasePage{
//Constructor
public LoginPage(WebDriver driver) {
super(driver);
}
//Elements
By userNameInput = By.id("auth_key");
By loginButton = By.cssSelector(".btn-lg");
By passwordInput = By.id("password");
By errorMessage = By.cssSelector(".alert");
//Actions
public void inputUsernamePwd(String userName, String password){
writeText(userNameInput,userName);
writeText(passwordInput,password);
click(loginButton);
}
public void verifyErrorMessage(String expectedErrorMessage){
Assert.assertEquals(readText(errorMessage),expectedErrorMessage);
}
}
此时,已经给每个页面创建了自己的类,而且每个页面类包含自己的元素定位和方法。接下来,需要创建测试用例来调用每个页面的方法,在tests package 下创建 loginTests.java 类,内容如下。注释部分是之前的代码,已经被新的代码代替。这样测试用例部分就很清晰,很简洁。
loginTests.java
package tests;
import org.openqa.selenium.WebDriver;
import org.testng.annotations.Test;
import pages.HomePage;
import pages.LoginPage;
public class loginTests extends BaseTest{
public static WebDriver driver;
public static LoginPage loginPage = new LoginPage(driver);
public static HomePage homePage = new HomePage(driver);
@Test
public void InvalidPasswordLogin(){
//driver.findElement(By.cssSelector(".btn-outline")).click();
homePage.clickLogin();
//driver.findElement(By.id("auth_key")).sendKeys("131****8959");
//driver.findElement(By.id("password")).sendKeys("Abcdef");
//driver.findElement(By.cssSelector(".btn-lg")).click();
loginPage.inputUsernamePwd("131****8959","Abcdef");
//Assert.assertEquals(driver.findElement(By.cssSelector(".alert")).getText(),"账号密码不正确");
loginPage.verifyErrorMessage("账号密码不正确");
}
}
分析结束后,我们的代码结构如下图: