Why Page factory pattern in Selenium Python? - Purpose & Use Cases

The Big Idea

Discover how to stop repeating yourself and make your tests smarter with one simple pattern!

The Scenario

Imagine testing a website manually by clicking buttons and filling forms every time you want to check if it works.

Now, think about writing code that finds each button or field by repeating long commands everywhere in your test scripts.

The Problem

This manual coding is slow and confusing because you repeat the same code to find elements again and again.

If the website changes, you must update every place in your code, which is tiring and causes mistakes.

The Solution

The Page Factory pattern helps by grouping all the web elements of a page in one place.

This way, your test code is cleaner, easier to read, and you only update element locations once if the page changes.

Before vs After

✗ Before

button = driver.find_element(By.ID, 'submit')
button.click()
# repeated in many tests

✓ After

from selenium.webdriver.common.by import By

class LoginPage:
    def __init__(self, driver):
        self.driver = driver
        self.submit_button = self.driver.find_element(By.ID, 'submit')

login_page = LoginPage(driver)
login_page.submit_button.click()

What It Enables

It enables writing clear, maintainable tests that adapt quickly when the website changes.

Real Life Example

When a website redesign changes button IDs, you fix the locator in one place instead of hunting through many test files.

Key Takeaways

Manual element locating is repetitive and error-prone.

Page Factory groups elements for easy access and maintenance.

Tests become cleaner and faster to update.

Practice

1. What is the main purpose of using the Page Factory pattern in Selenium with Python?

easy

A. To generate test reports automatically

B. To execute tests faster by parallel processing

C. To group web elements in a class for easier access and maintenance

D. To handle browser pop-ups and alerts

Solution

1. Step 1: Understand the role of Page Factory

   Page Factory helps organize web elements by grouping them in a class, making tests easier to read and maintain.

2. Step 2: Compare with other options

   Options B, C, and D describe different Selenium features unrelated to Page Factory's main purpose.

3. Final Answer:

   To group web elements in a class for easier access and maintenance -> Option C

4. Quick Check:

   Page Factory = Group elements for easy access [OK]

Hint: Page Factory groups elements in classes for neat tests [OK]

Common Mistakes:

• Confusing Page Factory with test execution speed
• Thinking it generates reports
• Assuming it handles browser alerts

2. Which of the following is the correct way to declare a web element using Page Factory in Selenium Python?

easy

A. element = driver.find_element(By.ID, 'username')

B. username = (By.ID, 'username')

C. username = self.driver.find_element_by_id('username')

D. username = self.driver.find_element(By.ID, 'username')

Solution

1. Step 1: Identify Page Factory syntax in Python

   Page Factory uses class attributes with locator tuples like (By.ID, 'username') to declare elements before initializing them.

2. Step 2: Check each option

   username = (By.ID, 'username') shows the correct locator tuple usage, which is standard in Page Factory.

3. Final Answer:

   username = (By.ID, 'username') -> Option B

4. Quick Check:

   Page Factory uses locator tuples (By.xx, 'value') [OK]

Hint: Declare Page Factory elements as (By.xx, 'value') tuples [OK]

Common Mistakes:

• Using direct driver.find_element calls instead of Page Factory declarations
• Missing the locator tuple syntax
• Assigning elements directly without initialization

3. Given the following code snippet using Page Factory in Selenium Python, what will be the output of print(page.login_button.is_displayed()) if the button is visible on the page?

from selenium.webdriver.common.by import By
from selenium.webdriver.support.page_factory import PageFactory

class LoginPage:
    def __init__(self, driver):
        self.driver = driver
        PageFactory.init_elements(driver, self)

    login_button = (By.ID, 'loginBtn')

page = LoginPage(driver)
print(page.login_button.is_displayed())

medium

A. True

B. False

C. AttributeError

D. None

Solution

1. Step 1: Understand Page Factory element initialization

   PageFactory.init_elements initializes elements so login_button refers to the actual web element.

2. Step 2: Check the method call

   If the button is visible, is_displayed() returns True, so printing it outputs True.

3. Final Answer:

   True -> Option A

4. Quick Check:

   Visible element's is_displayed() = True [OK]

Hint: is_displayed() returns True if element is visible [OK]

Common Mistakes:

• Expecting None because locator needs initialization
• Confusing AttributeError due to wrong initialization
• Assuming is_displayed() returns string

4. Identify the error in the following Page Factory code snippet and choose the correct fix:

from selenium.webdriver.common.by import By
from selenium.webdriver.support.page_factory import PageFactory

class HomePage:
    def __init__(self, driver):
        self.driver = driver
        PageFactory.init_elements(self, self.driver)

    submit_button = (By.XPATH, "//button[@id='submit']")

page = HomePage(driver)
page.submit_button.click()

medium

A. Initialize elements with PageFactory.init_elements(driver, self)

B. Replace @FindBy with @find_by (lowercase)

C. Import FindBy from correct module and use it as decorator

D. Import and use find_element instead of PageFactory

Solution

1. Step 1: Check PageFactory.init_elements arguments

   The code uses PageFactory.init_elements(self, self.driver) but arguments must be driver first, then self.

2. Step 2: Confirm correct usage

   Using PageFactory.init_elements(driver, self) fixes the error and allows proper element initialization.

3. Final Answer:

   Initialize elements with PageFactory.init_elements(driver, self) -> Option A

4. Quick Check:

   init_elements(driver, self) order [OK]

Hint: PageFactory.init_elements(driver, self) - driver first [OK]

Common Mistakes:

• Wrong argument order for PageFactory.init_elements
• Using wrong decorator name case
• Incorrect PageFactory.init_elements parameters

5. You want to create a Page Factory class for a login page with username, password fields, and a login button. Which approach correctly applies the Page Factory pattern to initialize and use these elements in Selenium Python?

hard

A. Write all element locators inside test functions without any class or decorator

B. Use driver.find_element calls inside each test method without class grouping

C. Create global variables for elements outside any class and access them directly

D. Declare elements with @FindBy decorators, initialize with PageFactory.init_elements, then use element methods

Solution

1. Step 1: Understand Page Factory best practice

   Page Factory groups elements in a class using locator tuples and initializes them with PageFactory.init_elements.

2. Step 2: Compare with other options

   Options B, C, and D do not use Page Factory pattern and lead to less maintainable code.

3. Final Answer:

   Declare elements with @FindBy decorators, initialize with PageFactory.init_elements, then use element methods -> Option D

4. Quick Check:

   Page Factory = locators + init_elements + class grouping [OK]

Hint: Use locators and init_elements to organize page elements [OK]

Common Mistakes:

• Skipping class and locators for elements
• Using driver calls directly in tests
• Not initializing elements with PageFactory