Available Tags

This is a list of available tags for Selenium Plug-in. This list of tags is also available in the Jameleon GUI. You can get there by selecting the "Functional Points" tab on the lower-left. All tags, including custom tags and other enabled plug-ins' tags, show up in the GUI.

Selenium Plug-in Tags

TagShort Description
<selenium-add-selection/>Selects an option in a select field.
<selenium-answer-on-next-prompt/>Answers the next prompt.
<selenium-assert-editable/>Validates something is editable(not disabled).
<selenium-assert-element-present/>Validates an element exists on the current page.
<selenium-assert-field-value-equals/>Validates a form field's value.
<selenium-assert-something-selected/>Validates something is selected in a drop-down("select") field.
<selenium-assert-text-present/>Validates text on the current page.
<selenium-assert-title-equals/>Validates the Title.
<selenium-assert-visible/>Validates an element is visible.
<selenium-check/>Checks a radio button or checkbox.
<selenium-choose-cancel-on-next-confirmation/>Clicks the "cancel" button on the next instance of window.
<selenium-click/>Clicks on an HTML element.
<selenium-click-at/>Clicks on an HTML element.
<selenium-close/>Simulates the user clicking the "close" button in the titlebar of a popup.
<selenium-create-cookie/>Creates a cookie.
<selenium-delete-cookie/>Deletes a cookie with the specified name and (optionally) path.
<selenium-fire-event/>Fires off JavaScript events on a given HTML Element.
<selenium-get-alert/>Gets the text of the current alert box and stores it in the defined context variable.
<selenium-get-all-buttons/>Gets all of the page's buttons(type="text" only, currently).
<selenium-get-all-fields/>Gets all of the page's input fields (type="text" only, currently).
<selenium-get-all-links/>Gets all of the page's links.
<selenium-get-all-window-ids/>Gets the ids of all visible windows.
<selenium-get-all-window-names/>Gets the names of all visible windows.
<selenium-get-all-window-titles/>Gets the titles of all visible windows.
<selenium-get-attribute/>Gets the value of the specified attribute on an element.
<selenium-get-attribute-from-all-windows/>Gets a specific attribute from all windows.
<selenium-get-confirmation/>Gets string typed into the last confirmation dialog.
<selenium-get-cookie/>Gets all the cookies for the current page.
<selenium-get-element-height/>Gets height, in pixels, of an item.
<selenium-get-element-position-left/>Gets the left position, in pixels, of an item.
<selenium-get-element-position-top/>Gets top position, in pixels, of an item.
<selenium-get-element-width/>Gets width, in pixels, of an item.
<selenium-get-eval/>Gets the result of evaluating the specified JavaScript snippet.
<selenium-get-location/>Gets the URL location of the current browser.
<selenium-get-select-options/>Gets the option labels of a select field.
<selenium-get-selected-id/>Gets the id of the selected item in a select field.
<selenium-get-selected-ids/>Gets the selected ids of a select field.
<selenium-get-selected-index/>Gets the index of the selected item in a select field.
<selenium-get-selected-indexes/>Gets the selected indexes of a select field.
<selenium-get-selected-label/>Gets the label of the selected item in a select field.
<selenium-get-selected-labels/>Gets the selected labels of a select field.
<selenium-get-selected-value/>Gets the value of the selected item in a select field.
<selenium-get-selected-values/>Gets the values of the selected items of a select field.
<selenium-get-text/>Gets the inner text of any HTML element.
<selenium-get-title/>Gets the title of the current page.
<selenium-get-value/>Gets the value of a form field.
<selenium-go-back/>Simulates the browser "back" button.
<selenium-key-down/>Simulates a user pressing a key (without releasing it yet).
<selenium-key-press/>Simulates a user pressing a key and releasing it.
<selenium-key-up/>Simulates a user releasing a key.
<selenium-mouse-down/>Simulates a user pressing the mouse button (without releasing it yet) on the specified element.
<selenium-mouse-down-at/>Simulates a user pressing the mouse button (without releasing it yet) on the specified element at a specific coordinate.
<selenium-mouse-move/>Simulates a user moving the mouse over of the specified element.
<selenium-mouse-move-at/>Simulates a user moving the mouse over the specified element at a specific coordinate.
<selenium-mouse-out/>Simulates a user moving the mouse out of the specified element.
<selenium-mouse-over/>Simulates a user hovering a mouse over the specified element.
<selenium-mouse-up/>Simulates a user releasing the mouse button on the specified element.
<selenium-mouse-up-at/>Simulates a user releasing the mouse button on the specified element at a specific coordinate.
<selenium-open/>Navigates the browser to the desired url.
<selenium-refresh/>Simulates the browser "refresh" button.
<selenium-remove-selection/>Unselects an option in a select field.
<selenium-select/>Selects an option in a select field.
<selenium-select-window/>Selects a window.
<selenium-session/>A Session tag for the Selenium plug-in.
<selenium-submit/>Submits a form.
<selenium-type/>Type text into form fields.
<selenium-uncheck/>Unchecks a radio button or checkbox.
<selenium-wait-for-condition/>Tries to validate a javascript condition during a certain amount of time.
<selenium-wait-for-value/>Continually tries to validate the text contents of a HTML element during a certain amount of time.

