Selenium Commands

Commands

The following commands are available to create scripts which can be run by our service.

These are mainly Selenium commands but also include some custom commands for our service. The commands have either 0, 1 or 2 arguments, as indicated in the table.

Name Description Arg1 Arg2
Open Open a URL. url – the URL to open; may be relative or absolute
Assert Title Check the title of a web page. the title to check
Click and Wait Click on a link and wait for the page to load locator – an element locator
Click Click on a link in the page. locator – an element locator
Type Type content into a entry box on the web page. locator – an element locator value – the value to type
Wait Wait for a number of seconds time – time to wait in seconds
Capture Screenshot Capture a screenshot of the current page.
Add Selection Add a selection to the set of selected options in a multi-select element using an option locator. locator – an element locator identifying a multi-select box optionLocator – an option locator (a label by default)
Alt Key Down Press the alt key and hold it down until ALTKEYUP is called or a new page is loaded.
Alt Key Up Release the alt key.
Answer on Next Prompt Return the specified answer string in response to the next JavaScript prompt. answer – the answer to give in response to the prompt pop-up
Check Check a toggle-button (checkbox/radio). locator – an element locator
Click At Clicks on a link, button, checkbox or radio button. 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.
Close Simulates the user clicking the “close” button in the titlebar of a popup window or tab.
Control Key Down Press the control key and hold it down until doControlUp() is called or a new page is loaded.
Control Key Up Release the control key.
Double Click Double clicks on a link, button, checkbox or radio button. locator – an element locator
Double Click At Doubleclicks on a link, button, checkbox or radio button. 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.
Drag and Drop Drags an element a certain distance and then drops it. locator – an element locator movementsString – offset in pixels from the current location to which the element should be moved, e.g., “+70,-300″
Drag and Drop to Object Drags an element and drops it on another element. locatorOfObjectToBeDragged – an element to be dragged locatorOfDragDestinationObject – an element whose location (i.e., whose center-most pixel) will be the point where locatorOfObjectToBeDragged is dropped
Fire Event Explicitly simulate an event, to trigger the corresponding “onevent” handler. locator – an element locator eventName – the event name, e.g. “focus” or “blur”
Get Alert Retrieves the message of a JavaScript alert generated during the previous action, or fail if there were no alerts.
Get Confirmation Retrieves the message of a JavaScript confirmation dialog generated during the previous action.
Get Prompt Retrieves the message of a JavaScript question prompt dialog generated during the previous action.
Go Back Simulates the user clicking the “back” button on their browser.
Is Text Present Verifies that the specified text pattern appears somewhere on the rendered page shown to the user. the text that should appear on the page
Key Down Simulates a user pressing a key (without releasing it yet). locator – an element locator keySequence – Either be a string(“\” followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: “w”, “\119″.
Key Press Simulates a user pressing and releasing a key. locator – an element locator keySequence – Either be a string(“\” followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: “w”, “\119″.
Key Up Simulates a user releasing a key. locator – an element locator keySequence – Either be a string(“\” followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: “w”, “\119″.
Mouse Down Simulates a user pressing the mouse button (without releasing it yet) on the specified element. locator – an element locator
Mouse Down At Simulates a user pressing the mouse button (without releasing it yet) at the specified location. 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.
Mouse Move Simulates a user pressing and moving the mouse button (without releasing it yet) on the specified element. locator – an element locator
Mouse Move At Simulates a user pressing and moving the mouse button (without releasing it yet) on the specified element. 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.
Mouse Out Simulates a user moving the mouse pointer away from the specified element. locator – an element locator
Mouse Over Simulates a user hovering a mouse over the specified element. locator – an element locator
Mouse Up Simulates the event that occurs when the user releases the mouse button (i.e., stops holding the button down) on the specified element. locator – an element locator
Mouse Up At Simulates the event that occurs when the user releases the mouse button (i.e., stops holding the button down) at the specified location. 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.
Open Window Opens a popup window (if a window with that ID isn’t already open). url – the URL to open, which can be blank windowID – the JavaScript window ID of the window to select
Refresh Simulates the user clicking the “Refresh” button on their browser.
Remove All Selections Unselects all of the selected options in a multi-select element. locator – an element locator identifying a multi-select box
Remove Selection Remove a selection from the set of selected options in a multi-select element using an option locator. locator – an element locator identifying a multi-select box optionLocator – an option locator (a label by default)
Select Select an option from a drop-down using an option locator. locator – an element locator identifying a multi-select box optionLocator – an option locator (a label by default)
Shift Key Down Press the shift key and hold it down until SHIFTKEYUP is called or a new page is loaded.
Shift Key Up Release the shift key.
Submit Submit the specified form. formLocator – an element locator for the form you want to submit
Type Keys Simulates keystroke events on the specified element, as though you typed the value key-by-key. locator – an element locator value – the value to type
Uncheck Uncheck a toggle-button (checkbox/radio) locator – an element locator
Append Append content to a entry box on the web page. The new content is added to the end of the existing content. locator – an element locator value – the content to append
Dummy A dummy command that does not do anything.
Unsupported Commands that are not recognised when a script is uploaded, are mapped to this.
Select Frame Selects a frame within the current window. locator – an element locator identifying a frame or iframe
Select Window Selects a popup window; once a popup window has been selected, all commands go to that window. windowID – the JavaScript window ID of the window to select
Window Focus Gives focus to the currently selected window
Store Alert Stores the message of the most recent JavaScript alert.
Cancel On Next Simulate the user clicking Cancel to the next Confirmation.
OK On Next Undo the effect of calling ‘Cancel On Next’.
Create Cookie Create a new cookie whose path and domain are same with those of current page under test, unless you specified a path for this cookie explicitly. nameValuePair – name and value of the cookie in a format “name=value” optionsString – options for the cookie. Currently supported options include ‘path’ and ‘max_age’. the optionsString’s format is “path=/path/, max_age=60″. The order of options are irrelevant, the unit of the value of ‘max_age’ is second.
Delete Cookie Delete a named cookie with specified path. name – the name of the cookie to be deleted. path – the path property of the cookie to be deleted.
Meta Key Down Press the meta key and hold it down until ‘Meta Key Up’ command is called or a new page is loaded.
Meta Key Up Release the meta key.
Pause Wait for the specified amount of time (in milliseconds). waitTime – the amount of time to sleep (in milliseconds).
Set Cursor Position Moves the text cursor to the specified position in the given input element or textarea. This method will fail if the specified element isn’t an input element or textarea. locator – an element locator pointing to an input element or textarea. position – the numerical position of the cursor in the field; position should be 0 to move the position to the beginning of the field. You can also set the cursor to -1 to move it to the end of the field.
Set Mouse Speed Configure the number of pixels between “mousemove” events during dragAndDrop commands (default=10). pixels – the number of pixels between “mousemove” events.
Set Speed Set execution speed (i.e., set the millisecond length of a delay which will follow each selenium operation). By default, there is no such delay, i.e., the delay is 0 milliseconds. value – the number of milliseconds to pause after operation.
Wait For Frame To Load Waits for a new frame to load. frameAddress – FrameAddress from the server side. timeout – a timeout in milliseconds, after which this command will return with an error.
Wait For Page To Load Waits for a new page to load. timeout – a timeout in milliseconds, after which this command will return with an error.
Wait For PopUp Waits for a popup window to appear and load up. windowID – the JavaScript window ID of the window that will appear. timeout – a timeout in milliseconds, after which the action will return with an error.
Assert Text Present Asserts if the specified text IS NOT present on the page. the text that should appear on the page
Assert Text Not Present Asserts if the specified text IS present on the page. the text that should NOT appear on the page
Verify Text Present Verifies that the specified text IS present – if it is not, it is an error. the text that should appear on the page
Verify Text Not Present Verifies that the specified text IS NOT present – if it is, it is an error. the text that should NOT appear on the page
Assert Pattern Asserts that a pattern IS present within the page source. the pattern that should appear within the page source
Assert No Pattern Asserts that a pattern IS NOT present within the page source. the pattern that should NOT appear within the page source
Cloud Testing Internal Command Internal Cloud Testing Command – DO NOT USE n/a n/a
Assert Value Asserts that the value of the specified input field matches the pattern specified. locator – an element locator pointing to an input element the text or pattern that should appear in the input field
Assert Not Value Asserts that the value of the specified input field DOES NOT match the pattern specified. locator – an element locator pointing to an input element the text or pattern that should NOT appear in the input field
Verify Value Verifies that the value of the specified input field matches the pattern specified. locator – an element locator pointing to an input element the text or pattern that should appear in the input field
Verify Not Value Verifies that the value of the specified input field DOES NOT match the pattern specified. locator – an element locator pointing to an input element the text or pattern that should NOT appear in the input field
Assert Checked Asserts that the toggle-button is checked. locator – an element locator pointing to a toggle-button.
Assert Not Checked Asserts that the toggle-button is NOT checked. locator – an element locator pointing to a toggle-button.
Verify Checked Verifies that the toggle-button is checked. locator – an element locator pointing to a toggle-button.
Verify Not Checked Verifies that the toggle-button is NOT checked. locator – an element locator pointing to a toggle-button.
Assert Tex Asserts that the text is present at the specific locator. locator – an element locator pointing to an element that contains text. the text or pattern that should appear
Assert Not Text Asserts that the text is NOT present at the specific locator. locator – an element locator pointing to an element that contains text. the text or pattern that should NOT appear
Verify Text Verifies that the text is present at the specific locator. locator – an element locator pointing to an element that contains text. the text or pattern that should appear
Verify Not Text Verifies that the text is NOT present at the specific locator. locator – an element locator pointing to an element that contains text. the text or pattern that should NOT appear
Assert Alert Asserts that the value of the alert matches the pattern specified. the pattern that should appear as the alert
Assert Alert Not Present Asserts if an alert is not present
Assert Alert Present Asserts if an alert is present
Store Alert Present Returns if an alert was present or not. a dummy variable – the value is NOT stored into it
Verify Alert Verifies that the value of the alert matches the pattern specified. the pattern that should appear as the alert
Verify Alert Not Present Verifies that an alert IS NOT present.
Verify Alert Present Verifies that an alert IS present.
Wait For Alert Waits for the alert matching the pattern to appear. the pattern that should appear as the alert
Wait For Alert Not Present Waits for an alert not present
Wait For Alert Present Waits for an alert to be present
Assert Confirmation Asserts that the value of the confirmation matches the pattern specified. the pattern that should appear as the confirmation.
Assert Confirmation Not Present Asserts if a confirmation is NOT present.
Assert Confirmation Present Asserts if a confirmation is present.
Store Confirmation Stores the message from the most recent confirmation.
Store Confirmation Present Returns if an confirmation was present or not. a dummy variable – the value is NOT stored into it
Verify Confirmation Verifies that the value of the confirmation matches the pattern specified. the pattern that should appear as the confirmation.
Verify Confirmation Not Present Verifies if a confirmation is NOT present.
Verify Confirmation Present Verifies if a confirmation is present.
Wait For Confirmation Waits for the confirmation matching the pattern to appear. the pattern that should appear as the confirmation.
Wait For Confirmation Not Present Waits for a confirmation not to be present.
Wait For Confirmation Present Waits for a confirmation to be present.

This reflects the commands available in version 1.4.10 of the Cloud Testing software release. Subscribers to the Cloud Testing service can view an up-to-date list of commands at the Cloud Testing results portal (http://portal.cloudtesting.com/)

For examples on how to use the commands, see the How To Guides.