Why multi-window scenarios need switching in Selenium Python - Framework Benefits

Framework Mode - Why multi-window scenarios need switching

Folder Structure

selenium_project/
├── tests/
│   ├── test_multi_window.py
│   └── test_login.py
├── pages/
│   ├── base_page.py
│   ├── main_page.py
│   └── popup_page.py
├── utils/
│   ├── driver_factory.py
│   └── window_manager.py
├── config/
│   └── config.yaml
└── requirements.txt
    

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown (e.g., driver_factory.py).
• Page Objects: Encapsulate page elements and actions (base_page.py, main_page.py, popup_page.py).
• Window Manager Utility: Handles switching between browser windows or tabs (window_manager.py).
• Tests: Test scripts that use page objects and utilities to perform actions and assertions (test_multi_window.py).
• Configuration: Stores environment settings, URLs, and credentials (config.yaml).

Configuration Patterns

Use a YAML file (config/config.yaml) to store environment URLs, browser types, and user credentials. Load these settings in driver_factory.py to initialize WebDriver accordingly.

Example snippet from config.yaml:

environment:
  url: "https://example.com"
browser: "chrome"
credentials:
  username: "testuser"
  password: "password123"
    

Test Reporting and CI/CD Integration

Use pytest with plugins like pytest-html to generate readable HTML reports after test runs.

Integrate tests into CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run tests automatically on code changes.

Reports show which tests passed or failed, including multi-window scenario tests.

Best Practices for Multi-Window Handling

• Always switch to the correct window handle: Selenium controls one window at a time. You must switch to the new window to interact with it.
• Use explicit waits: Wait for the new window to appear before switching to avoid errors.
• Encapsulate window switching logic: Put window switching code in a utility like window_manager.py for reuse and clarity.
• Close windows properly: Close popup windows and switch back to the main window to keep tests clean.
• Keep tests readable: Use page objects and clear method names to show when switching happens.

Self Check

Where in this framework structure would you add a new method to switch to a popup window that opens after clicking a button?

Key Result

Switching windows is essential because Selenium controls one window at a time; managing window handles ensures correct interaction in multi-window scenarios.