Jameleon - Selenium Plug-in - Syntax Reference

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

Tag	Short 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 Name	Description	Default	Required	Type
selectLocator	The locator used to find the select field which value is to be set.		true	java.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		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
answer	The response to give the next prompt		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
expected	The error message to output if the validation fails.		false	boolean
msg	The error message to output if the validation fails.		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
msg	The error message to output if the validation fails.		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
value	The expected value of the field		false	java.lang.String
msg	The error message to output if the validation fails.		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
expected	The error message to output if the validation fails.		false	boolean
msg	The error message to output if the validation fails.		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
msg	The error message to output if the validation fails.		false	java.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.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
title	The expected title of the page		true	java.lang.String
msg	The error message to output if the validation fails.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
expected	The error message to output if the validation fails.		false	boolean
msg	The error message to output if the validation fails.		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
waitForPageToLoad	The max number of milliseconds to wait for the page to load		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
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.		true	java.lang.String
waitForPageToLoad	The max number of milliseconds to wait for the page to load		false	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
nameValuePair	Name value pair in the form "name=value"		true	java.lang.String
optionsString	Options string. Currently path and max_age are supported by Selenium		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
name	Name of the cookie to delete		true	java.lang.String
path	Path of the cookie to delete		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
eventName	The name of the event to fire. For example, onblur's event name would be blur		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
attribute	The attribute to get from all windows. Examples include title, id, name		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
script	The script to evaluate		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
contextVariable	The context variable to put the alert text in. If this is not defined then the value will not be stored.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
keycode	The numeric keycode of the key to be pressed, normally the ASCII value of that key.		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
keycode	The numeric keycode of the key to be pressed, normally the ASCII value of that key.		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
keycode	The numeric keycode of the key to be pressed, normally the ASCII value of that key.		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
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.		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
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.		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
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.		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
url	The URL to open in the browser. The URL can be either absolute or relative.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
selectLocator	The locator used to find the select field which value is to be set.		true	java.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		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
selectLocator	The locator used to find the select field which value is to be set.		true	java.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		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
windowName	Name of the window to select		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Context Name	Description	Default	Required	Type
baseUrl	baseUrl			false	java.lang.String
beginAt	beginAt			false	java.lang.String
browser	seleniumBrowser		*firefox	false	java.lang.String
multiWindowMode	seleniumMultiWindowMode		false	false	boolean
stopProxyServerOnSessionClose	seleniumStopProxyServerOnSessionClose		false	false	boolean
startSeleniumProxy	startSeleniumProxy		false	false	boolean
seleniumProxyHost	seleniumProxyHost		localhost	false	java.lang.String
seleniumProxyPort	seleniumProxyPort		4444	false	int
timeoutSeconds	seleniumTimeoutSeconds		1800	false	int
slowResourcesMode	seleniumSlowResourcesMode		false	false	boolean
application		The name of the application being run according to the *-TestCaseTag.properties file		false	java.lang.String
organization		The organization (affiliate or company name) this application will be tested against.		false	java.lang.String
postcondition				false	boolean
sessionDelay		Sets the tag to delay x milliseconds before anything else is executed.	0	false	long
beginSession		Starts the applicattion and gets it to the state defined in the $testEnviroment-Applications.properties. DEFAULTS to `false`		false	boolean

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
keys	The String to type into the field		true	java.lang.String
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Description	Default	Required	Type
locator	The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

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 Name	Context Name	Description	Default	Required	Type
condition		The condition which should return true before timeout		true	java.lang.String
timeout	seleniumWaitForTimeoutSeconds	Amount of milliseconds to wait for the condition.	20000	false	int
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

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 Name	Context Name	Description	Default	Required	Type
value		The expected value		true	java.lang.String
timeout	seleniumWaitForTimeoutSeconds	Amount of milliseconds to wait for the value.	20000	false	int
locator		The locator of the field. An example might be xpath=//input[@name='field_name'] See the Selenium javadocs for more information.		true	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

Selenium Plug-in

Getting Started

Technical Documents

Project Documentation

Available Tags

Selenium Plug-in Tags

selenium-add-selection

selenium-answer-on-next-prompt

selenium-assert-editable

selenium-assert-element-present

selenium-assert-field-value-equals

selenium-assert-something-selected

selenium-assert-text-present

selenium-assert-title-equals

selenium-assert-visible

selenium-check

selenium-choose-cancel-on-next-confirmation

selenium-click

selenium-click-at

selenium-close

selenium-create-cookie

selenium-delete-cookie

selenium-fire-event

selenium-get-alert

selenium-get-all-buttons

selenium-get-all-fields

selenium-get-all-links

selenium-get-all-window-ids

selenium-get-all-window-names

selenium-get-all-window-titles

selenium-get-attribute

selenium-get-attribute-from-all-windows

selenium-get-confirmation

selenium-get-cookie

selenium-get-element-height

selenium-get-element-position-left

selenium-get-element-position-top

selenium-get-element-width

selenium-get-eval

selenium-get-location

selenium-get-select-options

selenium-get-selected-id

selenium-get-selected-ids

selenium-get-selected-index

selenium-get-selected-indexes

selenium-get-selected-label

selenium-get-selected-labels

selenium-get-selected-value

selenium-get-selected-values

selenium-get-text

selenium-get-title

selenium-get-value

selenium-go-back

selenium-key-down

selenium-key-press

selenium-key-up

selenium-mouse-down

selenium-mouse-down-at

selenium-mouse-move

selenium-mouse-move-at

selenium-mouse-out

selenium-mouse-over

selenium-mouse-up

selenium-mouse-up-at

selenium-open

selenium-refresh

selenium-remove-selection

selenium-select

selenium-select-window

selenium-session

selenium-submit

selenium-type

selenium-uncheck

selenium-wait-for-condition

selenium-wait-for-value