selenium-add-selection

Selects an option in a select field. If a selection is already made, then it selects the next option w/o unselecting the previously selected field. To select the 3rd option in the select field named field1:

    
<selenium-add-selection
functionId="Select the 3rd option"
selectLocator="name=field1"
optionLocator="index=2" />
To select the option with the displayed value Choose me in the select field named field1:
    
<selenium-add-selection
functionId="Select the 'Choose me' option"
selectLocator="name=field1"
optionLocator="label=Choose me" />
To select the option with the value attribute set to 123 in the select field named field1:
    
<selenium-add-selection
functionId="Select the 'Choose me' option"
selectLocator="xpath=//select[@name='field1']"
optionLocator="value=123" />
To select the option with the id attribute set to 123 in the select field named field1:
    
<selenium-add-selection
functionId="Select the 'Choose me' option"
selectLocator="dom=document.forms[2].field1"
optionLocator="id=123" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
selectLocator

The locator used to find the select field which value is to be set.

truejava.lang.String
optionLocator

The locator used to find the option to select in the select field. NOTE: This locator format is different from the selectLocator. See the Selenium javadocs for more information. Some possible Option Locator types are label, value, id and index

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-answer-on-next-prompt

Answers the next prompt. It sends the specified answer in response to the next JavaScript prompt [window.prompt()]

    
<selenium-answer-on-next-prompt
functionId="answer 'Yes' to the next prompt"
answer="Yes" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
answer

The response to give the next prompt

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-editable

Validates something is editable(not disabled). You can specify whether you expect true(item is editable) or false (item is disabled). True is the default To see if something IS editable:

    
<selenium-assert-editable
functionId="Assert that the input is editable"
expected="true"
msg="We expected the input to be editable"
locator="input1" />
To see if something is NOT editable:
    
<selenium-assert-editable
functionId="Assert that the input is not editable"
expected="false"
msg="We expected the input to be not editable"
locator="input2" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
expected

The error message to output if the validation fails.

falseboolean
msg

The error message to output if the validation fails.

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-element-present

Validates an element exists on the current page. This tag is not meant to vefiry form fields that aren't aleady filled by the response or form fields that get filled out by javascript events. To validate a page with the title Yo World!:

    
<selenium-assert-element-present
functionId="Verify that the title is 'Yo World!'"
locatorType="xpath"
locator="//title[text()='Yo World!']" />
To verify that the 2nd row and the 3rd column of the first table has the text value Success, using XPath:
    
<selenium-assert-element-present
functionId="Verify that text in a table"
locatorType="xpath"
locator="//table[1]/tr[2]/td[position()=3 and text()='Success']" />
To check that an HTML element with the id of some_id exists:
    
<selenium-assert-element-present
functionId="Verify that text in a table"
locatorType="id"
locator="some_id" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
msg

The error message to output if the validation fails.

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-field-value-equals

