Frames

Frames are automatically detected by Test Studio. When you record an action or verification against an element within a frame, Test Studio adds an additional frame node to the Elements Explorer.

A frame has its own properties which determine how it is located. The frame must be found before acting upon the elements within it.

The identification priority for a frame is as follows:

• Id - the preferred frame identification method.
• Name - used only if Id is not set.
• Src - the frame's effective Src value, taking into consideration the UseQuery flag.
• Index - Test Studio sees all Frames on the page in a flat list. Used as last resort; zero based.

When a frame cannot be found, you'll receive an error message like this:

Unable to find the target host (Browser/SilverlightApp) to locate an element. Failure: System.TimeoutException: Wait for condition has timed out at ArtOfTest.Common.WaitSync.CheckResult(WaitSync wait, String extraExceptionInfo) at ArtOfTest.Common.WaitSync.For[T,V](Func3 func, T target, V custom, Boolean invertCondition, Int32 timeout) at ArtOfTest.Common.WaitSync.For\[T,V](Func3 func, T target, V custom, Int32 timeout) at ArtOfTest.WebAii.Core.Browser.WaitForFrame(FrameInfo frameInfo, Int32 timeout) at ArtOfTest.WebAii.Design.Execution.ExecutionUtils.GetFrameBrowserInstance(Browser topBrowser, FrameInfo frame, Int32 waitTimeout, String& stringError)

This is often due to a dynamic frame Id or Name. This is remedied by using the tilde (~) character to indicate a partial match. This can be used in the BaseURL, Id, and Name fields. If the Src string contains a dynamic query, set UseQuery to False.