iFrame switching (switch_to.frame) in Selenium Python - Build an Automation Script

Verify content inside an iframe on a webpage

Preconditions (2)

Step 1: Open the browser and navigate to 'https://example.com/page-with-iframe'

Step 2: Wait until the iframe with id 'content-frame' is present

Step 3: Switch to the iframe using its id 'content-frame'

Step 4: Locate the heading element inside the iframe with tag 'h1'

Step 5: Verify the heading text is 'Welcome to the iframe content'

Step 6: Switch back to the main page content

Step 7: Locate the main page element with id 'main-title'

Step 8: Verify the main page title text is 'Main Page Title'

✅ Expected Result: The heading inside the iframe matches 'Welcome to the iframe content' and the main page title matches 'Main Page Title'

Automation Requirements - Selenium with Python

Assertions Needed:

Assert the iframe heading text equals 'Welcome to the iframe content'

Assert the main page title text equals 'Main Page Title'

Best Practices:

Use explicit waits to wait for iframe and elements

Use By.ID or By.TAG_NAME locators for clarity

Switch back to default content after iframe interaction

Handle exceptions for element not found

Automated Solution

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
from selenium.common.exceptions import TimeoutException

# Initialize the Chrome WebDriver
with webdriver.Chrome() as driver:
    wait = WebDriverWait(driver, 10)
    driver.get('https://example.com/page-with-iframe')

    try:
        # Wait for iframe to be present
        wait.until(EC.frame_to_be_available_and_switch_to_it((By.ID, 'content-frame')))

        # Now inside iframe, wait for heading
        heading = wait.until(EC.visibility_of_element_located((By.TAG_NAME, 'h1')))

        # Assert heading text inside iframe
        assert heading.text == 'Welcome to the iframe content', f"Expected iframe heading text to be 'Welcome to the iframe content' but got '{heading.text}'"

        # Switch back to main content
        driver.switch_to.default_content()

        # Wait for main page title element
        main_title = wait.until(EC.visibility_of_element_located((By.ID, 'main-title')))

        # Assert main page title text
        assert main_title.text == 'Main Page Title', f"Expected main page title to be 'Main Page Title' but got '{main_title.text}'"

        print('Test passed: iframe and main page content verified successfully.')

    except TimeoutException as e:
        print(f'Test failed: Element not found or timeout occurred - {e}')
    except AssertionError as e:
        print(f'Test failed: Assertion error - {e}')

This script uses Selenium WebDriver with Python to automate the test case.

First, it opens the browser and navigates to the target URL.

It uses an explicit wait to wait until the iframe with id 'content-frame' is available, then switches into it using frame_to_be_available_and_switch_to_it.

Inside the iframe, it waits for the heading <h1> element to be visible, then asserts its text matches the expected string.

After checking the iframe content, it switches back to the main page using switch_to.default_content().

Then it waits for the main page title element by id and asserts its text.

Exceptions for timeouts and assertion failures are caught and printed to help debug.

This approach uses best practices like explicit waits, clear locators, and switching back to default content after iframe interaction.

Common Mistakes - 4 Pitfalls

Not switching back to the main content after interacting with the iframe

Using implicit waits instead of explicit waits for iframe and elements

Using incorrect locator strategies like absolute XPath for iframe or elements

Not handling exceptions for element not found or timeouts

Bonus Challenge

Now add data-driven testing with 3 different iframe ids and expected heading texts

Show Hint

Practice

1. What does driver.switch_to.frame() do in Selenium?

easy

A. It changes the focus to the specified iframe on the page.

B. It closes the current browser window.

C. It refreshes the current webpage.

D. It opens a new browser tab.

Solution

1. Step 1: Understand the purpose of switch_to.frame()

   This method is used to change the driver's focus from the main page to an iframe element embedded in the page.

2. Step 2: Compare with other options

   Closing windows, refreshing pages, or opening tabs are unrelated to frame switching.

3. Final Answer:

   It changes the focus to the specified iframe on the page. -> Option A

4. Quick Check:

   switch_to.frame() changes focus to iframe [OK]

Hint: Remember: switch_to.frame() focuses inside iframe [OK]

Common Mistakes:

• Thinking it closes or refreshes the page
• Confusing with opening new tabs
• Assuming it works without specifying iframe

