How to test iFrames

In this tutorial, we’re going to look at how to test elements within an iframe using UI-licious.

Sample iFrame

Real-World Example: Eventbrite’s modal

We’ll be testing the checkout modal on one of Eventbrite’sopen in new window pages.

Let’s write a test to interact with the elements on the modal and select the number of tickets and proceed to the checkout page.

First, we'll write all the code necessary to automate the testing of these elements.

We'll begin by clicking on "Get Tickets" to open the modal for selecting the number of tickets."Get Tickets")

Then, we'll specify how many tickets to buy and for this test, we’ll be choosing 2."Women's Retreat: Mindshift", 2) 

After that, we'll click on "Check Out" to move on to the next page."Check out")

As of now our script is:

//Navigate to site

//Accept Cookies"Accept All")"Get Tickets")

//Codes to interact with elements on the iframe"Women's Retreat: Mindshift", 2)"Checkout")

Now, let's try running our script and see if it will click an element in our iframe.

We can see there are a few errors and one of them suggests our element is inside an iframe. The errors are shown because the checkout modal is actually an iframe

Failing test due to iFrame handling

Inspecting the iframe component

To handle this scenario, we need to use “UI.context()” in conjunction with our code to help UI-licious interact with those elements inside an iframe.

Iframe elements are used to embed a webpage on another webpage. An iframe is considered a separate browsing context from its parent webpage, similar to how individual browser tabs are considered separate browsing contexts. The contents of an iframe are not accessible and are essentially a black box to UIlicious unless the test explicitly targets the iframe.

Inspecting Iframe Element

First, we need to identify the correct attribute for the iframe. We will open the browser inspector and check the attributes present for the iframe.

Using UI.context within our script

For this, we can use the “data-automation” attribute to be used with “UI.context()”.


We wrote “data-automation” so we can only match the very beginning of the given value and not the whole as the attribute we chose has a random ID that may change in the future.

Complete test script and result

Our complete script should now be

//Navigate to site

//Accept Cookies"Accept All")"Get Tickets")

//Codes to interact with elements on the iframe
UI.context("iframe[data-automation^=checkout-widget-iframe]", ()=>{"Women's Retreat: Mindshift", 2)"Check out")

After adding that into our script and running it again, we can see it was successfully able to interact with them now!

You may view, rerun and edit the test script available publicly on snippets here: View “Testing Element Inside An iframe” test scriptopen in new window

Last Updated: