Page Object Model & Factory in Selenium

Какво е обектен модел на страница? Кои са неговите ключови компоненти?

Page Object Model (POM) е дизайнерски шаблон, популярно използван в автоматизацията на тестовете, който създава хранилище за обекти за елементи от уеб потребителския интерфейс. Предимството на модела е, че намалява дублирането на код и подобрява поддръжката на тестовете.

Съгласно този модел, за всяка уеб страница в приложението трябва да има съответстващ клас Page. Този клас Page ще идентифицира WebElements на тази уеб страница и също така ще съдържа методи на Page, които извършват операции върху тези WebElements. Имената на тези методи трябва да бъдат дадени според задачата, която изпълняват, т.е. ако зареждащ механизъм чака да се появи платежният шлюз, името на POM метода може да бъде waitForPaymentScreenDisplay().

Ключови компоненти на обектния модел на страницата

• Класове на страници: Представете всяка уеб страница като отделен клас.
• Локатори: Идентифицирайте уеб елементи, използвайки идентификатори, XPath или CSS селектори.
• Методи: Съдържат действия или операции, извършвани върху елементите .page.
• Повторна употреба: Promoповторна употреба на TES код и по-лесна поддръжка между тестовете.
• Разделяне на загрижеността: Поддържа структурата на страницата независима от тестовата логика за по-добра организация.

Защо Page Object Model?

Стартиране на автоматизация на потребителския интерфейс в Selenium уебдрайвер НЕ е трудна задача. Просто трябва да намерите елементи и да извършите операции върху тях.

Помислете за този прост скрипт за влизане в уебсайт.

Както можете да видите, всичко, което правим, е да намираме елементи и да попълваме стойности за тези елементи.

Това е скрипт, който отнема време и е склонен към грешки. В началото изглежда лесно, но с разширяването на тестовия набор, управлението на промените в елементите става трудно. Но с времето тестовият набор ще расте. С добавянето на все повече и повече редове към кода си, нещата стават трудни.

Основният проблем с поддръжката на скриптове е, че ако 10 различни скрипта използват един и същ елемент на страницата, с всяка промяна в този елемент, трябва да промените всичките 10 скрипта. Това отнема време и е податливо на грешки.

По-добър подход за поддръжка на скриптове е да се създаде отделен файл с клас, който да намира уеб елементи, да ги попълва или проверява. Този клас може да се използва повторно в множество тестови скриптове, които взаимодействат с един и същ елемент. В бъдеще, ако има промяна в уеб елемента, ще трябва да направим промяната само в 1 файл с клас, а не в 10 различни скрипта.

Този подход се нарича Page Object Model in SeleniumТова помага кодът да бъде по-четлив, по-лесно поддържаем и по-лесно използваем.

👉 Запишете се за безплатен концерт Selenium Проект

Предимства на POM

1. Шаблонът за проектиране на обект на страница казва, че операциите и потоците в потребителския интерфейс трябва да бъдат отделени от проверката. Тази концепция прави нашия код по-чист и лесен за разбиране.
2. Второто предимство е, че хранилището за обекти е независимо от тестовите случаи, така че можем да използваме едно и също хранилище за обекти за различни цели с различни инструменти. Например, можем да интегрираме Page Object Model в Selenium с TestNG/JUnit за функционални Тестване и в същото време с JBehave/Cucumber за тестване за приемане.
3. Code става по-малко и оптимизирано, защото използва повторно методите на страницата в POM класовете.
4. Методите получават по-реалистични имена, които могат лесно да бъдат съпоставени с операцията, извършвана в потребителския интерфейс. Например, ако след щракване върху бутона се озовем на началната страница, името на метода ще бъде като „gotoHomePage()“.

Как да внедрим POM в Selenium?

Прост PLog в основната структура на рамката на Page Object Model, където whereManagereIDElements на AUT и методът, който работи с тези уеб елементи, се поддържа във файл clog. Задача като проверка трябва да бъде отделна като част от методите за тестване.

Пълен пример

тестов случай: Отиди Guru99 Демо сайт.

Стъпка 1) Отидете на Guru99 Демо сайт

Стъпка 2) На началната страница проверете дали текстът „Guru„99 Bank“ е налице

Стъпка 3) Влезте в приложението

