java - 页面对象模式理解

Question

我无法理解这种模式。 首先，我想在我的页面中测试登录，我有一个 LoginPage 在成功验证后扩展我的 PageObject，它返回 LoginPageReceipt。现在我有了 loginPageReceipt，我想在我的第二页中保留它。我想的第二个问题是，如果我先测试登录，然后我想测试下一个模块，但我必须登录。我应该怎么做？我的第二次测试不应该使用第一次测试的结果，我也不应该复制我的代码。这是我的类(class)。我是怎么做到的。

 package Init;

import org.junit.After;
import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

import java.util.concurrent.TimeUnit;

public class FunctionalTest {
    protected static WebDriver driver;
//    private static WebDriverWait driverWait;

    @BeforeClass
    public static void setUp() {
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--start-maximized");
        System.setProperty("webdriver.chrome.driver", "src\\main\\resources\\chromedriver.exe");
        driver = new ChromeDriver(options);
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
//        driverWait = new WebDriverWait(driver, 10);
    }

    @After
    public void cleanUp() {
        driver.manage().deleteAllCookies();
    }

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

package Init;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.support.PageFactory;

public class PageObject {

    protected WebDriver driver;

    public PageObject(WebDriver driver) {
        this.driver = driver;
        PageFactory.initElements(driver, this);
    }

}
package Login;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;
import Init.PageObject;

import static org.junit.Assert.assertTrue;

public class LoginPage extends PageObject {

    @FindBy(id = "UserName")
    private WebElement userName;

    @FindBy(id = "Password")
    private WebElement password;

    @FindBy(id = "loginButton")
    private WebElement loginButton;

    public LoginPage(WebDriver driver) {
        super(driver);
        assertTrue(userName.isDisplayed());
        assertTrue(password.isDisplayed());
        assertTrue(loginButton.isDisplayed());
    }

    public void enterUserName(String userName) {
        this.userName.clear();
        this.userName.sendKeys(userName);
    }

    public void enterUserPassword(String password) {
        this.password.clear();
        this.password.sendKeys(password);
    }

    public LoginPageReceipt login() {
        loginButton.click();
        return new LoginPageReceipt(driver);
    }
}

package Contractor;

import Init.PageObject;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;

import static org.junit.Assert.assertTrue;

public class ContractorPage extends PageObject {

    @FindBy(id = "moduleContent")
    private WebElement moduleContent;

    public ContractorPage(WebDriver driver) {
        super(driver);
        assertTrue(moduleContent.isDisplayed());
    }
}

package Login;

import Contractor.ContractorPage;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;
import Init.PageObject;

public class LoginPageReceipt extends PageObject {

    @FindBy(xpath = "//*[@id=\"loginPartial\"]/span[5]")
    private WebElement userNamePanel;

    @FindBy(id = "contractors-menuitem")
    private WebElement goToContractorPage;

    public LoginPageReceipt(WebDriver driver) {
        super(driver);
    }

    public String loginConfirmation() {
        return  userNamePanel.getText();
    }

    public ContractorPage contractorPage() {
        goToContractorPage.click();
        return new ContractorPage(driver);
    }
}

package Tests;

import Login.LoginPage;
import Login.LoginPageReceipt;
import org.junit.Test;
import Init.FunctionalTest;

import static org.junit.Assert.assertEquals;

public class LoginTest extends FunctionalTest {

    private static final String USER_NAME = "xxx";
    private static final String PASSWORD = "xxx";

    @Test
    public void login() {
        FunctionalTest.driver.get("xxx");

        LoginPage loginPage = new LoginPage(FunctionalTest.driver);
        loginPage.enterUserName(USER_NAME);
        loginPage.enterUserPassword(PASSWORD);
        LoginPageReceipt loginPageReceipt = loginPage.login();

        assertEquals("Użytkownik: " + USER_NAME + " | Wyloguj", loginPageReceipt.loginConfirmation());
    }

}

package Tests;

import Contractor.ContractorPage;
import Init.FunctionalTest;
import Login.LoginPage;
import Login.LoginPageReceipt;
import org.junit.Test;

import static org.junit.Assert.assertEquals;

public class ContractorTest extends FunctionalTest {

