Model obiektu strony i fabryka w Selenium

Czym jest Page Object Model? Jakie są jego kluczowe komponenty?

Model obiektowy strony (POM) To wzorzec projektowy, popularnie stosowany w automatyzacji testów, który tworzy repozytorium obiektów dla elementów interfejsu użytkownika. Zaletą tego modelu jest redukcja duplikacji kodu i usprawnienie utrzymania testów.

W tym modelu, dla każdej strony internetowej w aplikacji powinna istnieć odpowiadająca jej klasa Page. Klasa ta identyfikuje elementy WebElement danej strony internetowej, a także zawiera metody Page, które wykonują operacje na tych elementach WebElement. Nazwy tych metod powinny być podane zgodnie z wykonywanym przez nie zadaniem, np. jeśli moduł ładujący oczekuje na pojawienie się bramki płatności, nazwą metody POM może być waitForPaymentScreenDisplay().

Kluczowe komponenty modelu obiektów stron

• Klasy stron: Każdą stronę internetową należy przedstawić jako osobną klasę.
• Lokalizatory: Identyfikuj elementy sieciowe za pomocą identyfikatorów, ścieżek XPath lub selektorów CSS.
• metody: Zawierają akcje lub operacje wykonywane na elementach .page.
• Możliwość ponownego wykorzystania: Promoponowne wykorzystanie kodu testowego i łatwiejsza konserwacja testów.
• Oddzielenie obaw: Utrzymuje strukturę strony niezależną od logiki testu, co zapewnia lepszą organizację.

Dlaczego model obiektowy strony?

Uruchamianie automatyzacji interfejsu użytkownika w Selenium Sterownik sieciowy NIE jest trudnym zadaniem. Wystarczy znaleźć pierwiastki i wykonać na nich operacje.

Rozważ ten prosty skrypt umożliwiający zalogowanie się do witryny internetowej.

Jak widać, jedyne, co robimy, to znajdowanie elementów i wypełnianie dla nich wartości.

To czasochłonny skrypt, podatny na błędy. Początkowo wydaje się prosty, ale wraz z rozbudową zestawu testów zarządzanie zmianami elementów staje się trudne. Z czasem jednak zestaw testów będzie się rozrastał. W miarę dodawania kolejnych linii kodu, sytuacja staje się trudniejsza.

Główny problem związany z konserwacją skryptów polega na tym, że jeśli 10 różnych skryptów używa tego samego elementu strony, każda zmiana w tym elemencie wymaga zmiany wszystkich 10 skryptów. Jest to czasochłonne i podatne na błędy.

Lepszym podejściem do obsługi skryptów jest utworzenie osobnego pliku klasy, który będzie wyszukiwał elementy webowe, wypełniał je lub weryfikował. Tę klasę można następnie wykorzystać ponownie w wielu skryptach testowych, które oddziałują na ten sam element. W przyszłości, jeśli nastąpi zmiana w elemencie webowym, będziemy musieli wprowadzić ją w jednym pliku klasy, a nie w dziesięciu różnych skryptach.

To podejście nazywa się modelem obiektowym strony SeleniumPomaga uczynić kod bardziej czytelnym, łatwiejszym w utrzymaniu i nadającym się do ponownego wykorzystania.

👉 Zarejestruj się bezpłatnie na żywo Selenium Projekt

Zalety POM

1. Wzorzec projektowy obiektu strony mówi, że operacje i przepływy w interfejsie użytkownika powinny być oddzielone od weryfikacji. Ta koncepcja sprawia, że ​​nasz kod jest czystszy i łatwiejszy do zrozumienia.
2. Drugą korzyścią jest to, że repozytorium obiektów jest niezależne od przypadków testowych, dzięki czemu możemy używać tego samego repozytorium obiektów do różnych celów i za pomocą różnych narzędzi. Na przykład, możemy zintegrować Page Object Model z… Selenium w TestNG/JUnit za funkcjonalne Testy i jednocześnie z JBehave/Cucumber do testów akceptacyjnych.
3. Code staje się mniej rozbudowany i zoptymalizowany, ponieważ ponownie wykorzystuje metody stron w klasach POM.
4. Metody otrzymują bardziej realistyczne nazwy, które można łatwo odwzorować na operacje wykonywane w interfejsie użytkownika. Np. jeśli po kliknięciu przycisku zostaniemy przeniesieni na stronę główną, nazwa metody będzie wyglądać następująco: 'gotoHomePage()'.

Jak wdrożyć POM w Selenium?

Prosty PLog w podstawowej strukturze struktury Page Object Model, gdzie whereManagereIDElements AUT a metody działające na tych elementach sieciowych są przechowywane w pliku Clog. Zadanie takie jak weryfikacja powinno być oddzielone w ramach metod testowych.

Kompletny przykład

Przypadek testowy: Iść do Guru99 Strona demonstracyjna.

Krok 1) Przejdź do Guru99 Strona demonstracyjna

Krok 2) Na stronie głównej sprawdź, czy tekst „Guru„99 Bank” jest obecny

Krok 3) Zaloguj się do aplikacji

Krok 4) Sprawdź, czy strona główna zawiera tekst „Identyfikator menedżera: demo”

W tym przykładzie mamy do czynienia z dwiema stronami:

1. Strona logowania
2. Strona główna (wyświetlana po zalogowaniu)

W związku z tym tworzymy 2 POM w Selenium Klasy

Guru99 Strona logowania 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 Strona główna POM w 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 Prosty POM w Selenium Przypadek testowy

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"));
    }

W czym jest Page Factory Selenium?

Strona Fabryki w Selenium jest wbudowaną koncepcją frameworka Page Object Model dla Selenium WebDriver, który poprawia łatwość utrzymania poprzez redukcję powtarzających się wyszukiwań elementów za pomocą adnotacji, a nie poprzez szybkość wykonywania. Służy do inicjalizacji obiektów Page lub tworzenia instancji samego obiektu Page. Służy również do inicjalizacji elementów klasy Page bez użycia funkcji „FindElement/s”.

Tutaj również kierujemy się koncepcją rozdzielenia Repozytorium Obiektów Strony i Metod Testowania. Dodatkowo przy pomocy klasy PageFactory w Selenium, używamy adnotacji @FindBy Aby znaleźć WebElement. Używamy metody initElements do inicjalizacji elementów webowych.

@FindBy Mogę zaakceptować tagName, częściowyLinkText, nazwa, linkText, identyfikator, css, nazwa klasy, xpath jako atrybuty.

Spójrzmy na ten sam przykład co powyżej, używając Page Factory

Guru99 Strona logowania z 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 Strona główna z 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 przypadków testowych z koncepcją 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"));
    }
}

Kompletna struktura projektu będzie wyglądać jak na diagramie:

Fabryka AjaxElementLocator

Fabryka AjaxElementLocator to koncepcja leniwego ładowania PageFactory w SeleniumSłuży do znajdowania elementów sieciowych tylko wtedy, gdy są one używane w dowolnej operacji. Przypisuje limit czasu dla elementów sieciowych do klasy strony obiektu. Jedną z kluczowych zalet stosowania wzorca PageFactory w Selenium jest klasą AjaxElementLocatorFactory.

W tym przypadku, gdy operacja jest wykonywana na elemencie, oczekiwanie na jego widoczność rozpoczyna się dopiero od tego momentu. Jeśli element nie zostanie znaleziony w podanym przedziale czasu, Przypadek testowy wykonanie zgłosi wyjątek „NoSuchElementException”.

Na przykład:

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

Pobierz Selenium Pliki projektu dla wersji demonstracyjnej w tym samouczku

FAQ