Switching between windows in Selenium Java - Framework Patterns

Framework Mode - Switching between windows

Folder Structure

src/
└── test/
    └── java/
        └── com/
            └── example/
                ├── pages/
                │   ├── BasePage.java
                │   ├── HomePage.java
                │   └── NewWindowPage.java
                ├── tests/
                │   └── WindowSwitchTest.java
                ├── utils/
                │   └── WindowManager.java
                └── config/
                    └── TestConfig.java

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown (e.g., WebDriverFactory class).
• Page Objects: Classes representing pages/windows (e.g., HomePage, NewWindowPage) with methods to interact with UI elements.
• Window Manager Utility: Helper class (WindowManager) to handle switching between browser windows or tabs safely.
• Tests: Test classes (WindowSwitchTest) containing test methods that use page objects and utilities to perform window switching scenarios.
• Configuration: Centralized config (TestConfig) for environment URLs, browser types, timeouts, and credentials.

Configuration Patterns

• Environment Properties: Use a properties file or Java class (TestConfig) to store URLs for different environments (dev, staging, prod).
• Browser Selection: Parameterize browser choice via system properties or config files to run tests on Chrome, Firefox, etc.
• Timeouts: Define implicit and explicit wait times centrally to handle dynamic page loads and window switching delays.
• Credentials: Store sensitive data securely outside source code, inject at runtime or use environment variables.

Test Reporting and CI/CD Integration

• TestNG Reports: Use TestNG's built-in HTML reports to show test pass/fail status including window switching tests.
• Logging: Add logs in WindowManager and tests to trace window handles and switching actions for easier debugging.
• CI/CD: Integrate with Jenkins or GitHub Actions to run tests on code commits, with reports archived and notifications sent.
• Screenshots: Capture screenshots on test failures, especially after window switches, to help identify UI issues.

Best Practices

1. Use Page Object Model: Encapsulate window-specific actions in page classes to keep tests clean and maintainable.
2. Explicit Waits for Windows: Use explicit waits to wait for new window handles before switching to avoid flaky tests.
3. Window Handle Management: Store original window handle before opening new windows and switch back after test steps.
4. Utility Methods: Create reusable methods in WindowManager for switching by title, handle, or index to simplify test code.
5. Clean Up: Close extra windows after tests to avoid resource leaks and keep test environment stable.

Self Check

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

Key Result

Organize Selenium Java tests with page objects, utilities for window switching, and centralized config for clean, maintainable automation.

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