Using TestProject with iFrames

From a browser's perspective, an iframe, or inline frame, is an html document embedded inside of another html document. They can be helpful for encapsulating html on a part of page, but they can also be a bit tricky to use in test automation.

Finding Elements

When a test automation framework like TestProject is looking for elements on a page, it will only look for the element in the current document. This means that if the element you want is inside of an iframe, it won't find it since that iframe is considered to be a separate document. Don't worry though, TestProject provides functionality that let's you get into an iframe and find the elements you need. Let's take a look at an example.

If you have not yet setup a project and test, you can checkout how to create them in the documentation section on web testing. For this example, set up a test that navigates to this URL: . This is an example page that we can use to practice working with iframes.

iFrame Example

Start up the test recorder and for this example let's see if we can type something in the editor text box. Normally with the test recorder you can just click on the element on the page you want to interact with and the test reorder will add a test step with that element and action. However, in this case the editor text box is inside an iframe so if you try to click on it you will see that no test step is added.

In order to actually interact with element inside the iframe, you will first need to tell TestProject to navigate into that iframe. In order to do this you can use the Switch to iFrame action. This action is available through the Element Extensions addon. More information on installing and using addons can be found in the documentation here.

iFrame action from Element Extensions Addon

This action, will allow you to navigate into the iframe, but in order to do that you will need to let it know what element on the page is the iframe you are interested. You can find the iframe id on the page using the Element Explorer.

iframe ID in Element Explorer

Once you have found the ID you can close the element explorer and return to the Create Step panel and click on select element. On the next panel we can search for elements, but since the iframe has not yet been added to the test, you can use the plus at the bottom of this panel to add a new element.

Add a New Element

Name the element to something like iframe and set the element type to be a generic web element. For the locator, use ID and then in text box type in the ID you found in the Element Explorer.

Create iframe element

You can then click on the Create button to create this element and add it your test step. Once you have done that, use the more option beside the test step and choose the Run Until Here option.

More Menu

Locate Elements in an iFrame

Now that you are inside the iFrame you can start to interact with elements on this part of the page. The test recorder still won't record the clicks and interactions on the screen, but we can easily find the elements we wan using the Element Explorer.

iFrame Element

You can see that the id of the is tinymce and then from the menu for this element we can select Actions and then Clear Contents to add a step that will clear the contents of the cell.

Clear Contents Action

Once you hit create to create the step, you can follow a similar process to create a test step that lets you type in the text you want, but using the Type text action.


iFrames can be a bit challenging to deal with in UI test automation, but you can see that by using the switch to iFrame action in combination with other tools like the Element Explorer, you are able to execute the actions you want.