Switching between windows in Selenium Python - Framework Patterns

Framework Mode - Switching between windows

Folder Structure

selenium_project/
├── tests/
│   ├── test_switch_windows.py
│   └── __init__.py
├── pages/
│   ├── base_page.py
│   ├── main_page.py
│   └── popup_page.py
├── utils/
│   ├── driver_factory.py
│   └── window_manager.py
├── config/
│   ├── config.yaml
│   └── __init__.py
├── reports/
│   └── test_report.html
├── conftest.py
└── requirements.txt

Test Framework Layers

• Driver Layer: utils/driver_factory.py creates and manages WebDriver instances.
• Page Objects: pages/ contains classes representing pages, e.g., MainPage and PopupPage, encapsulating element locators and actions.
• Window Manager Utility: utils/window_manager.py handles switching between browser windows or tabs safely.
• Tests: tests/test_switch_windows.py contains test cases that use page objects and utilities to verify window switching behavior.
• Configuration: config/config.yaml stores environment settings like browser type and URLs.
• Test Runner Setup: conftest.py manages fixtures for setup and teardown of tests.
• Reports: reports/ stores test execution reports.

Configuration Patterns

• Environment Settings: Use config/config.yaml to define URLs, browser types (e.g., Chrome, Firefox), and timeouts.
• Credentials: Store sensitive data securely outside the repo or use environment variables accessed in conftest.py.
• Browser Selection: Parameterize browser choice in driver_factory.py to allow running tests on different browsers.
• Window Handles: Use utility functions in window_manager.py to switch windows by handle or title, avoiding hard-coded values.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html to generate readable HTML reports saved in reports/.
• Integrate tests into CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run on every code push.
• Configure CI to run tests in headless mode for faster execution.
• Fail tests if window switching does not work as expected, ensuring reliability.

Best Practices

1. Use Page Object Model: Encapsulate window-related actions in page classes to keep tests clean.
2. Explicit Waits: Wait for new windows or tabs to appear before switching to avoid flaky tests.
3. Window Handle Management: Always store and restore original window handles to maintain test flow.
4. Reusable Utilities: Create helper functions for switching windows by title or index to avoid repeating code.
5. Clear Test Isolation: Close any extra windows after tests to keep environment clean.

Self Check

Where in this folder structure would you add a new utility function to switch to a window by its title?

Key Result

Organize Selenium Python tests with clear layers: driver setup, page objects, utilities for window switching, tests, and config for flexible, maintainable automation.

Practice

1. What does driver.switch_to.window(window_handle) do in Selenium?

easy

A. It closes the current browser window.

B. It changes control to the browser window identified by window_handle.

C. It refreshes the current browser window.

D. It opens a new browser window.

Solution

1. Step 1: Understand the method purpose

   driver.switch_to.window() is used to change Selenium's focus to a different browser window or tab.

2. Step 2: Identify the parameter role

   The parameter window_handle specifies which window Selenium should control next.

3. Final Answer:

   It changes control to the browser window identified by window_handle. -> Option B

4. Quick Check:

   Switching windows = change control [OK]

Hint: Switch windows by passing the window handle to switch_to.window() [OK]

Common Mistakes:

• Thinking it closes or refreshes windows
• Confusing switching with opening new windows
• Not passing a valid window handle

2. Which of the following is the correct syntax to switch to a new window stored in variable new_window?

easy

A. driver.window_switch(new_window)

B. driver.switch_window(new_window)

C. driver.switchTo().window(new_window)

D. driver.switch_to.window(new_window)

Solution

1. Step 1: Recall correct Selenium Python syntax

   The correct method to switch windows is driver.switch_to.window() in Python Selenium.

2. Step 2: Match the syntax with the options

   driver.switch_to.window(new_window) uses the correct method and parameter. Other options use incorrect method names or Java syntax.

3. Final Answer:

   driver.switch_to.window(new_window) -> Option D

4. Quick Check:

   Python Selenium uses switch_to.window() [OK]

Hint: Use driver.switch_to.window(handle) exactly in Python [OK]

Common Mistakes:

• Using Java syntax like switchTo()
• Using incorrect method names
• Missing the switch_to part

3. What will be the output of the following code snippet?

original = driver.current_window_handle
all_windows = driver.window_handles
for w in all_windows:
    if w != original:
        driver.switch_to.window(w)
        print(driver.title)
        break
print(driver.current_window_handle == original)

medium

A. Prints the title of the new window and then prints False

B. Prints the title of the original window and then prints True

C. Throws an error because of wrong window handle usage

D. Prints False twice

Solution

1. Step 1: Understand window handles and switching

   The code saves the original window handle, loops through all windows, and switches to the first window that is not original.

2. Step 2: Analyze the print statements

   Inside the loop, it prints the title of the new window and breaks. After the loop, it compares current window handle with original, which will be False because we switched.

3. Final Answer:

   Prints the title of the new window and then prints False -> Option A

4. Quick Check:

   Switched window title + current handle != original = False [OK]

Hint: Switch changes current handle, so comparison with original is False [OK]

Common Mistakes:

• Assuming current window handle is still original after switch
• Confusing window_handles list with current_window_handle
• Expecting True after switching

4. Identify the error in this code snippet that tries to switch back to the original window:

original = driver.current_window_handle
# code opens new window
new_window = driver.window_handles[1]
driver.switch_to.window(new_window)
# some actions
# switch back
switch_to.window(original)

medium

A. Cannot switch back once switched

B. Using wrong index for new_window

C. Missing 'driver.' before switch_to.window in last line

D. No error, code is correct

Solution

1. Step 1: Check the last line syntax

   The last line calls switch_to.window(original) without the driver. prefix, which causes a NameError.

2. Step 2: Confirm other parts are correct

   Index 1 is valid if two windows exist, switching back is allowed, so no other errors.

3. Final Answer:

   Missing 'driver.' before switch_to.window in last line -> Option C

4. Quick Check:

   Always prefix with driver.switch_to.window() [OK]

Hint: Always use driver.switch_to.window() fully [OK]

Common Mistakes:

• Forgetting 'driver.' before switch_to
• Assuming switch back is automatic
• Using wrong window handle index without checking

5. You have opened multiple tabs during a test. How do you switch back to the original tab after performing actions on others?

hard

A. Store the original window handle before switching, then use driver.switch_to.window(original_handle) to return.

B. Call driver.close() on all other tabs to return automatically.

C. Use driver.switch_to.default_window() to go back to the first tab.

D. Restart the browser to return to the original tab.

Solution

1. Step 1: Save the original window handle

   Before switching tabs, save the current window handle in a variable.

2. Step 2: Switch back using saved handle

   Use driver.switch_to.window(original_handle) to return control to the original tab.

3. Step 3: Evaluate other options

   Closing tabs or restarting browser is inefficient; default_window() does not exist in Selenium Python.

4. Final Answer:

   Store the original window handle before switching, then use driver.switch_to.window(original_handle) to return. -> Option A

5. Quick Check:

   Save handle, then switch back using it [OK]

Hint: Always save original handle to switch back later [OK]

Common Mistakes:

• Trying to use non-existent default_window() method
• Closing tabs instead of switching
• Restarting browser unnecessarily