2. Which of the following is the correct syntax to switch to an iframe by its name "frame1"?

easy

A. driver.switch_to.frame[name="frame1"]

B. driver.switch_to.frame(frame1)

C. driver.switch_to.frame("frame1")

D. driver.switch_to.frame['frame1']

Solution

1. Step 1: Recall correct method syntax

   The method switch_to.frame() accepts a string name as an argument inside parentheses and quotes.

2. Step 2: Check each option

   driver.switch_to.frame("frame1") uses correct parentheses and quotes. Options A and D use incorrect bracket syntax. driver.switch_to.frame(frame1) misses quotes around the string.

3. Final Answer:

   driver.switch_to.frame("frame1") -> Option C

4. Quick Check:

   Use parentheses and quotes for frame name [OK]

Hint: Use parentheses and quotes for frame name [OK]

Common Mistakes:

• Using square brackets instead of parentheses
• Forgetting quotes around the frame name
• Passing variable without quotes

3. What will happen when the following code runs?

driver.switch_to.frame(0)
element = driver.find_element(By.ID, "submit")
print(element.text)

medium

A. It will raise NoSuchElementException because the element is outside the iframe.

B. It will print the text of the element with ID 'submit' inside the first iframe.

C. It will raise a SyntaxError due to wrong frame index.

D. It will print nothing because the iframe is empty.

Solution

1. Step 1: Understand frame switching by index

   Using switch_to.frame(0) switches focus to the first iframe on the page (index 0).

2. Step 2: Locate element inside iframe

   Finding element by ID 'submit' inside this iframe will succeed if it exists there, and printing its text will output the element's text content.

3. Final Answer:

   It will print the text of the element with ID 'submit' inside the first iframe. -> Option B

4. Quick Check:

   switch_to.frame(0) focuses first iframe, element found inside [OK]

Hint: Index 0 means first iframe, then find element inside [OK]

Common Mistakes:

• Assuming element is outside iframe without switching
• Thinking frame index starts at 1
• Confusing SyntaxError with runtime errors

4. Identify the error in this code snippet:

driver.switch_to.frame("frame2")
element = driver.find_element(By.ID, "button")
driver.switch_to.frame("frame3")
print(element.text)

medium

A. The print statement should be before switching frames.

B. You cannot switch to a second iframe without switching back to default content first.

C. The frame names must be integers, not strings.

D. The element variable is not updated after switching to the second iframe.

Solution

1. Step 1: Analyze frame switching and element locating

   The element is found inside "frame2" and stored in variable element.

2. Step 2: Switching to another frame without updating element

   After switching to "frame3", the element still points to the old frame's element, which may cause stale reference or incorrect data.

3. Final Answer:

   The element variable is not updated after switching to the second iframe. -> Option D

4. Quick Check:

   Element must be found after switching to correct frame [OK]

Hint: Find elements after switching to correct iframe [OK]

Common Mistakes:

• Assuming you must switch back to default before switching frames
• Thinking frame names must be integers
• Ignoring element reference update after frame switch

5. You have nested iframes: an outer iframe named "outerFrame" and inside it an inner iframe with index 0. How do you switch to the inner iframe to access its elements?

hard

A. driver.switch_to.frame("outerFrame") followed by driver.switch_to.frame(0)

B. driver.switch_to.frame(0) followed by driver.switch_to.frame("outerFrame")

C. driver.switch_to.frame("outerFrame") only

D. driver.switch_to.default_content() then driver.switch_to.frame(0)

Solution

1. Step 1: Switch to the outer iframe by name

   First, use driver.switch_to.frame("outerFrame") to focus inside the outer iframe.

2. Step 2: Switch to the inner iframe by index

   Then, use driver.switch_to.frame(0) to focus inside the first iframe nested within the outer iframe.

3. Final Answer:

   driver.switch_to.frame("outerFrame") followed by driver.switch_to.frame(0) -> Option A

4. Quick Check:

   Switch outer frame first, then inner frame [OK]

Hint: Switch outer iframe first, then inner iframe by index [OK]

Common Mistakes:

• Switching inner frame before outer frame
• Forgetting nested switch and switching only once
• Using default_content() unnecessarily