نموذج كائن الصفحة والمصنع في Selenium

مثال كامل

حالة اختبار: انتقل إلى الموقع التجريبي Guru99.

الخطوة 1) انتقل إلى موقع Guru99 التجريبي

الخطوة 2) في الصفحة الرئيسية، تحقق من وجود النص "Guru99 Bank".

الخطوة 3) تسجيل الدخول إلى التطبيق

الخطوة 4) تأكد من أن الصفحة الرئيسية تحتوي على نص باسم "معرف المدير: العرض التوضيحي"

نحن هنا نتعامل مع صفحتين

1. صفحة الدخول
2. الصفحة الرئيسية (تظهر بمجرد تسجيل الدخول)

وفقا لذلك، نقوم بإنشاء 2 POM في Selenium فصول

Guru99 صفحة تسجيل الدخول بوم

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 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 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 الصفحة الرئيسية بوم في 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 بوم بسيط في 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("manger id : mgr123"));

    }

ما هو مصنع الصفحة في Selenium?

مصنع الصفحة في Selenium هو مفهوم إطار نموذج كائن الصفحة يحمل في ثناياه عوامل Selenium WebDriver لكنه مُحسّن للغاية. يتم استخدامه لتهيئة كائنات الصفحة أو لإنشاء كائن الصفحة نفسه. يتم استخدامه أيضًا لتهيئة عناصر فئة الصفحة دون استخدام "FindElement/s".

وهنا أيضًا، نتبع مفهوم الفصل بين مستودع كائنات الصفحة وطرق الاختبار. بالإضافة إلى ذلك، بمساعدة فئة PageFactory في Selenium، نستخدم التعليقات التوضيحية @البحث عن طريق للعثور على WebElement. نستخدم طريقة initElements لتهيئة عناصر الويب

@البحث عن طريق تستطيع القبول tagName، PartialLinkText، name، 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 الصفحة الرئيسية مع مصنع الصفحة

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 TestCase مع مفهوم 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("manger id : mgr123"));

    }

}

سيبدو هيكل المشروع الكامل مثل الرسم التخطيطي:

هنا، عندما يتم تنفيذ عملية على عنصر، يبدأ انتظار ظهوره من تلك اللحظة فقط. إذا لم يتم العثور على العنصر في الفترة الزمنية المحددة، حالة الاختبار سيؤدي التنفيذ إلى استثناء "NoSuchElementException".

الملخص

1. نموذج كائن الصفحة في Selenium WebDriver هو نمط تصميم مستودع الكائنات.
2. Selenium نموذج كائن الصفحة يجعل كود الاختبار الخاص بنا قابلاً للصيانة وإعادة الاستخدام.
3. يعد Page Factory طريقة محسنة لإنشاء مستودع الكائنات في مفهوم إطار عمل نموذج كائن الصفحة.
4. AjaxElementLocatorFactory هو مفهوم تحميل كسول في Page Factory – نمط تصميم كائن الصفحة لتحديد عناصر الويب فقط عند استخدامها في أي عملية.

تحميل Selenium ملفات المشروع للعرض التوضيحي في هذا البرنامج التعليمي