Handling pop-up windows in Selenium Python

Introduction

Pop-up windows often appear during web testing. Handling them lets you control or close these windows to keep tests running smoothly.

When a website shows a login pop-up window.

When a confirmation alert appears after clicking a button.

When a new browser tab or window opens after a link click.

When testing a form that triggers a pop-up message.

When you need to switch focus between main page and pop-up.

Syntax

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# Switch to alert pop-up
alert = driver.switch_to.alert

# Accept the alert
alert.accept()

# Dismiss the alert
alert.dismiss()

# Get alert text
text = alert.text

# Switch to new window
main_window = driver.current_window_handle
all_windows = driver.window_handles
for window in all_windows:
    if window != main_window:
        driver.switch_to.window(window)
        break

Use driver.switch_to.alert for alert pop-ups like alerts, confirms, prompts.

Use driver.switch_to.window(window_handle) to switch between browser windows or tabs.

Examples

This accepts (clicks OK) on a simple alert pop-up.

Selenium Python

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

This dismisses (clicks Cancel) on a confirmation pop-up.

Selenium Python

alert = driver.switch_to.alert
alert.dismiss()

This switches control to a newly opened browser window or tab.

Selenium Python

main_window = driver.current_window_handle
for window in driver.window_handles:
    if window != main_window:
        driver.switch_to.window(window)
        break

Sample Program

This script opens a test page with JavaScript alerts, clicks a button to open an alert, reads the alert text, accepts it, and prints the alert message.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import time

# Setup driver (make sure chromedriver is in PATH)
service = Service()
driver = webdriver.Chrome(service=service)

try:
    driver.get('https://the-internet.herokuapp.com/javascript_alerts')

    # Click button to trigger alert
    driver.find_element(By.XPATH, '//button[text()="Click for JS Alert"]').click()

    # Wait for alert and accept it
    WebDriverWait(driver, 5).until(EC.alert_is_present())
    alert = driver.switch_to.alert
    alert_text = alert.text
    alert.accept()

    print(f"Alert text was: {alert_text}")

finally:
    time.sleep(2)  # Pause to see result
    driver.quit()

Important Notes

Always wait for the alert to appear before switching to it to avoid errors.

After handling a pop-up, switch back to the main window if needed.

Pop-ups can be alerts, confirms, prompts, or new browser windows/tabs.

Summary

Pop-up windows need special handling to interact with them during tests.

Use driver.switch_to.alert for alerts and driver.switch_to.window() for new windows.

Always wait for pop-ups before interacting to avoid test failures.

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