Core Step selectForm

Description

This step can be used to specify a form in the document as the current form. The current form is given precedence when locating the form to use in form-related steps.

Further test steps will first look in this form for the fields to process. This allows easy processing of multiple fields within a form especially if you have multiple forms and would otherwise have to specify the form expicitly all the time, or if you have fields across multiple forms with the same names.

Parameters

description

Required? no

The description of this test step.

index

Required? yes/no

The index of the form to select (starting at 0). Either name or index is required.

name

Required? yes/no

The name of the form to select (i.e. the value of the NAME attribute in <form name='foo' ... >). Either name or index is required.

Inline Text

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

Required? no

Alternative way to set the 'name' attribute.