Switching between windows in Selenium Java - Test Execution Trace

Test Overview

This test opens a webpage, clicks a link that opens a new window, switches to the new window, verifies its title, then switches back to the original window and verifies its title.

Test Code - JUnit 5 with Selenium WebDriver

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.junit.jupiter.api.*;
import java.util.Set;

public class WindowSwitchTest {
    WebDriver driver;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
        driver.get("https://example.com");
    }

    @Test
    public void testSwitchBetweenWindows() {
        String originalWindow = driver.getWindowHandle();

        driver.findElement(By.id("open-new-window")).click();

        Set<String> allWindows = driver.getWindowHandles();
        for (String windowHandle : allWindows) {
            if (!windowHandle.equals(originalWindow)) {
                driver.switchTo().window(windowHandle);
                break;
            }
        }

        Assertions.assertEquals("New Window Title", driver.getTitle());

        driver.close();

        driver.switchTo().window(originalWindow);

        Assertions.assertEquals("Original Window Title", driver.getTitle());
    }

    @AfterEach
    public void tearDown() {
        driver.quit();
    }
}

Execution Trace - 7 Steps

Step	Action	System State	Assertion	Result
1	Test starts and Chrome browser opens the URL https://example.com	Browser shows the original page with title 'Original Window Title' and a button with id 'open-new-window'	—	PASS
2	Find element with id 'open-new-window' and click it	A new browser window opens alongside the original window	—	PASS
3	Get all window handles and switch to the new window (not the original)	Driver context is now the new window	—	PASS
4	Check the title of the new window	New window is visible with title 'New Window Title'	Assert that title equals 'New Window Title'	PASS
5	Close the new window	New window closes, original window remains open	—	PASS
6	Switch back to the original window	Driver context is back to original window	—	PASS
7	Check the title of the original window	Original window is visible with title 'Original Window Title'	Assert that title equals 'Original Window Title'	PASS

Failure Scenario

Failing Condition: The new window does not open or the window handle is not found

Execution Trace Quiz - 3 Questions

What does the test do immediately after clicking the element with id 'open-new-window'?

A It switches to the new window using its window handle

B It closes the original window

C It refreshes the current page

D It asserts the title of the original window

Key Result

Always store the original window handle before opening a new window so you can switch back reliably after testing the new window.

Practice

1. What does the getWindowHandle() method return in Selenium WebDriver?

easy

A. The unique ID of the current browser window or tab

B. A list of all open browser windows or tabs

C. The title of the current browser window

D. The URL of the current page

Solution

1. Step 1: Understand getWindowHandle() purpose

   This method returns a unique string ID representing the current window or tab the driver is controlling.

2. Step 2: Differentiate from getWindowHandles()

   Unlike getWindowHandles(), which returns all window IDs, getWindowHandle() returns only the current one.

3. Final Answer:

   The unique ID of the current browser window or tab -> Option A

4. Quick Check:

   getWindowHandle() = current window ID [OK]

Hint: Remember: singular handle = current window only [OK]

Common Mistakes:

• Confusing getWindowHandle() with getWindowHandles()
• Thinking it returns window title or URL
• Assuming it returns multiple windows

2. Which of the following is the correct syntax to switch to a new window using its handle in Selenium Java?

easy

A. driver.switchToWindowHandle(windowHandle);

B. driver.switchToWindow(windowHandle);

C. driver.switchTo().window(windowHandle);

D. driver.switch.window(windowHandle);

Solution

1. Step 1: Recall correct switch syntax

   The correct method chain is driver.switchTo().window(handle) to switch focus to a window by its handle.

2. Step 2: Identify incorrect options

   Options A, B, and C use invalid method names or chaining not supported by Selenium WebDriver API.

3. Final Answer:

   driver.switchTo().window(windowHandle); -> Option C

4. Quick Check:

   Use switchTo().window() to switch windows [OK]

Hint: Use driver.switchTo().window(handle) always [OK]

Common Mistakes:

• Using incorrect method names like switchToWindow()
• Missing the switchTo() part before window()
• Trying to call window() directly on driver

3. Consider the following code snippet:

String mainWindow = driver.getWindowHandle();
Set<String> allWindows = driver.getWindowHandles();
for (String window : allWindows) {
    if (!window.equals(mainWindow)) {
        driver.switchTo().window(window);
        driver.close();
    }
}
driver.switchTo().window(mainWindow);
System.out.println(driver.getTitle());

What will this code do?

medium

A. Close all windows including the main one and throw an error

B. Close all windows except the main one and print the main window's title

C. Close only the main window and print the last window's title

D. Switch to the last window and print its title without closing any window

Solution

1. Step 1: Analyze window handles and loop

   The code saves the main window handle, loops through all windows, and closes any window not equal to mainWindow.

2. Step 2: Switch back and print title

   After closing other windows, it switches back to mainWindow and prints its title.

3. Final Answer:

   Close all windows except the main one and print the main window's title -> Option B

4. Quick Check:

   Close others, keep main, print main title [OK]

Hint: Close non-main windows, then switch back [OK]

Common Mistakes:

• Closing main window inside the loop
• Not switching back to main window before printing title
• Assuming all windows are closed

4. Identify the error in this Selenium Java code snippet for switching to a new window:

Set<String> windows = driver.getWindowHandles();
for (String win : windows) {
    if (win != driver.getWindowHandle()) {
        driver.switchTo().window(win);
        break;
    }
}

medium

A. Using '!=' to compare strings instead of .equals()

B. Missing driver.quit() after switching windows

C. Not closing the previous window before switching

D. Using getWindowHandles() instead of getWindowHandle()

Solution

1. Step 1: Check string comparison method

   In Java, strings must be compared with .equals(), not '!=' which compares references.

2. Step 2: Identify impact of wrong comparison

   Using '!=' may cause the condition to fail unexpectedly, so the switch may not happen correctly.

3. Final Answer:

   Using '!=' to compare strings instead of .equals() -> Option A

4. Quick Check:

   Use .equals() for string comparison [OK]

Hint: Always use .equals() to compare strings in Java [OK]

Common Mistakes:

• Using '==' or '!=' for string comparison
• Forgetting to break after switching
• Confusing getWindowHandle() and getWindowHandles()

5. You have a test that opens multiple tabs. You want to switch to the tab with title "Dashboard" and perform actions there. Which approach correctly switches to that window?

hard

A. Close all windows except the first, then assume it is "Dashboard"

B. Use driver.switchTo().window("Dashboard"); directly with the title

C. Call driver.getWindowHandle() repeatedly until title is "Dashboard"

D. Iterate all window handles, switch to each, check title, break when title matches "Dashboard"

Solution

1. Step 1: Understand window switching by handle

   You cannot switch windows by title directly; you must switch by handle and then check the title.

2. Step 2: Iterate handles and check titles

   Loop through all window handles, switch to each, check if title equals "Dashboard", then break to stay on that window.

3. Final Answer:

   Iterate all window handles, switch to each, check title, break when title matches "Dashboard" -> Option D

4. Quick Check:

   Switch by handle, check title, then stop [OK]

Hint: Switch windows by handle, verify title, then stop [OK]

Common Mistakes:

• Trying to switch using title as window handle
• Not looping through all windows
• Assuming first window is always the target