Стъпка 4) Проверете дали началната страница съдържа текст като „Идентификационен номер на мениджър: демонстрация“

В този пример имаме работа с две страници:

1. Логин страница
2. Начална страница (показва се след като влезете)

Съответно създаваме 2 POM в Selenium класове

Guru99 Страница за вход POM

package pages;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
public class Guru99Login {
    WebDriver driver;
    By user99GuruName = By.name("uid");
    By password99Guru = By.name("password");
    By titleText =By.className("barone");
    By login = By.name("btnLogin");
    public Guru99Login(WebDriver driver){
        this.driver = driver;
    }
    //Set user name in textbox
    public void setUserName(String strUserName){
        driver.findElement(user99GuruName).sendKeys(strUserName);
    }
    //Set password in password textbox
    public void setPassword(String strPassword){
         driver.findElement(password99Guru).sendKeys(strPassword);
    }
    //Click on the login button
    public void clickLogin(){
            driver.findElement(login).click();
    }
    //Get the title of Login Page
    public String getLoginTitle(){
     return    driver.findElement(titleText).getText();
    }
    /**
     * This POM method allows the test case to perform the login operation
     * @param strUserName
     * @param strPasword
     * @return
     */
    public void loginToGuru99(String strUserName,String strPasword){
        //Fill user name
        this.setUserName(strUserName);
        //Fill password
        this.setPassword(strPasword);
        //Click Login button
        this.clickLogin();        
    }
}

Guru99 Начална страница POM в Selenium

package pages;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
public class Guru99HomePage {
    WebDriver driver;
    By homePageUserName = By.xpath("//table//tr[@class='heading3']");
    public Guru99HomePage(WebDriver driver){
        this.driver = driver;
    }
    //Get the User name from Home Page
        public String getHomePageDashboardUserName(){
         return    driver.findElement(homePageUserName).getText();
        }
}

Guru99 обикновени POM в Selenium Тестов случай

