Why Handling multiple pages in Selenium Python? - Purpose & Use Cases

The Big Idea

What if your tests could juggle many pages without dropping a single check?

The Scenario

Imagine you are testing a website where clicking a link opens a new tab or window. You want to check if the new page shows the right content. Doing this by switching windows manually in your browser is like juggling many balls at once.

The Problem

Manually switching between pages is slow and easy to mess up. You might check the wrong page or forget to go back. This wastes time and causes mistakes, especially when many pages open during testing.

The Solution

Using automated tools like Selenium lets you switch between pages smoothly in your test code. You can tell the test exactly which page to check and when to switch back. This makes testing faster, clearer, and less error-prone.

Before vs After

✗ Before

driver.get('page1_url')
# Manually switch to new tab
# Check content
# Switch back manually

✓ After

driver.get('page1_url')
main_window = driver.current_window_handle
# Click link that opens new tab
new_window = [w for w in driver.window_handles if w != main_window][0]
driver.switch_to.window(new_window)
# Check content
driver.close()
driver.switch_to.window(main_window)

What It Enables

It enables automated tests to handle multiple pages or tabs seamlessly, just like a skilled juggler managing many balls without dropping any.

Real Life Example

Testing an online store where clicking product details opens a new tab. You want to verify the product info on the new tab and then return to the main page to continue shopping.

Key Takeaways

Manual page switching is slow and error-prone.

Automated handling of multiple pages makes tests reliable and fast.

It helps test real user flows involving new tabs or windows easily.

Practice

1. What does driver.window_handles return in Selenium?

easy

A. The URL of the current page

B. The current active window handle only

C. The title of the current page

D. A list of all open browser window handles

Solution

1. Step 1: Understand what window handles represent

   Window handles are unique IDs for each open browser window or tab.

2. Step 2: Identify what driver.window_handles returns

   This property returns a list of all window handles currently opened by the driver.

3. Final Answer:

   A list of all open browser window handles -> Option D

4. Quick Check:

   window_handles = list of all windows [OK]

Hint: Remember: window_handles lists all open pages [OK]

Common Mistakes:

• Confusing window_handles with current window handle
• Expecting window_handles to return page titles or URLs
• Using window_handles as a single string instead of a list

2. Which is the correct syntax to switch to a new browser tab in Selenium Python?

easy

A. driver.switch_to_tab(driver.window_handles[1])

B. driver.switch_window(driver.window_handles[1])

C. driver.switch_to.window(driver.window_handles[1])

D. driver.change_window(driver.window_handles[1])

Solution

1. Step 1: Recall the correct method to switch windows

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

2. Step 2: Check the syntax for switching to the second tab

   Use the second handle in the list: driver.window_handles[1].

3. Final Answer:

   driver.switch_to.window(driver.window_handles[1]) -> Option C

4. Quick Check:

   Use switch_to.window with window_handles index [OK]

Hint: Use switch_to.window() with window_handles index [OK]

Common Mistakes:

• Using non-existent methods like switch_window or switch_to_tab
• Forgetting to use driver.switch_to
• Using wrong index for window_handles

3. What will the following code print if two tabs are open and the first tab's title is 'Home' and second tab's title is 'About'?

main_window = driver.current_window_handle
all_windows = driver.window_handles
for window in all_windows:
    driver.switch_to.window(window)
    print(driver.title)

medium

A. ["Home", "About"]

B. ["About", "Home"]

C. Only "Home"

D. Only "About"

Solution

1. Step 1: Understand the loop over all window handles

   The code loops over all open windows and switches to each one in order.

2. Step 2: Print the title of each window after switching

   It prints the title of each tab in the order of window_handles list, which is usually the order tabs opened.

3. Final Answer:

   ["Home", "About"] -> Option A

4. Quick Check:

   Loop prints titles of all tabs in order [OK]

Hint: Loop over window_handles prints all tab titles [OK]

Common Mistakes:

• Assuming only current tab title prints
• Mixing order of window handles
• Not switching before printing title

4. Identify the error in this code snippet that tries to switch back to the main window after opening a new tab:

main_window = driver.current_window_handle
# code to open new tab
driver.switch_to.window(driver.window_handles[1])
# do something
# switch back
driver.switch_to.window(main_window())

medium

A. Missing import for switch_to

B. main_window is called like a function with parentheses

C. driver.window_handles[1] is invalid index

D. No error, code is correct

Solution

1. Step 1: Check how main_window is used

   main_window is a string handle, but code calls main_window() as a function, which is incorrect.

2. Step 2: Identify correct usage to switch back

   Should use driver.switch_to.window(main_window) without parentheses.

3. Final Answer:

   main_window is called like a function with parentheses -> Option B

4. Quick Check:

   Window handle is a string, not a function [OK]

Hint: Window handles are strings, don't add () [OK]

Common Mistakes:

• Calling window handle variables as functions
• Using wrong index for window_handles
• Assuming switch_to needs import

5. You open multiple tabs during a test. How do you ensure you always return to the original tab after closing the new ones?

hard

A. Save the original window handle before opening new tabs and switch back using it

B. Use driver.close() on all tabs except the last one

C. Call driver.quit() to close all tabs and restart the browser

D. Switch to the last window handle in driver.window_handles list

Solution

1. Step 1: Save the original window handle before opening new tabs

   This allows you to remember which tab was the main one.

2. Step 2: After closing new tabs, switch back to the saved original handle

   Use driver.switch_to.window(original_handle) to return safely.

3. Final Answer:

   Save the original window handle before opening new tabs and switch back using it -> Option A

4. Quick Check:

   Save and reuse original handle to return [OK]

Hint: Always save main window handle before opening tabs [OK]

Common Mistakes:

• Assuming last window handle is original
• Closing tabs without switching back
• Using driver.quit() which ends session