Window size control in Selenium Python - Framework Patterns

Framework Mode - Window size control

Folder Structure

selenium_python_project/
├── src/
│   ├── pages/
│   │   └── base_page.py
│   ├── tests/
│   │   └── test_window_size.py
│   ├── utils/
│   │   └── window_manager.py
│   └── config/
│       └── config.yaml
├── requirements.txt
└── pytest.ini

Test Framework Layers

• Driver Layer: Manages Selenium WebDriver setup and teardown, including browser options.
• Page Objects: Classes representing web pages; base_page.py includes common methods like window size control.
• Tests: Test scripts using pytest, e.g., test_window_size.py tests window resizing behavior.
• Utilities: Helper modules like window_manager.py to encapsulate window size control logic.
• Configuration: config.yaml stores environment settings, browser preferences, and window size parameters.

Configuration Patterns

• Environment Settings: Use config.yaml to define URLs, browser types, and default window sizes.
• Browser Options: Configure browser window size via WebDriver options or commands in setup.
• Credentials: Store securely outside code, e.g., environment variables or encrypted files (not shown here for simplicity).
• Window Size Control: Define window width and height in config to allow easy changes without code edits.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html to generate readable test reports showing pass/fail results.
• Integrate tests in CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run window size tests on multiple browsers and screen sizes automatically.
• Reports help quickly identify if window resizing or responsive behavior breaks.
• Logs include window size commands and results for debugging.

Best Practices

• Use Page Object Model: Put window size control methods in a base page class to reuse across pages.
• Explicit Window Size Control: Always set window size explicitly in tests to avoid flaky behavior from default sizes.
• Configurable Sizes: Keep window sizes in config files to test different screen resolutions easily.
• Utility Functions: Encapsulate window resizing logic in utility modules for clarity and reuse.
• Clean Setup and Teardown: Reset window size after tests if needed to avoid side effects.

Self Check

Where in this folder structure would you add a new utility function to maximize the browser window?

Key Result

Organize Selenium Python tests with clear layers and config to control browser window size reliably.