Why POM organizes test code in Selenium Python

Introduction

Page Object Model (POM) helps keep test code neat and easy to understand by separating page details from test steps.

When you want to test a website with many pages.

When you want to avoid repeating code for the same page elements.

When you want to make tests easier to update if the website changes.

When working in a team to keep code organized and clear.

When you want to write tests faster by reusing page actions.

Syntax

Selenium Python

from selenium.webdriver.common.by import By

class PageName:
    def __init__(self, driver):
        self.driver = driver
        self.element_locator = (By.ID, "example_id")

    def action_on_element(self):
        self.driver.find_element(*self.element_locator).click()

Each page is a class with locators and actions.

Tests use these classes instead of raw Selenium commands.

Examples

This class represents the login page with methods to interact with it.

Selenium Python

from selenium.webdriver.common.by import By

class LoginPage:
    def __init__(self, driver):
        self.driver = driver
        self.username_input = (By.ID, "username")
        self.password_input = (By.ID, "password")
        self.login_button = (By.ID, "loginBtn")

    def enter_username(self, username):
        self.driver.find_element(*self.username_input).send_keys(username)

    def enter_password(self, password):
        self.driver.find_element(*self.password_input).send_keys(password)

    def click_login(self):
        self.driver.find_element(*self.login_button).click()

The test uses the LoginPage class to perform login steps clearly.

Selenium Python

def test_login(driver):
    login_page = LoginPage(driver)
    login_page.enter_username("user1")
    login_page.enter_password("pass123")
    login_page.click_login()

Sample Program

This test uses POM to separate page details from test steps. The HomePage class holds locators and actions. The test calls these actions to perform a search.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By

class HomePage:
    def __init__(self, driver):
        self.driver = driver
        self.search_box = (By.NAME, "q")
        self.search_button = (By.NAME, "btnK")

    def enter_search(self, text):
        self.driver.find_element(*self.search_box).send_keys(text)

    def click_search(self):
        self.driver.find_element(*self.search_button).click()

# Test script

def test_google_search():
    driver = webdriver.Chrome()
    driver.get("https://www.google.com")

    home = HomePage(driver)
    home.enter_search("Selenium POM")
    # Normally we would wait here, but for simplicity we just click
    home.click_search()

    print("Search performed successfully")
    driver.quit()

if __name__ == "__main__":
    test_google_search()

Important Notes

Using POM makes tests easier to read and maintain.

If page elements change, update only the page class, not all tests.

Keep locators private inside page classes to avoid duplication.

Summary

POM organizes test code by separating page details from test logic.

This makes tests cleaner, easier to update, and reusable.

It helps teams work together smoothly on test automation.

Practice

1. What is the main reason to use the Page Object Model (POM) in Selenium test automation?

easy

A. To separate page details from test logic for cleaner code

B. To write all test steps in one big script

C. To avoid using locators in tests

D. To run tests faster by skipping waits

Solution

1. Step 1: Understand POM purpose

   POM separates the page structure (locators and actions) from the test logic, making code cleaner.

2. Step 2: Compare options

   Options A, B, and D do not describe POM's main goal. Only To separate page details from test logic for cleaner code correctly states the separation of concerns.

3. Final Answer:

   To separate page details from test logic for cleaner code -> Option A

4. Quick Check:

   POM purpose = Separation of concerns [OK]

Hint: Remember: POM splits page info and test steps [OK]

Common Mistakes:

• Thinking POM speeds up test execution
• Believing POM removes locators completely
• Confusing POM with test data management

2. Which of the following is the correct way to define a locator in a POM class using Selenium with Python?

easy

A. self.login_button = driver.find_element_by_id('login')

B. login_button = ('id', 'login')

C. login_button = (By.ID, 'login')

D. login_button = driver.find_element(By.ID, 'login')

Solution

1. Step 1: Recall POM locator best practice

   In POM, locators are stored as tuples like (By.ID, 'value') without calling find_element immediately.

2. Step 2: Analyze options

   login_button = (By.ID, 'login') correctly defines a locator tuple. Options A and C call find_element directly, which is not best practice. login_button = ('id', 'login') uses a string 'id' instead of By.ID.

3. Final Answer:

   login_button = (By.ID, 'login') -> Option C

4. Quick Check:

   Locator tuple = (By.ID, 'login') [OK]

Hint: Locators in POM are tuples with By.<type> [OK]

Common Mistakes:

• Calling find_element when defining locators
• Using strings instead of By constants
• Storing locators as WebElements instead of tuples

3. Given this POM method in Python:

def click_login(self):
    self.driver.find_element(*self.login_button).click()

What happens if the locator self.login_button is incorrect?

medium

A. The test will pass but skip the click

B. The test will raise a TimeoutException

C. The test will ignore the error and continue

D. The test will fail with NoSuchElementException

Solution

1. Step 1: Understand Selenium behavior on wrong locator

   If the locator is wrong, Selenium cannot find the element and raises NoSuchElementException immediately.

2. Step 2: Check other options

   Options A and C are incorrect because Selenium does not silently skip or ignore missing elements. The test will raise a TimeoutException is wrong because TimeoutException occurs with explicit waits, not direct find_element calls.

3. Final Answer:

   The test will fail with NoSuchElementException -> Option D

4. Quick Check:

   Wrong locator = NoSuchElementException [OK]

Hint: Wrong locator causes NoSuchElementException [OK]

Common Mistakes:

• Confusing NoSuchElementException with TimeoutException
• Thinking Selenium skips missing elements
• Assuming test passes without element

4. You have this POM method:

def enter_username(self, username):
    self.driver.find_element(*self.username_field).send_keys(username)

But tests fail with NoSuchElementException. What is the likely cause?

medium

A. The username argument is None

B. The locator self.username_field is incorrect

C. send_keys method is misspelled

D. The driver is not initialized

Solution

1. Step 1: Analyze the error message

   NoSuchElementException means Selenium cannot find the element, so self.username_field locator is likely incorrect.

2. Step 2: Check other options

   The username argument is None is wrong because that would error after finding the element. send_keys method is misspelled is unlikely as send_keys is standard. The driver is not initialized would cause different errors.

3. Final Answer:

   The locator self.username_field is incorrect -> Option B

4. Quick Check:

   NoSuchElementException = locator wrong [OK]

Hint: NoSuchElementException means locator wrong [OK]

Common Mistakes:

• Blaming input argument for locator error
• Ignoring locator definition
• Assuming driver is always initialized

5. How does using POM help a team when the web page changes its button ID from 'submit' to 'send'?

hard

A. Only the locator in the POM class needs updating, tests remain unchanged

B. All test scripts must be rewritten to use the new ID

C. Tests will fail until the whole framework is rebuilt

D. The change has no effect because POM uses dynamic locators automatically

Solution

1. Step 1: Understand POM's separation advantage

   POM stores locators in one place. Changing a locator means updating only that place.

2. Step 2: Evaluate options

   Only the locator in the POM class needs updating, tests remain unchanged correctly states only the locator in POM needs update. All test scripts must be rewritten to use the new ID is wrong because tests don't need rewriting. Tests will fail until the whole framework is rebuilt exaggerates failure. The change has no effect because POM uses dynamic locators automatically is false; POM does not auto-update locators.

3. Final Answer:

   Only the locator in the POM class needs updating, tests remain unchanged -> Option A

4. Quick Check:

   POM isolates locator changes [OK]

Hint: Update locator once in POM, not all tests [OK]

Common Mistakes:

• Thinking all tests must change
• Believing POM auto-fixes locators
• Assuming framework rebuild is needed