Nested frames in Selenium Java - Build an Automation Script

Verify text inside nested frames

Preconditions (2)

Step 1: Open the web page with nested frames

Step 2: Switch to the outer frame by its name or ID 'frame1'

Step 3: Within the outer frame, switch to the inner frame by its name or ID 'frame2'

Step 4: Locate the paragraph element with id 'nestedText' inside the inner frame

Step 5: Verify that the text of this paragraph is exactly 'Nested Frame Content'

Step 6: Switch back to the default content

✅ Expected Result: The paragraph inside the nested frame contains the text 'Nested Frame Content' and the test completes without errors.

Automation Requirements - Selenium WebDriver with Java

Assertions Needed:

Verify the paragraph text inside the nested frame matches 'Nested Frame Content'

Best Practices:

Use explicit waits to ensure frames and elements are available before switching or interacting

Use By.id or By.name locators for frames and elements for better reliability

Switch back to default content after frame interactions

Handle NoSuchFrameException and NoSuchElementException gracefully

Automated Solution

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
import org.openqa.selenium.NoSuchFrameException;
import org.openqa.selenium.NoSuchElementException;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;
import java.time.Duration;

public class NestedFramesTest {
    private WebDriver driver;
    private WebDriverWait wait;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
        wait = new WebDriverWait(driver, Duration.ofSeconds(10));
    }

    @Test
    public void testNestedFrameText() {
        driver.get("https://example.com/nested_frames_page");

        try {
            // Wait for outer frame and switch
            wait.until(ExpectedConditions.frameToBeAvailableAndSwitchToIt(By.name("frame1")));

            // Wait for inner frame and switch
            wait.until(ExpectedConditions.frameToBeAvailableAndSwitchToIt(By.name("frame2")));

            // Wait for paragraph element inside inner frame
            WebElement nestedText = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("nestedText")));

            // Assert the text content
            assertEquals("Nested Frame Content", nestedText.getText(), "Text inside nested frame did not match.");

        } catch (NoSuchFrameException e) {
            throw new AssertionError("Frame not found: " + e.getMessage());
        } catch (NoSuchElementException e) {
            throw new AssertionError("Element not found inside frame: " + e.getMessage());
        } finally {
            // Switch back to default content
            driver.switchTo().defaultContent();
        }
    }

    @AfterEach
    public void tearDown() {
        if (driver != null) {
            driver.quit();
        }
    }
}

This test opens the web page with nested frames.

It waits explicitly for the outer frame named 'frame1' to be available and switches to it.

Then it waits for the inner frame named 'frame2' inside the outer frame and switches to it.

Inside the inner frame, it waits for the paragraph element with id 'nestedText' to be visible.

It asserts that the text of this paragraph exactly matches 'Nested Frame Content'.

Finally, it switches back to the main page content to avoid side effects for other tests.

Setup and teardown methods initialize and close the browser properly.

Explicit waits ensure the frames and elements are ready before interacting, preventing flaky tests.

Common Mistakes - 4 Pitfalls

Not switching back to the default content after working inside frames

Using Thread.sleep() instead of explicit waits

Using incorrect or brittle locators like absolute XPath for frames

Not handling exceptions like NoSuchFrameException

Bonus Challenge

Now add data-driven testing with 3 different nested frame URLs and expected texts

Show Hint

Practice

1. What is the correct way to switch to a nested frame in Selenium WebDriver using Java?

easy

A. Use driver.switchTo().frame() step-by-step for each frame level.

B. Use driver.switchTo().defaultContent() to enter nested frames directly.

C. Use driver.switchTo().parentFrame() to jump directly to the innermost frame.

D. Use driver.switchTo().window() to switch between nested frames.

Solution

1. Step 1: Understand frame switching

   To access nested frames, Selenium requires switching into each frame one by one using switchTo().frame().

2. Step 2: Confirm correct method usage

   defaultContent() returns to the main page, parentFrame() goes up one level, and window() switches browser windows, not frames.

3. Final Answer:

   Use driver.switchTo().frame() step-by-step for each frame level. -> Option A

4. Quick Check:

   Step-by-step frame switching = C [OK]

Hint: Switch frames one by one using switchTo().frame() [OK]

Common Mistakes:

• Trying to switch directly to nested frame with defaultContent()
• Using window() instead of frame() for frames
• Confusing parentFrame() with entering nested frames

2. Which of the following is the correct syntax to switch to a frame named "frame1" in Selenium Java?