package test;
import java.util.concurrent.TimeUnit;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;
import pages.Guru99HomePage;
import pages.Guru99Login;
public class Test99GuruLogin {
    String driverPath = "C:\\geckodriver.exe";    
    WebDriver driver;
    Guru99Login objLogin;
    Guru99HomePage objHomePage;
    @BeforeTest
    public void setup(){
	System.setProperty("webdriver.gecko.driver", driverPath);        
        driver = new FirefoxDriver();
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.get("https://demo.guru99.com/V4/");
    }
    /**
     * This test case will login in https://demo.guru99.com/V4/
     * Verify login page title as guru99 bank
     * Login to application
     * Verify the home page using Dashboard message
     */
    @Test(priority=0)
    public void test_Home_Page_Appear_Correct(){
        //Create Login Page object
    objLogin = new Guru99Login(driver);
    //Verify login page title
    String loginPageTitle = objLogin.getLoginTitle();
    Assert.assertTrue(loginPageTitle.toLowerCase().contains("guru99 bank"));
    //login to application
    objLogin.loginToGuru99("mgr123", "mgr!23");
    // go the next page
    objHomePage = new Guru99HomePage(driver);
    //Verify home page
    Assert.assertTrue(objHomePage.getHomePageDashboardUserName().toLowerCase().contains("manager id : mgr123"));
    }

В какво е Page Factory Selenium?

Page Factory в Selenium е вградена концепция за рамка на Page Object Model за Selenium WebDriver, който подобрява поддръжката чрез намаляване на повтарящите се търсения на елементи с помощта на анотации, а не чрез скорост на изпълнение. Използва се за инициализиране на обекти Page или за създаване на инстанции на самия обект Page. Използва се също за инициализиране на елементи от класа Page без използване на „FindElement/s“.

Тук също следваме концепцията за разделяне на Page Object Repository и Test Methods. Освен това, с помощта на клас PageFactory в Selenium, използваме анотации @FindBy за да намерим WebElement. Използваме метода initElements за инициализиране на уеб елементи.

@FindBy може да приеме tagName, partialLinkText, име, linkText, id, css, className, xpath като атрибути.

Нека разгледаме същия пример като по-горе, използвайки Page Factory

Guru99 Страница за вход с Page Factory

package PageFactory;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;
import org.openqa.selenium.support.PageFactory;
public class Guru99Login {
    /**
     * All WebElements are identified by @FindBy annotation
     */
    WebDriver driver;
    @FindBy(name="uid")
    WebElement user99GuruName;
    @FindBy(name="password")
    WebElement password99Guru;    
    @FindBy(className="barone")
    WebElement titleText;
    @FindBy(name="btnLogin")
    WebElement login;
    public Guru99Login(WebDriver driver){
        this.driver = driver;
        //This initElements method will create all WebElements
        PageFactory.initElements(driver, this);
    }
    //Set user name in textbox
    public void setUserName(String strUserName){
        user99GuruName.sendKeys(strUserName);     
    }
    //Set password in password textbox
    public void setPassword(String strPassword){
    password99Guru.sendKeys(strPassword);
    }
    //Click on login button
    public void clickLogin(){
            login.click();

    }  
    //Get the title of Login Page
    public String getLoginTitle(){
     return    titleText.getText();
    }
    /**
     * This POM method will be exposed in test case to login in the application
     * @param strUserName
     * @param strPasword
     * @return
     */
    public void loginToGuru99(String strUserName,String strPasword){
        //Fill user name
        this.setUserName(strUserName);
        //Fill password
        this.setPassword(strPasword);
        //Click Login button
        this.clickLogin();           
    }
}

Guru99 Начална страница с Page Factory

package PageFactory;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;
import org.openqa.selenium.support.PageFactory;
public class Guru99HomePage {
    WebDriver driver;
    @FindBy(xpath="//table//tr[@class='heading3']")
    WebElement homePageUserName;    
    public Guru99HomePage(WebDriver driver){
        this.driver = driver;
        //This initElements method will create all WebElements
        PageFactory.initElements(driver, this);
    }   
    //Get the User name from Home Page
        public String getHomePageDashboardUserName(){
         return    homePageUserName.getText();
        }
}

Guru99 Тестови случаи с концепцията на Page Factory

package test;
import java.util.concurrent.TimeUnit;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;
import PageFactory.Guru99HomePage;
import PageFactory.Guru99Login;
public class Test99GuruLoginWithPageFactory {
    String driverPath = "C:\\geckodriver.exe";    
    WebDriver driver;
    Guru99Login objLogin;
    Guru99HomePage objHomePage; 
    @BeforeTest
    public void setup(){
        System.setProperty("webdriver.gecko.driver", driverPath);       
        driver = new FirefoxDriver();
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.get("https://demo.guru99.com/V4/");
    }
    /**
     * This test go to https://demo.guru99.com/V4/
     * Verify login page title as guru99 bank
     * Login to application
     * Verify the home page using Dashboard message
     */
    @Test(priority=0)
    public void test_Home_Page_Appear_Correct(){
        //Create Login Page object
    objLogin = new Guru99Login(driver);
    //Verify login page title
    String loginPageTitle = objLogin.getLoginTitle();
    Assert.assertTrue(loginPageTitle.toLowerCase().contains("guru99 bank"));
    //login to application
    objLogin.loginToGuru99("mgr123", "mgr!23");
    // go the next page
    objHomePage = new Guru99HomePage(driver);
    //Verify home page
    Assert.assertTrue(objHomePage.getHomePageDashboardUserName().toLowerCase().contains("manager id : mgr123"));
    }
}

Пълната структура на проекта ще изглежда като диаграмата:

AjaxElementLocatorFactory

AjaxElementLocatorFactory е концепция за мързеливо зареждане на PageFactory в SeleniumИзползва се за намиране на уеб елементи само когато елементите се използват в някаква операция. Присвоява време за изчакване за WebElements на класа на обекта страница. Едно от ключовите предимства на използването на шаблона PageFactory в Selenium е AjaxElementLocatorFactory клас.

Тук, когато се извършва операция върху елемент, чакането за неговата видимост започва едва от този момент. Ако елементът не бъде намерен в дадения интервал от време, Тестов случай изпълнението ще хвърли изключение „NoSuchElementException“.

Например:

AjaxElementLocatorFactory factory = new AjaxElementLocatorFactory(driver, 10);
PageFactory.initElements(factory, this);

Изтеглете Selenium Проектни файлове за демонстрацията в този урок

Въпроси и Отговори