Validates a form field's value. When validating select fields, only the value attribute will be validated with this tag. A textarea's value is validated from the text nested between the opening and closing textare tags. To validate a form field named text_field_name has the value some value: (<input type="text" name="text_field_name">

    
<selenium-assert-field-value-equals
functionId="Validate the text field, 'text_field_name', has a value of 'some value'"
locator="text_field_name"
value="some value">
To use XPath for the same field:
    
<selenium-assert-field-value-equals
functionId="Validate the text field, 'text_field_name', has a value of 'some value'"
locator="xpath=//input[@type='text' and @name='text_field_name']"
value="some value">
To use JavaScript for the same field:
    
<selenium-assert-field-value-equals
functionId="Validate the text field, 'text_field_name', has a value of 'some value'"
locator="dom=document.forms[0].text_field_name"
value="some value">

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
value

The expected value of the field

falsejava.lang.String
msg

The error message to output if the validation fails.

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-something-selected

Validates something is selected in a drop-down("select") field. You can specify whether you expect true(something is selected) or false (nothing is selected). True is the default To see if something IS selected in the fruits select field:

    
<selenium-assert-something-selected
functionId="Assert if something is selected in 'fruits' field"
expected="true"
msg="no fruits were selected"
locator="fruits" />
To see if something is NOT selected in the states select field:
<selenium-assert-something-selected
functionId="Assert if something is selected in 'states' field"
expected="false"
msg="no states should be selected"
locator="states" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
expected

The error message to output if the validation fails.

falseboolean
msg

The error message to output if the validation fails.

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-text-present

Validates text on the current page. To validate text in a page using regular expressions:

    
<selenium-assert-text-present
functionId="Check for text using a regular expression"
pattern="regexp:[Yo]+ W[a-z]{3}" />
To validate text in a page using the default glob style:
    
<selenium-assert-text-present
functionId="Check for text using a glob pattern"
pattern="Y* Wor?d" />
To validate exact text in a page:
    
<selenium-assert-text-present
functionId="Check that the entire reponse only contains 'Yo World'"
pattern="exact:Yo World" />
NOTE: To do a "glob" search, make sure to not define the prefix.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
msg

The error message to output if the validation fails.

falsejava.lang.String
pattern

The pattern to match. An example would be regexp=[Y[a-z] Wo[rld]{3} Please see the Selenium docs for more information on the pattern syntax.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-title-equals

Validates the Title. To validate a page with the title Yo World!:

    
<selenium-assert-title-equals
functionId="Verify that the title is 'Yo World!'"
title="Yo World!" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
title

The expected title of the page

truejava.lang.String
msg

The error message to output if the validation fails.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-assert-visible

Validates an element is visible. You can specify whether you expect true(item is visible) or false (item is not visible). True is the default To see if something IS visible:

    
<selenium-assert-visible
functionId="Assert that the div is visible"
expected="true"
msg="We expected the div to be visible"
locator="mydiv" />
To see if something is NOT visible:
    
<selenium-assert-visible
functionId="Assert that the div is not visible"
expected="false"
msg="We expected the div to be not visible"
locator="div_2" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
expected

The error message to output if the validation fails.

falseboolean
msg

The error message to output if the validation fails.

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-check

Checks a radio button or checkbox. To check a checkbox named cbx_nme:

    
<selenium-check
functionId="Check the checkbox"
locator="cbx_nme" />
To check a radio button named rd_nme via JavaScript DOM:
    
<selenium-check
functionId="Check the radio button"
locator="dom=document.forms[0].rd_nme" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-choose-cancel-on-next-confirmation

Clicks the "cancel" button on the next instance of window.confirm().

    
<selenium-choose-cancel-on-next-confirmation

functionId="Tell Selenium to answer 'cancel' on next confirm dialog" />

Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-click

Clicks on an HTML element. To click on a link with the text Link 1:

    
<selenium-click
functionId="Click on 'Link 1'"
locator="link=Link 1" />
To click on a submit button with the name submit_name:
    
<selenium-click
functionId="Click the submit button named 'submit_name'"
locator="submit_name" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
waitForPageToLoad

The max number of milliseconds to wait for the page to load

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-click-at

Clicks on an HTML element. To click on a link with the text Link 1 at coordinates x=2 and y=3:

    
<selenium-click-at
functionId="Click on 'Link 1'"
locator="link=Link 1"
coordinates="2,3"
/>
To click on a submit button with the name submit_name:
    
<selenium-click-at
functionId="Click the submit button named 'submit_name'"
coordinates="3,4"
locator="submit_name" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
coordinates

The coordinates at which to execute the click action (relative to the specified field. In the form of (x,y) -- 8,10 for instance. See the Selenium javadocs for more information.

truejava.lang.String
waitForPageToLoad

The max number of milliseconds to wait for the page to load

falsejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-close

Simulates the user clicking the "close" button in the titlebar of a popup. window or tab. To close the current window:

    
<selenium-close
functionId="Close the current window" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-create-cookie

Creates a cookie. You can specify options, for instance path and max_age. See Selenium documentation for full details.

    
<selenium-create-cookie
functionId="Create a cookie."
nameValuePair="MyName=MyValue"
optionsString="path=/,max_age=100" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
nameValuePair

Name value pair in the form "name=value"

truejava.lang.String
optionsString

Options string. Currently path and max_age are supported by Selenium

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-delete-cookie

Deletes a cookie with the specified name and (optionally) path.

    
<selenium-delete-cookie
functionId="Deletes a specific cookie."
name="MyName"
path="/" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
name

Name of the cookie to delete

truejava.lang.String
path

Path of the cookie to delete

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-fire-event

Fires off JavaScript events on a given HTML Element. This tag is used for blur, change, focus, and select. All other events don't seem to work. To fire an onclick event on a text field:

    
<selenium-fire-event
functionId="Fire an event on the 'q' text field"
eventName="onblur"
locator="name=q" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
eventName

The name of the event to fire. For example, onblur's event name would be blur

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-alert

Gets the text of the current alert box and stores it in the defined context variable. Getting the text of the alert window also clears the alert window. To get the current text of the alert window:

    
<selenium-get-alert
functionId="Get the text of the current alert window"
contextVariable="alert_text" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-all-buttons

Gets all of the page's buttons(type="text" only, currently). To get the buttons:

    
<selenium-get-all-buttons
functionId="Get all buttons on the page."
contextVariable="page_buttons" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-all-fields

Gets all of the page's input fields (type="text" only, currently). To get the input fields:

    
<selenium-get-all-fields
functionId="Get all fields on the page."
contextVariable="page_fields" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-all-links

Gets all of the page's links. To get the links:

    
<selenium-get-all-links
functionId="Get all links on the page."
contextVariable="page_links"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-all-window-ids

Gets the ids of all visible windows. To get the window ids:

    
<selenium-get-all-window-ids
functionId="Get all window ids."
contextVariable="allIds" />
<ju-assert-equals
functionId="Make sure the first field of allIds is there"
expected="My Page Id"
actual="${allIds.get(0)}" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-all-window-names

Gets the names of all visible windows. To get the window names:

    
<selenium-get-all-window-names
functionId="Get all window names."
contextVariable="allNames" />
<ju-assert-equals
functionId="Make sure the first field of allNames is there"
expected="My Page Name"
actual="${allNames.get(0)}" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-all-window-titles

Gets the titles of all visible windows. To get the window titles:

    
<selenium-get-all-window-titles
functionId="Get all window titles."
contextVariable="allTitles" />
<ju-assert-equals
functionId="Make sure the first field of allTitles is there"
expected="My Page Title"
actual="${allTitles.get(0)}" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-attribute

Gets the value of the specified attribute on an element. Note: The selenium documentation is currently incomplete as to the format of the locator involved here. Directly from the (correct) selenium-api.js source: attributeLocator an element locator followed by an @ sign and then the name of the attribute, e.g. "foo@bar" To get the value of the attribute named type on the input field with id of input1:

    
<selenium-get-attribute
functionId="Get the value of the type attribute of input1"
locator="input1@type"
contextVariable="my_attr_type"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-attribute-from-all-windows

Gets a specific attribute from all windows. To get the window titles:

    
<selenium-get-attribute-from-all-windows
functionId="Get all window titles."
attribute="document.title"
contextVariable="allTitles" />

<ju-assert-equals
functionId="Make sure the first title of the first window is 'My Page Title'"
expected="My Page Title"
actual="${allTitles.get(0)}" />
Examples include id, document.title, name

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
attribute

The attribute to get from all windows. Examples include title, id, name

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-confirmation

Gets string typed into the last confirmation dialog.

    
<selenium-get-confirmation
functionId="Get the confirmation text"
contextVariable="confirm_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-cookie

Gets all the cookies for the current page. It puts them as a single (semi-colon-delimited) String in a context variable. They will be of the form: "name1=value1; name2=value2"

    
<selenium-get-cookie
functionId="Get all the cookies for the current page."
contextVariable="cookies"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-element-height

Gets height, in pixels, of an item. To get the height of an item with id="home":

    
<selenium-get-element-height
functionId="Get height of this item in pixels"
locator="id=home"
contextVariable="home_height"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-element-position-left

Gets the left position, in pixels, of an item. To get the left position of an item with id="home":

    
<selenium-get-element-position-left
functionId="Get left position of this item in pixels"
locator="id=home"
contextVariable="home_left_position"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-element-position-top

Gets top position, in pixels, of an item. To get the top position of an item with id="home":

    
<selenium-get-element-position-top
functionId="Get top position of this item in pixels"
locator="id=home"
contextVariable="home_top_position"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-element-width

Gets width, in pixels, of an item. To get the width of an item with id="home":

    
<selenium-get-element-width
functionId="Get width of this item in pixels"
locator="id=home"
contextVariable="home_width"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-eval

Gets the result of evaluating the specified JavaScript snippet.

    
<selenium-get-eval
functionId="Evaluate the script and return the result"
script="i=10; i=i+20"
contextVariable="script_result" />
<ju-assert-equals
functionId="Check that the script_result is '30'"
expected="30"
actual="${script_result}" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
script

The script to evaluate

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-location

Gets the URL location of the current browser. To get the current URL:

    
<selenium-get-location
functionId="Get the location of the current page"
contextVariable="page_url"/>
<ju-assert-equals
functionId="Check that the url is 'http://www.google.com/'"
expected="http://www.google.com/"
actual="${page_url"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-select-options

Gets the option labels of a select field. To get the option labels:

    
<selenium-get-select-options
functionId="Get the option labels of the select field."
locator="states"
contextVariable="home_link_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-id

Gets the id of the selected item in a select field. To get the id of the selected item in a select field named fruit:

    
<selenium-get-selected-id
functionId="Get the selected id of the fruit field"
locator="fruit"
contextVariable="fruit_selected"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-ids

Gets the selected ids of a select field. To get the selected ids:

    
<selenium-get-selected-ids
functionId="Get the selected ids."
locator="states"
contextVariable="home_link_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-index

Gets the index of the selected item in a select field. To get the index of the selected item in a select field named fruit:

    
<selenium-get-selected-index
functionId="Get the selected index of the fruit field"
locator="fruit"
contextVariable="fruit_selected"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-indexes

Gets the selected indexes of a select field. To get the selected indexes:

    
<selenium-get-selected-indexes
functionId="Get the selected indexes."
locator="states"
contextVariable="home_link_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-label

Gets the label of the selected item in a select field. To get the label of the selected item in a select field named fruit:

    
<selenium-get-selected-label
functionId="Get the selected label of the fruit field"
locator="fruit"
contextVariable="fruit_selected"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-labels

Gets the selected labels of a select field. To get the selected labels:

    
<selenium-get-selected-labels
functionId="Get the selected labels."
locator="states"
contextVariable="home_link_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-value

Gets the value of the selected item in a select field. To get the value of the selected item in a select field named fruit:

    
<selenium-get-selected-value
functionId="Get the selected value of the fruit field"
locator="fruit"
contextVariable="fruit_selected"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-selected-values

Gets the values of the selected items of a select field. To get the selected fields' values:

    
<selenium-get-selected-values
functionId="Get the selected fields values."
locator="states"
contextVariable="home_link_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-text

Gets the inner text of any HTML element. To get the text of an anchor field:

    
<selenium-get-text
functionId="Get the text value of an anchor with and id of 'home'."
locator="id=home"
contextVariable="home_link_text"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-title

Gets the title of the current page. To get the current title:

    
<selenium-get-title
functionId="Get the title of the current page"
contextVariable="page_title"/>
<ju-assert-equals
functionId="Check that the title is 'Home page'"
expected="Home page"
actual="${page_title}"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-get-value

Gets the value of a form field. To get the value of a text field named username:

    
<selenium-get-value
functionId="Get the value of the username field"
locator="username"
contextVariable="username_value"/>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
contextVariable

The context variable to put the alert text in. If this is not defined then the value will not be stored.

falsejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-go-back

Simulates the browser "back" button.

    
<selenium-go-back
functionId="Hit the browser back button" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-key-down

Simulates a user pressing a key (without releasing it yet). To press the 'a' key on the fld_nme field:

    
<selenium-key-down
functionId="Press the 'a' key down"
locator="fld_nme"
keycode="97" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
keycode

The numeric keycode of the key to be pressed, normally the ASCII value of that key.

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-key-press

Simulates a user pressing a key and releasing it. To press the 'a' key on the fld_nme field:

    
<selenium-key-press
functionId="Press the 'a' key"
locator="fld_nme"
keycode="97" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
keycode

The numeric keycode of the key to be pressed, normally the ASCII value of that key.

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-key-up

Simulates a user releasing a key. To release the 'a' key on the fld_nme field:

    
<selenium-key-up
functionId="release the 'a' key down"
locator="fld_nme"
keycode="97" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
keycode

The numeric keycode of the key to be pressed, normally the ASCII value of that key.

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-down

Simulates a user pressing the mouse button (without releasing it yet) on the specified element. To press the mouse button over the field named q:

    
<selenium-mouse-down
functionId="press the mouse button over the 'q' field"
locator="name=q" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-down-at

Simulates a user pressing the mouse button (without releasing it yet) on the specified element at a specific coordinate. To press the mouse button over the field named q:

    
<selenium-mouse-down-at
functionId="press the mouse button over the 'q' field"
locator="name=q"
coordinates="5,6" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
coordinates

The coordinates at which to execute the mouse action (relative to the specified field. In the form of (x,y) -- 8,10 for instance. See the Selenium javadocs for more information.

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-move

Simulates a user moving the mouse over of the specified element. To move the mouse over of the field named q:

    
<selenium-mouse-move
functionId="move mouse over of 'q' field"
locator="name=q" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-move-at

Simulates a user moving the mouse over the specified element at a specific coordinate. To move the mouse button over the field named q:

    
<selenium-mouse-move-at
functionId="move the mouse button over the 'q' field"
locator="name=q"
coordinates="5,6" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
coordinates

The coordinates at which to execute the mouse action (relative to the specified field. In the form of (x,y) -- 8,10 for instance. See the Selenium javadocs for more information.

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-out

Simulates a user moving the mouse out of the specified element. To move the mouse out of the field named q:

    
<selenium-mouse-out
functionId="move mouse out of 'q' field"
locator="name=q" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-over

Simulates a user hovering a mouse over the specified element. To hover the mouse over the field named q:

    
<selenium-mouse-over
functionId="hover the mouse over the 'q' field"
locator="name=q" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-up

Simulates a user releasing the mouse button on the specified element. To release the mouse button over the field named q:

    
<selenium-mouse-up
functionId="release the mouse button over the 'q' field"
locator="name=q" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-mouse-up-at

Simulates a user releasing the mouse button on the specified element at a specific coordinate. To release the mouse button over the field named q:

    
<selenium-mouse-up-at
functionId="release the mouse button over the 'q' field"
locator="name=q"
coordinates="5,6" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
coordinates

The coordinates at which to execute the mouse action (relative to the specified field. In the form of (x,y) -- 8,10 for instance. See the Selenium javadocs for more information.

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-open

Navigates the browser to the desired url. To go to www.google.com:

    
<selenium-open
functionId="Goto to http://www.google.com"
url="www.google.com" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
url

The URL to open in the browser. The URL can be either absolute or relative.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-refresh

Simulates the browser "refresh" button.

    
<selenium-refresh

functionId="Hit the browser refresh button" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-remove-selection

Unselects an option in a select field. To unselect the 3rd option in the select field named field1:

    
<selenium-remove-selection
functionId="Unselect the 3rd option"
selectLocator="name=field1"
optionLocator="index=2" />
To unselect the option with the displayed value Choose me in the select field named field1:
    
<selenium-remove-selection
functionId="Unselect the 'Choose me' option"
selectLocator="name=field1"
optionLocator="label=Choose me" />
To unselect the option with the value attribute set to 123 in the select field named field1:
<selenium-remove-selection
functionId="Unselect the 'Choose me' option"
selectLocator="xpath=//select[@name='field1']"
optionLocator="value=123" />
To unselect the option with the id attribute set to 123 in the select field named field1:
<selenium-remove-selection
functionId="Unselect the 'Choose me' option"
selectLocator="dom=document.forms[2].field1"
optionLocator="id=123" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
selectLocator

The locator used to find the select field which value is to be set.

truejava.lang.String
optionLocator

The locator used to find the option to select in the select field. NOTE: This locator format is different from the selectLocator. See the Selenium javadocs for more information. Some possible Option Locator types are label, value, id and index

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-select

Selects an option in a select field. To select the 3rd option in the select field named field1:

    
<selenium-select
functionId="Select the 3rd option"
selectLocator="name=field1"
optionLocator="index=2" />
To select the option with the displayed value Choose me in the select field named field1:
    
<selenium-select
functionId="Select the 'Choose me' option"
selectLocator="name=field1"
optionLocator="label=Choose me" />
To select the option with the value attribute set to 123 in the select field named field1:
    
<selenium-select
functionId="Select the 'Choose me' option"
selectLocator="xpath=//select[@name='field1']"
optionLocator="value=123" />
To select the option with the id attribute set to 123 in the select field named field1:
    
<selenium-select
functionId="Select the 'Choose me' option"
selectLocator="dom=document.forms[2].field1"
optionLocator="id=123" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
selectLocator

The locator used to find the select field which value is to be set.

truejava.lang.String
optionLocator

The locator used to find the option to select in the select field. NOTE: This locator format is different from the selectLocator. See the Selenium javadocs for more information. Some possible Option Locator types are label, value, id and index

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-select-window

Selects a window. After a window is selected, all commands go to that window. To select a window with the name my_popup_window_name:

    
<selenium-select-window
functionId="Select the newly-opened window"
windowName="my_popup_window_name" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
windowName

Name of the window to select

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-session

A Session tag for the Selenium plug-in. An example of its use might:

    
<testcase xmlns="jelly:jameleon">
<selenium-session baseUrl="http://www.google.com" beginSession="true">
<selenium-assert-title-equals
functionId="Check that title is Google."
title="Google"/>
</session-session>
</testcase>

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
baseUrlbaseUrl

falsejava.lang.String
beginAtbeginAt

falsejava.lang.String
browserseleniumBrowser

*firefoxfalsejava.lang.String
multiWindowModeseleniumMultiWindowMode

falsefalseboolean
stopProxyServerOnSessionCloseseleniumStopProxyServerOnSessionClose

falsefalseboolean
startSeleniumProxystartSeleniumProxy

falsefalseboolean
seleniumProxyHostseleniumProxyHost

localhostfalsejava.lang.String
seleniumProxyPortseleniumProxyPort

4444falseint
timeoutSecondsseleniumTimeoutSeconds

1800falseint
slowResourcesModeseleniumSlowResourcesMode

falsefalseboolean
application

The name of the application being run according to the *-TestCaseTag.properties file

falsejava.lang.String
organization

The organization (affiliate or company name) this application will be tested against.

falsejava.lang.String
postcondition

falseboolean
sessionDelay

Sets the tag to delay x milliseconds before anything else is executed.

0falselong
beginSession

Starts the applicattion and gets it to the state defined in the $testEnviroment-Applications.properties. DEFAULTS to false

falseboolean

selenium-submit

Submits a form.

    
<selenium-submit
functionId="Submit the form"
locator="xpath=//form[@name='my_form']" />

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-type

Type text into form fields. To enter test text into a text field named q:

    
<selenium-type
functionId="Enter 'test text' into the 'q' field"
keys="test text"
locator="name=q" />
To do the same, but with XPath instead:
    
<selenium-type
functionId="Enter 'test text' into the 'q' field"
keys="test text"
idenifier="xpath=//input[@name='q'" />
Or to just use the default, you don't need to specify the locatorType
    
<selenium-type
functionId="Enter 'test text' into the 'q' field"
keys="test text"
idenifier="xpath=//input[@name='q'" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
keys

The String to type into the field

truejava.lang.String
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-uncheck

Unchecks a radio button or checkbox. To uncheck a checkbox named cbx_nme:

    
<selenium-uncheck
functionId="Check the checkbox"
locator="cbx_nme" />
To uncheck a radio button named rd_nme via JavaScript DOM:
    
<selenium-uncheck
functionId="Check the radio button"
locator="dom=document.forms[0].rd_nme" />
Refer to the Selenium javadocs for more information.

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-wait-for-condition

Tries to validate a javascript condition during a certain amount of time. If the validation isn't successful after timeout the test is considered 'failed'. This tag is useful in AJAX-like applications where page-contents aren't always directly available after loading a page.

The condition is a (set of) javascript call(s) which can call Selenium functions and webapplication-functions. To get the window of your application, you can use the JavaScript snippet selenium.browserbot.getCurrentWindow(), and then run your JavaScript in there. For more information on syntax of Selenium's javascript functions, please refer to Selenium's API documentation.

To validate the contents of a HTML element with ID SomeElement: (<span id="SomeTable" >some value</span>)

    
<selenium-wait-for-condition
functionId="Validate HTML element contents with ID 'SomeElement' has value 'some value'"
condition="var value = selenium.getValue(\"//span[@id='SomeElement']\"); value.match(\"some value\");">

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
condition

The condition which should return true before timeout

truejava.lang.String
timeoutseleniumWaitForTimeoutSeconds

Amount of milliseconds to wait for the condition.

20000falseint
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong

selenium-wait-for-value

Continually tries to validate the text contents of a HTML element during a certain amount of time. If the validation isn't successful after timeout the test is considered 'failed'. This tag is useful in AJAX-like applications where text-contents aren't always directly available after loading a page.

To validate the contents of a HTML element with ID SomeElement: (<span id="SomeTable" >some value</span>)

    
<selenium-wait-for-value
functionId="Validate HTML element contents with ID 'SomeElement' has value 'some value'"
locator="xpath=//span[@id='SomeElement']"
value="some value">
To use JavaScript for the same element:
    
<selenium-wait-for-value
functionId="Validate HTML element contents with ID 'SomeElement' has value 'some value'"
locator="dom=document.getElementById('SomeElement')"
value="some value">

Take a look at this tag's API docs and source code for more information.

Attribute NameContext NameDescriptionDefaultRequiredType
value

The expected value

truejava.lang.String
timeoutseleniumWaitForTimeoutSeconds

Amount of milliseconds to wait for the value.

20000falseint
locator

The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.

truejava.lang.String
functionId

The id of this function. This is used in the macro as a short description of the function

truejava.lang.String
breakPoint

Tells the GUI to stop at this functional point

falseboolean
precondition

Specifies this is a precondition

falseboolean
postcondition

Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

falseboolean
expectFailure

Specifies a failure is expected.

falseboolean
expectException

Specifies an exception is expected.

falseboolean
functionDelay

The delay time to use at the end of each functional point

-1falselong