Handling pop-up windows in Selenium Python - Framework Patterns

Framework Mode - Handling pop-up windows

Folder Structure

my_selenium_project/
├── src/
│   ├── pages/
│   │   ├── base_page.py
│   │   ├── main_page.py
│   │   └── popup_page.py
│   ├── tests/
│   │   ├── test_main_page.py
│   │   └── test_popup_handling.py
│   ├── utils/
│   │   ├── driver_factory.py
│   │   └── wait_utils.py
│   └── config/
│       ├── config.yaml
│       └── credentials.yaml
├── reports/
│   └── test_report.html
├── requirements.txt
└── pytest.ini

Test Framework Layers

• Driver Layer: driver_factory.py creates and manages WebDriver instances with browser options.
• Page Objects: Classes in pages/ represent web pages and pop-ups, encapsulating locators and actions (e.g., popup_page.py handles pop-up window interactions).
• Test Layer: Test scripts in tests/ use page objects to perform test scenarios, including pop-up handling.
• Utilities: Helper functions like explicit waits in wait_utils.py to handle timing and synchronization.
• Configuration: YAML files in config/ store environment settings, browser choices, and credentials.

Configuration Patterns

• Environment Settings: Use config.yaml to define URLs and environment-specific data (dev, staging, prod).
• Browser Selection: Pass browser type (e.g., Chrome, Firefox) via command line or config file to driver_factory.py.
• Credentials: Store sensitive data like usernames and passwords securely in credentials.yaml, excluded from version control.
• Pop-up Handling Settings: Timeout values for waiting on pop-ups can be configured in config.yaml for flexibility.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html to generate readable HTML test reports saved in reports/.
• Integrate tests into CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run tests automatically on code changes.
• Configure CI to run tests in headless mode for pop-up handling to simulate real user scenarios without UI.
• Reports include pass/fail status, screenshots on failure, and logs for pop-up window interactions.

Best Practices for Handling Pop-up Windows

1. Use Explicit Waits: Always wait explicitly for pop-up windows or alerts to appear before interacting to avoid flaky tests.
2. Switch Context Properly: Use Selenium's driver.switch_to.window() or driver.switch_to.alert() to interact with pop-ups.
3. Encapsulate Pop-up Logic: Create dedicated page objects or helper methods for pop-up handling to keep tests clean and reusable.
4. Close Pop-ups Cleanly: Always close or accept pop-ups after interaction to return to the main window and avoid test interference.
5. Handle Unexpected Pop-ups: Implement global handlers or try-except blocks to manage unexpected alerts gracefully.

Self Check

Where in this folder structure would you add a new page object class to handle a confirmation pop-up window?

Key Result

Organize Selenium Python tests with clear layers: driver setup, page objects including pop-ups, tests, utilities, and config for robust pop-up handling.

Practice

1. What is the correct way to switch to a browser alert pop-up in Selenium with Python?

easy

A. driver.switch_to.window('alert')

B. driver.switch_to.alert

C. driver.switch_to.frame('alert')

D. driver.switch_to.default_content()

Solution

1. Step 1: Understand alert handling in Selenium

   Alerts are special pop-ups that require switching to alert context using driver.switch_to.alert.

2. Step 2: Identify the correct method to switch

   Using driver.switch_to.alert accesses the alert object directly, allowing interaction.

3. Final Answer:

   driver.switch_to.alert -> Option B

4. Quick Check:

   Alert pop-up switch = driver.switch_to.alert [OK]

Hint: Use driver.switch_to.alert for alerts, not window or frame [OK]

Common Mistakes:

• Using switch_to.window for alerts
• Trying to switch to alert as a frame
• Not switching before interacting with alert

2. Which of the following is the correct syntax to switch to a new browser window by its handle in Selenium Python?

easy

A. driver.switch_to.alert(window_handle)

B. driver.switch_to.default_content(window_handle)

C. driver.switch_to.frame(window_handle)

