Selenese (Selenium IDE) Commands Reference

addLocationStrategy(strategyName, functionDefinition)

Arguments:

*strategyName - the name of the strategy to define; this should use only letters [a-zA-Z] with no spaces or other punctuation.
*functionDefinition - a string defining the body of a function in JavaScript. For example: return inDocument.getElementById(locator);
Defines a new function for Selenium to locate elements on the page. For example, if you define the strategy "foo", and someone runs click("foo=blah"), we'll run your function, passing you the string "blah", and click on the element that your function returns, or throw an "Element not found" error if your function returns null. We'll pass three arguments to your function:

• locator: the string the user passed in
• inWindow: the currently selected window
• inDocument: the currently selected document

addLocationStrategyAndWait(strategyName, functionDefinition)
Generated from addLocationStrategy(strategyName, functionDefinition)

Arguments:

• strategyName - the name of the strategy to define; this should use only letters [a-zA-Z] with no spaces or other punctuation.
• functionDefinition - a string defining the body of a function in JavaScript. For example: return inDocument.getElementById(locator);

• locator: the string the user passed in
• inWindow: the currently selected window
• inDocument: the currently selected document

addScript(scriptContent, scriptTagId)

Arguments:
*scriptcontent - the Javascript content of the script to add
*scriptTagId - (optional) the id of the new script tag. If specified, and an element with this id already exists, this operation will fail.

Loads script content into a new script tag in the Selenium document. This differs from the runScript command in that runScript adds the script tag to the document of the AUT, not the Selenium document. The following entities in the script content are replaced by the characters they represent: < > & The corresponding remove command is removeScript.

addSelection(locator, optionLocator)
Arguments:
*locator - an element locator identifying a multi-select box
*optionLocator - an option locator (a label by default) 

Add a selection to the set of selected options in a multi-select element using an option locator. @see #doSelect for details of option locators

addSelectionAndWait(locator, optionLocator)
Generated from addSelection(locator, optionLocator)
Arguments:
*locator - an element locator identifying a multi-select box
*optionLocator - an option locator (a label by default) 

Add a selection to the set of selected options in a multi-select element using an option locator. @see #doSelect for details of option locators

allowNativeXpath(allow)
Arguments:
*allow - boolean, true means we'll prefer to use native XPath; false means we'll only use JS XPath

Specifies whether Selenium should use the native in-browser implementation of XPath (if any native version is available); if you pass "false" to this function, we will always use our pure-JavaScript xpath library. Using the pure-JS xpath library can improve the consistency of xpath element locators between different browser vendors, but the pure-JS version is much slower than the native implementations.

allowNativeXpathAndWait(allow)
Generated from allowNativeXpath(allow)
Arguments:
*allow - boolean, true means we'll prefer to use native XPath; false means we'll only use JS XPath 

Specifies whether Selenium should use the native in-browser implementation of XPath (if any native version is available); if you pass "false" to this function, we will always use our pure-JavaScript xpath library. Using the pure-JS xpath library can improve the consistency of xpath element locators between different browser vendors, but the pure-JS version is much slower than the native implementations.

altKeyDown()

Press the alt key and hold it down until doAltUp() is called or a new page is loaded.

altKeyDownAndWait() Generated from altKeyDown()

Press the alt key and hold it down until doAltUp() is called or a new page is loaded.

altKeyUp()

Release the alt key.

altKeyUpAndWait()

Generated from altKeyUp()

Release the alt key.

answerOnNextPrompt(answer)
Arguments:
*answer - the answer to give in response to the prompt pop-up

assertAlert(pattern)
Generated from getAlert().
Returns: The message of the most recent JavaScript alert 

Retrieves the message of a JavaScript alert generated during the previous action, or fail if there were no alerts.

Getting an alert has the same effect as manually clicking OK. If an alert is generated but you do not consume it with getAlert, the next Selenium action will fail.

Under Selenium, JavaScript alerts will NOT pop up a visible alert dialog.

Selenium does NOT support JavaScript alerts that are generated in a page's onload() event handler. In this case, a visible dialog WILL be generated and Selenium will hang until someone manually clicks OK.

assertAlertAndWait(pattern)
Generated from getAlert().
Returns: The message of the most recent JavaScript alert 

Retrieves the message of a JavaScript alert generated during the previous action, or fail if there were no alerts.

Getting an alert has the same effect as manually clicking OK. If an alert is generated but you do not consume it with getAlert, the next Selenium action will fail.

Under Selenium, JavaScript alerts will NOT pop up a visible alert dialog.

Selenium does NOT support JavaScript alerts that are generated in a page's onload() event handler. In this case a visible dialog WILL be generated and Selenium will hang until someone manually clicks OK.

assertAlertNotPresent()
Generated from isAlertPresent().
Returns: true if there is an alert 

Has an alert occurred?

This function never throws an exception

assertAlertPresent()
Generated from isAlertPresent().
Returns: true if there is an alert 

Has an alert occurred?

This function never throws an exception

assertAllButtons(pattern)
Generated from getAllButtons().
Returns: the IDs of all buttons on the page

Returns the IDs of all buttons on the page.

If a given button has no ID, it will appear as "" in this array.

assertSomethingSelected(selectLocator)
Generated from isSomethingSelected(selectLocator)

Arguments:

*selectLocator - an element locator identifying a drop-down menu .
Returns: true if some option has been selected, false otherwise 

assertText(locator, pattern)
Generated from getText(locator)

Arguments:
*locator - an element locator .
Returns: the text of the element 

click(locator)
Arguments:
*locator - an element locator

Clicks on a link, button, checkbox or radio button. If the click action causes a new page to load (like a link usually does), call waitForPageToLoad.

clickAndWait(locator)
Generated from click(locator)
Arguments:
*locator - an element locator

Clicks on a link, button, checkbox or radio button. If the click action causes a new page to load (like a link usually does), call waitForPageToLoad.

clickAt(locator, coordString)
Arguments:
*locator - an element locator
*coordString - specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.

Clicks on a link, button, checkbox or radio button. If the click action causes a new page to load (like a link usually does), call waitForPageToLoad.

clickAtAndWait(locator, coordString)
Generated from clickAt(locator, coordString)
Arguments:
*locator - an element locator
*coordString - specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.

Clicks on a link, button, checkbox or radio button. If the click action causes a new page to load (like a link usually does), call waitForPageToLoad.