Canoo Webtest WebTest Canoo

Core Step followFrame


Locates a frame by its name (e.g. <FRAME NAME='myFrame' SRC='myPage.jsp'>) and defines it as the "current" response for the next steps.


Required? no
The description of this test step.
Required? yes/no
The id of the frame to select. One of 'name' or 'htmlid' must be set.
Required? yes/no
The name of the frame to follow, specified in the frameset. For nested frames use the name of the frame your are after, e.g. it may be the name in the nested frameset. NOTE: if nested frames bear the same name (e.g. foo inside foo), it is not specified which of the frames will be selected. It is possible to select the top window using the special name '_top'. One of 'name' or 'htmlid' must be set.
Required? no, default is false
Indicates that the frame with the given name should be searched in the current response (rather than in the top window). In the case of nested frames this allows you to follow a first frame, perform some actions and later to follow the nested frame.
Required? no
A shorthand: save='prefixName' is the same as savePrefix='prefixName' saveResponse='true'.
Required? no, default is the 'savePrefix' parameter as specified in <config>.
A name prefix can be specified for making a permanent copy of received responses. A unique number and the file extension (depending on the MIME-Type) will be appended. The resultpath attribute of the <config> element is used for determining the location of the saved result.
Required? no
Whether to make a permanent copy of received responses. Overrides the default value set in the <config> element.

Inline Text

The inline text is all the text between the start tag ( <followFrame> ) and the end tag ( </followFrame> ), including blanks, tabs or newlines. Using a pair of start/end tags ( <followFrame> </followFrame> ) has not the same behavior than the seemingly equivalent empty element tag ( <followFrame/> )! See this issue for an example.

Required? no
Alternative way to set the 'name' attribute.


<webtest name="Follow target frame..">
  <config ... />
    <followFrame description="Follow the frame"


Latest build: development
Posted: 19-Jul-2016 17:36

WebTest 3.0 released, featuring upgrades to Java 5, Groovy 1.6, and HtmlUnit 2.4.
The release includes support for maven integration, IDE-integration like for unit tests, capturing of background JavaScript errors, new steps for mouseOver and mouseOut events, better parallel execution of tests and - as usual - lots of handling improvements.
Posted: 5 March 2009

WebTest @ JavaOne
Dierk König presented "Functional testing of web applications: scaling with Java" on Wed May 7, 13:30 at JavaOne 2008 in the Tools and Scripting Languages track.
Posted: 8 May 2008

New WebTest screencast available:
Data Driven WebTest
Posted: 13 November 2007

First WebTest screencast available:
Creating a first Webtest Project

Extend WebTest with Groovy! Groovy in Action is available in every good bookstore.
Groovy in Action
Posted: 29 January 2007