    private static final String USER_NAME = "xxx";
    private static final String PASSWORD = "xxx";

    @Test
    public void contractorPageTest() {
        FunctionalTest.driver.get("xxx");

        LoginPage loginPage = new LoginPage(FunctionalTest.driver);
        loginPage.enterUserName(USER_NAME);
        loginPage.enterUserPassword(PASSWORD);
        LoginPageReceipt loginPageReceipt = loginPage.login();

        assertEquals("Użytkownik: " + USER_NAME + " | Wyloguj", loginPageReceipt.loginConfirmation());

        ContractorPage contractorPage = loginPageReceipt.contractorPage();
    }
}

Answer 1

页面对象模型的一大优点是它是一个通用指南，而不是一个严格的系统。每个人都对如何为他们的 selenium 项目建模有偏好。

为了回答您的直接问题，拥有一个页面对象的方法是完全有效的，它触发一个新页面在浏览器中加载，返回一个代表该页面的新页面对象。

就每个单独的测试而言，除非您试图在一个测试到另一个测试之间保留 Web 应用程序中的状态信息(对我来说这通常是个坏主意)，否则是的，您将需要每个测试都重复此登录程序。但它不一定是重复的代码，将该例程封装在一个方法中，每个测试都可以调用该方法作为首要业务。此外，执行该过程与测试该过程不同，您对登录页面的测试应该断言事情是正确的，需要登录作为中间步骤的其他测试应该跳过这些断言。

页面对象也不需要每个都封装整个页面。您想考虑与您正在测试的应用程序相关的设计。并非所有应用程序的自动化程度都一样，因此 selenium 项目也不应期望是通用的。

如果您的应用是静态页面的集合，这些页面的状态变化不大，您可能希望每个网页有一个页面对象。但是，如果你有一个单页应用程序，它只是 javascript，使得页面的大部分区域非常频繁地出现和消失......也许你的页面对象会更好地封装该单页的区域，代表来来去去的组件或框架但是内部是一致的。

从概念的角度来看，您希望您的页面对象隐藏所有原始 selenium，这样您的测试就不需要知道或关心并提供一个简洁的公共(public) API，您的测试可以调用该 API 以在该页面上执行操作。

您的页面对象的方法是封装页面上的小型操作(例如表单中每个字段的单独方法)，还是更大的工作流(例如填充整个表单并提交的一种方法)由您决定。做出该决定时应考虑到应用程序的设计，您的目标是做出不仅可靠，而且易于创建新内容和易于维护现有内容的内容。

编辑:

这是一个理论上的登录页面对象的示例:

public class LoginPage {
    private final WebDriver driver;

    private final String emailField = "#email";
    private final String passwordField = "#password";
    private final String submitButton = "#submit";

    public LoginPage(WebDriver driver) {
        this.driver = driver;
    }

    // These are our bite sized methods right here
    public LoginPage enterEmail(String email) {
        driver.findElement(By.cssSelector(emailField)).sendKeys(email);
        return this;
    }

    public LoginPage enterPassword(String password) {
        driver.findElement(By.cssSelector(passwordField)).sendKeys(password);
        return this;
    }

    public void submit() {
        driver.findElement(By.cssSelector(submitButton)).click();
    }

    // This method represents an entire workflow, 
    // containing multiple bite-sized chunks.
    public void performLogin(String email, String password) {
        enterEmail(email);
        enterPassword(password);
        submit();
    }
}

要使用，您的测试可以执行如下操作:

WebDriver driver = new ChromeDriver(options);
LoginPage loginPage = new LoginPage(driver);

//One way:
loginPage.enterEmail("my@email.com").enterPassword("12345").submit();

// Another way:
loginPage.performLogin("my@email.com", "12345");

如果您确切知道您将被重定向到哪里，您的 submit 和 performLogin 方法可以返回您的下一个页面对象的实例。