D. driver.switch_to.window(window_handle)

Solution

1. Step 1: Recall method to switch windows

   To switch to a new browser window, use driver.switch_to.window() with the window handle.

2. Step 2: Confirm correct syntax

   The method requires the window handle string as an argument, so driver.switch_to.window(window_handle) is correct.

3. Final Answer:

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

4. Quick Check:

   Switch window syntax = driver.switch_to.window(handle) [OK]

Hint: Use switch_to.window(handle) to change browser tabs/windows [OK]

Common Mistakes:

• Using switch_to.alert for windows
• Passing window handle to switch_to.frame
• Omitting the window handle argument

3. Given the following code snippet, what will be printed?

driver.get('https://example.com')
main_window = driver.current_window_handle
# Assume clicking button opens a new window
button = driver.find_element('id', 'openWindow')
button.click()
all_windows = driver.window_handles
for handle in all_windows:
    if handle != main_window:
        driver.switch_to.window(handle)
        print(driver.title)
        driver.close()
        break

# Switch back to main window
driver.switch_to.window(main_window)
print(driver.title)

medium

A. Title of new window followed by title of main window

B. Only title of main window printed twice

C. Only title of new window printed

D. No output due to error

Solution

1. Step 1: Understand window switching and closing

   The code clicks a button that opens a new window, then switches to it, prints its title, closes it, and breaks the loop.

2. Step 2: Switch back and print main window title

   After closing the new window, the code switches back to the main window and prints its title.

3. Final Answer:

   Title of new window followed by title of main window -> Option A

4. Quick Check:

   Print new window title, then main window title [OK]

Hint: Switch to new window, print title, close, then switch back [OK]

Common Mistakes:

• Not switching back to main window before printing
• Trying to print after closing main window
• Assuming both titles print simultaneously

4. Identify the error in the following Selenium Python code for handling an alert pop-up:

alert = driver.switch_to.alert()
alert.accept()

medium

A. Incorrect use of parentheses after switch_to.alert

B. Missing import for Alert class

C. alert.accept() should be alert.dismiss()

D. No error, code is correct

Solution

1. Step 1: Check method usage for alert switching

   driver.switch_to.alert is a property, not a method, so it should not have parentheses.

2. Step 2: Correct the syntax

   Remove parentheses: use alert = driver.switch_to.alert to get the alert object.

3. Final Answer:

   Incorrect use of parentheses after switch_to.alert -> Option A

4. Quick Check:

   switch_to.alert is property, no () [OK]

Hint: Don't add () after switch_to.alert, it's a property [OK]

Common Mistakes:

• Adding parentheses after switch_to.alert
• Confusing accept() with dismiss()
• Not switching to alert before accepting

5. You have a test that opens multiple pop-up windows in sequence. Which approach correctly handles switching to each new window, closing it, and returning to the main window without errors?

hard

A. Store main window handle, loop through all handles, switch to each new window, close it, then switch back to main window after loop

B. Switch to each window and close it inside the loop, then switch back to main window after closing all windows

C. Switch to each new window, close it immediately, and switch back to main window inside the loop after each close

D. Close main window first, then switch to new windows one by one

Solution

1. Step 1: Save main window handle before opening pop-ups

   Store the main window handle to return to it later safely.

2. Step 2: Loop through all window handles, switch, close, and return

   For each new window, switch to it, close it, then switch back to main window inside the loop to avoid stale window errors.

3. Step 3: Avoid closing main window before others

   Closing the main window first causes errors; it should be closed last or not at all during pop-up handling.

4. Final Answer:

   Switch to each new window, close it immediately, and switch back to main window inside the loop after each close -> Option C

5. Quick Check:

   Switch-close-switch back per window to avoid errors [OK]

Hint: Switch-close-switch back inside loop for each pop-up [OK]

Common Mistakes:

• Closing main window before others
• Switching back only after closing all pop-ups
• Not storing main window handle before loop