easy

A. driver.switchTo().frame(frame1);

B. driver.switchTo().frame("frame1");

C. driver.switchTo().frame['frame1'];

D. driver.switchTo().frame{frame1};

Solution

1. Step 1: Identify correct method signature

   The frame() method accepts a String for frame name/id, so it must be in quotes.

2. Step 2: Check syntax correctness

   Only driver.switchTo().frame("frame1"); uses correct Java syntax with double quotes and parentheses.

3. Final Answer:

   driver.switchTo().frame("frame1"); -> Option B

4. Quick Check:

   Correct syntax uses quotes and parentheses = A [OK]

Hint: Use quotes around frame name in frame() method [OK]

Common Mistakes:

• Omitting quotes around frame name
• Using square brackets or curly braces instead of parentheses
• Passing variable without declaration

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

driver.switchTo().frame("outerFrame");
driver.switchTo().frame("innerFrame");
String text = driver.findElement(By.id("message")).getText();
System.out.println(text);

Assuming the element with id "message" inside "innerFrame" contains "Hello Nested Frames".

medium

A. "Hello Nested Frames"

B. NoSuchElementException

C. Empty string

D. StaleElementReferenceException

Solution

1. Step 1: Switch to outer then inner frame

   The code correctly switches first to "outerFrame", then to "innerFrame" where the element exists.

2. Step 2: Locate element and get text

   Since the element with id "message" is inside "innerFrame", getText() returns "Hello Nested Frames".

3. Final Answer:

   "Hello Nested Frames" -> Option A

4. Quick Check:

   Correct frame switching finds element text = D [OK]

Hint: Switch frames stepwise to access nested elements [OK]

Common Mistakes:

• Not switching to inner frame before accessing element
• Trying to find element in default content
• Confusing exception types

4. What is wrong with the following Selenium Java code snippet when trying to access an element inside a nested frame?

driver.switchTo().frame("innerFrame");
String text = driver.findElement(By.id("msg")).getText();

medium

A. The frame name should be passed as a WebElement, not a String.

B. No need to switch frames to access elements inside frames.

C. The element locator By.id("msg") is invalid syntax.

D. It misses switching to the parent frame before switching to innerFrame.

Solution

1. Step 1: Understand nested frame switching

   To access a nested frame, you must first switch to its parent frame before switching to the inner frame.

2. Step 2: Identify missing step

   The code tries to switch directly to "innerFrame" without switching to its parent frame, causing failure to find the frame.

3. Final Answer:

   It misses switching to the parent frame before switching to innerFrame. -> Option D

4. Quick Check:

   Must switch parent frame first = B [OK]

Hint: Always switch parent frame before nested frame [OK]

Common Mistakes:

• Skipping parent frame switch
• Passing frame name incorrectly
• Ignoring frame switching altogether

5. You have a webpage with three nested frames: frameA contains frameB, which contains frameC. You want to click a button inside frameC. Which sequence of Selenium Java commands correctly switches to frameC and clicks the button with id "btnSubmit"?

hard

A. driver.switchTo().defaultContent(); driver.switchTo().frame("frameC"); driver.findElement(By.id("btnSubmit")).click();

B. driver.switchTo().frame("frameC"); driver.findElement(By.id("btnSubmit")).click();

C. driver.switchTo().frame("frameA"); driver.switchTo().frame("frameB"); driver.switchTo().frame("frameC"); driver.findElement(By.id("btnSubmit")).click();

D. driver.switchTo().frame("frameA"); driver.switchTo().defaultContent(); driver.switchTo().frame("frameC"); driver.findElement(By.id("btnSubmit")).click();

Solution

1. Step 1: Switch through each nested frame in order

   Since frameC is inside frameB, which is inside frameA, you must switch step-by-step: first to frameA, then frameB, then frameC.

2. Step 2: Locate and click the button inside the innermost frame

   After switching to frameC, find the button by id "btnSubmit" and click it.

3. Final Answer:

   driver.switchTo().frame("frameA"); driver.switchTo().frame("frameB"); driver.switchTo().frame("frameC"); driver.findElement(By.id("btnSubmit")).click(); -> Option C

4. Quick Check:

   Stepwise frame switching then action = A [OK]

Hint: Switch frames in order from outer to inner before action [OK]

Common Mistakes:

• Trying to switch directly to innermost frame
• Using defaultContent() in middle of switching
• Not switching frames at all before clicking