Back, forward, and refresh in Selenium Python - Framework Patterns

Framework Mode - Back, forward, and refresh

Folder Structure

selenium_python_project/
├── src/
│   ├── pages/
│   │   ├── __init__.py
│   │   ├── base_page.py
│   │   └── navigation_page.py
│   ├── tests/
│   │   ├── __init__.py
│   │   └── test_navigation.py
│   ├── utils/
│   │   ├── __init__.py
│   │   └── driver_factory.py
│   └── config/
│       ├── __init__.py
│       └── settings.py
├── requirements.txt
└── pytest.ini
    

Test Framework Layers

• Driver Layer: Manages browser setup and teardown (e.g., driver_factory.py creates WebDriver instances).
• Page Objects: Encapsulate page elements and actions, including navigation methods like back, forward, and refresh (navigation_page.py).
• Tests: Test scripts that use page objects to perform actions and assertions (test_navigation.py).
• Utilities: Helper functions and reusable code (e.g., waits, logging).
• Configuration: Stores environment settings, browser options, and credentials (settings.py).

Configuration Patterns

Use a settings.py file to manage environment variables like base URLs and browser types. Example:

class Config:
    BASE_URL = "https://example.com"
    BROWSER = "chrome"  # or "firefox"
    IMPLICIT_WAIT = 10

# Load config in driver factory to initialize WebDriver accordingly
    

Use environment variables or command-line options to switch environments or browsers without changing code.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html or allure-pytest for readable HTML reports.
• Integrate tests into CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run tests on code changes automatically.
• Reports include pass/fail status of navigation tests using back, forward, and refresh commands.

Best Practices

• Use Page Object Model: Encapsulate back, forward, and refresh actions in page objects to keep tests clean.
• Explicit Waits: Use waits after navigation commands to ensure page loads before assertions.
• Isolate Tests: Each test should start from a known state to avoid flaky results when using browser navigation.
• Configurable Browsers: Allow switching browsers in config to test navigation behavior across browsers.
• Clear Naming: Name test methods clearly to indicate navigation actions being tested.

Self Check

Where in this folder structure would you add a new method to refresh the current page?

Answer: In the navigation_page.py file inside the src/pages/ folder, as part of the page object methods.

Key Result

Organize Selenium Python tests with clear layers: driver setup, page objects for navigation, tests, utilities, and config for flexible back, forward, and refresh actions.