Why Base page class in Selenium Python? - Purpose & Use Cases

The Big Idea

What if you could fix all your test code bugs by changing just one place?

The Scenario

Imagine testing a website with many pages. Each page has buttons, links, and forms. You write separate code for each page to find and click elements. When the website changes, you must update all your code everywhere.

The Problem

This manual way is slow and tiring. You repeat the same code again and again. If a button locator changes, you hunt through many files to fix it. Mistakes happen easily, and tests break often.

The Solution

A base page class solves this by holding common code for all pages. You write shared actions once, like clicking or typing. Each page class inherits from it and adds only unique parts. When locators change, fix them in one place.

Before vs After

✗ Before

def click_login_button(driver):
    driver.find_element_by_id('login').click()

def click_logout_button(driver):
    driver.find_element_by_id('logout').click()

✓ After

class BasePage:
    def __init__(self, driver):
        self.driver = driver
    def click(self, locator):
        self.driver.find_element(*locator).click()

class LoginPage(BasePage):
    login_button = ('id', 'login')
    def click_login(self):
        self.click(self.login_button)

What It Enables

It enables writing cleaner, faster, and easier-to-maintain test code that adapts smoothly to website changes.

Real Life Example

Think of a delivery app with many screens. Using a base page class, testers update button locators once, and all tests keep working without extra effort.

Key Takeaways

Manual test code repeats and breaks easily.

Base page class holds shared actions and locators.

It makes tests simpler, faster to fix, and more reliable.