Iframe interaction strategies in Cypress - Test Execution Trace

Test Overview

This test demonstrates how to interact with an iframe using Cypress. It verifies that a button inside the iframe can be clicked and that the expected text appears after the click.

Test Code - Cypress

Cypress

describe('Iframe interaction test', () => {
  it('Clicks button inside iframe and verifies text', () => {
    cy.visit('https://example.com/page-with-iframe')
    cy.get('iframe#iframe-id').then($iframe => {
      const iframeBody = $iframe.contents().find('body')
      cy.wrap(iframeBody).find('button#inside-iframe-btn').click()
      cy.wrap(iframeBody).find('p#result-text').should('contain.text', 'Button clicked!')
    })
  })
})

Execution Trace - 8 Steps

Step	Action	System State	Assertion	Result
1	Test starts	Cypress test runner initialized	—	PASS
2	Browser opens and navigates to 'https://example.com/page-with-iframe'	Page with iframe loaded	URL is correct	PASS
3	Find iframe element with selector 'iframe#iframe-id'	Iframe element found in DOM	Iframe element exists	PASS
4	Access iframe's document body using jQuery contents() and find('body')	Iframe's body element accessed	Iframe body is accessible	PASS
5	Wrap iframe body and find button with selector 'button#inside-iframe-btn'	Button inside iframe found	Button element exists inside iframe	PASS
6	Click the button inside the iframe	Button clicked, iframe content updated	—	PASS
7	Find paragraph with selector 'p#result-text' inside iframe and check text content	Paragraph element found inside iframe	Text contains 'Button clicked!'	PASS
8	Test ends	Test completed successfully	—	PASS

Failure Scenario

Failing Condition: The iframe or button inside it is not found or the expected text does not appear after clicking the button

Execution Trace Quiz - 3 Questions

What is the correct way to access the body of an iframe in Cypress?

A Use cy.get('iframe').then($iframe => $iframe.contents().find('body'))

B Use cy.get('iframe').click() directly

C Use cy.get('iframe').find('button') without accessing contents()

D Use cy.get('body') to access iframe content

Key Result

When testing iframes with Cypress, always access the iframe's document body using jQuery contents() and wrap it with cy.wrap() to chain Cypress commands inside the iframe context.

Practice

1. Why do iframes need special handling in Cypress tests?

easy

A. Because iframes load separate HTML documents inside the main page

B. Because iframes are always hidden elements

C. Because Cypress cannot find elements outside the iframe

D. Because iframes automatically block all user interactions

Solution

1. Step 1: Understand iframe structure

   An iframe loads a separate HTML document inside the main page, acting like a mini browser window.

2. Step 2: Recognize Cypress limitation

   Cypress commands by default work on the main page DOM, so special steps are needed to access iframe content.

3. Final Answer:

   Because iframes load separate HTML documents inside the main page -> Option A

4. Quick Check:

   Iframes = separate pages inside page [OK]

Hint: Remember iframe is like a page inside a page [OK]

Common Mistakes:

• Thinking iframe content is part of main DOM
• Assuming iframe is always hidden
• Believing Cypress can't access iframe at all

2. Which Cypress command correctly wraps the iframe body for interaction?

easy

A. cy.get('iframe').find('body').wrap()

B. cy.get('iframe').contentWindow.body.then(cy.wrap)

C. cy.get('iframe').contentDocument.body.wrap()

D. cy.get('iframe').its('0.contentDocument.body').then(cy.wrap)

Solution

1. Step 1: Access iframe document body

   Use its('0.contentDocument.body') to get the iframe's body element correctly.

2. Step 2: Wrap body for Cypress commands

   Use then(cy.wrap) to wrap the body so Cypress commands can chain inside the iframe.

3. Final Answer:

   cy.get('iframe').its('0.contentDocument.body').then(cy.wrap) -> Option D

4. Quick Check:

   Correct iframe body access = cy.get('iframe').its('0.contentDocument.body').then(cy.wrap) [OK]

Hint: Use its('0.contentDocument.body').then(cy.wrap) [OK]

Common Mistakes:

• Using contentWindow instead of contentDocument
• Trying to wrap without then()
• Calling wrap() directly on body without cy.wrap

3. What will the following Cypress code do?

cy.get('iframe').its('0.contentDocument.body').then(cy.wrap).find('button').click()

medium

A. Fails because iframe contentDocument is undefined

B. Throws an error because find() cannot be used after then()

C. Clicks the button inside the iframe after wrapping the iframe body

D. Clicks the button outside the iframe on the main page

Solution

1. Step 1: Wrap iframe body for chaining

   The code gets the iframe, accesses its body, wraps it so Cypress commands can chain inside.

2. Step 2: Find and click button inside iframe

   After wrapping, it finds the button inside iframe body and clicks it correctly.

3. Final Answer:

   Clicks the button inside the iframe after wrapping the iframe body -> Option C

4. Quick Check:

   Wrapping iframe body enables find() and click() inside iframe [OK]

Hint: Wrap iframe body before find() to interact inside [OK]

Common Mistakes:

• Assuming find() works on iframe element directly
• Not wrapping iframe body before chaining
• Confusing iframe contentDocument with undefined

4. You wrote this code but it fails with 'Cannot read property body of undefined':

cy.get('iframe').its('0.contentDocument.body').then(cy.wrap).find('input').type('Hello')

What is the likely cause?

medium

A. The iframe content has not loaded yet when accessing contentDocument

B. The selector 'iframe' is incorrect and finds no element

C. You cannot use then() with cy.wrap in Cypress

D. The input element does not exist inside the iframe

Solution

1. Step 1: Understand error meaning

   'Cannot read property body of undefined' means contentDocument is undefined because iframe content is not ready.

2. Step 2: Recognize iframe loading timing

   Iframe content loads asynchronously; accessing contentDocument too early causes undefined error.

3. Final Answer:

   The iframe content has not loaded yet when accessing contentDocument -> Option A

4. Quick Check:

   Wait for iframe load before accessing contentDocument [OK]

Hint: Wait for iframe to load before accessing contentDocument [OK]

Common Mistakes:

• Assuming selector is wrong without checking
• Thinking then() with cy.wrap is invalid
• Ignoring iframe load timing issues

5. You want to click a button inside an iframe, but the iframe content loads slowly. Which is the best Cypress strategy to ensure stable interaction?

hard

A. Directly call cy.get('iframe').find('button').click() without waiting

B. Use cy.get('iframe').its('0.contentDocument.body').should('not.be.empty').then(cy.wrap).find('button').click()

C. Use cy.wait(5000) before accessing iframe content

D. Reload the page until the iframe button is found

Solution

1. Step 1: Wait for iframe body to load

   Using should('not.be.empty') waits until iframe body has content, ensuring it's loaded.

2. Step 2: Wrap and interact safely

   After confirming content, wrap the body and find the button to click reliably.

3. Final Answer:

   Use cy.get('iframe').its('0.contentDocument.body').should('not.be.empty').then(cy.wrap).find('button').click() -> Option B

4. Quick Check:

   Wait for iframe content before actions = Use cy.get('iframe').its('0.contentDocument.body').should('not.be.empty').then(cy.wrap).find('button').click() [OK]

Hint: Use should('not.be.empty') to wait iframe content [OK]

Common Mistakes:

• Using fixed wait times instead of content checks
• Trying to find elements directly on iframe without wrapping
• Reloading page repeatedly instead of waiting properly