SelAnt - write functional tests using Selenium and Ant

Tags in the library

Tag Description
driver Establish connection with WebDriver for perform functional testing
All other SelAnt commands should be sub-tasks of driver command
screenshot Take a screenshot (using Selenium functionality)
browse Open specific URL in browser
answerAlert Check and answer modal alert dialog
wait Container for sub-tasks which should be tested during some times
Key feature of this task - all subtasks won't fail until time is out. If subtasks were executed fine - execution of wait is stopped
Use this task if you need your test to wait until a specific element appear on the screen, etc.
If a sub-task has sub-sub-tasks - these rule is applicable too, for any hierarchy depth
If set of sub-tasks fails more than expected time - the test is considered failed
If wait does not have any sub-tasks - test execution will be just delayed to the timeout time
try Container for sub-tasks which should be tested without affecting the whole test
In other words - if sub-task(s) fails - it does not affect execution the test.
window Task to switch between different browser windows (if the testing application opens multiply)
This task may contain sub-tasks.
If task has sub-tasks and property "handle" is set - sub-tasks will be executed in the browser window identified by this handle
If task has sub-tasks and property "to" is set - sub-tasks will be executed against ALL existing browser windows and the current window handle will be placed into property identified by property "to"
If task has sub-tasks and property "to" is not set - sub-tasks will be executed against default context of the current window
If task has sub-tasks and property "new" is set - new browser window will be opened
If there is no sub-tasks and property "to" is set - the current window handle (String key) will be written into the property with name provided in property "to"
frame Switch Web Driver to a specific Frame/iFrame
Switch Web Driver back the original place after execution
Usually contains subtasks which will be executed inside this specific frame
element Main task for working with DOM elements.
Allows to find an element and perform different operations on it
elementList Select list of elements This task may has sub-tasks. In this case it calls sub-tasks for each element in the list
sequence Container for sub-tasks which will be executed in sequence against list of Elements in the following order
Sub-task 1 against Element 1
Sub-task 2 against Element 2
...
Sub-task N against Element N
If quantity of sub-tasks and elements are different - test fails
hasOption Check that drop-down has an option with the provided text
noOption Check that drop-down does not have an option with the provided text
select Select an option in the drop-down by text of the option
Test fails if there is no such option
click Performs single left mouse click on an Element
mouseout Performs 'mouseout' event on an Element
mouseover Performs 'mouseover' event on an Element
clear Clear value of an element. Makes sense for Input HTML tags.
doubleClick Performs double left mouse click on an Element
rightClick Performs single right mouse click on an Element
sendKeys Sends sequence of characters to an Element. Makes sense for Input type elements.
pressKey Clear value of an element. Makes sense for Input HTML tags.
assertDisplayed Check that the element is Displayed (visible)
assertSelected Check that the element is Selected
assertEnabled Check that the element is Selected
assertText Check that an element inner text matches the provided value
assertStyle Check that an element CSS Style matches the provided value
assertClass Check that an element CSS Class matches the provided value
assertValue Check that an element value matches the provided value
Usually is used against input HTML tags
assertContainsText Check that an element text contains a specific string
assertContainsStyle Check that an element CSS Style contains a specific string
assertContainsClass Check that an element CSS Class contains a specific string
assertContainsValue Check that an element value contains the provided value
Usually is used against input HTML tags
dragAndDrop Performs drag&drop operation
moveMouseTo Performs move mouse pointer to an Element
releaseMouse Release mouse button
clickAndHold Performs left mouse click on an Element and hold the button
javascript Executes JavaScript expression and returns it result as Element or a simple value May contains subtasks, executes them agains Script execution results
selectText Put cursor in a specific position for Input / Textarea
assertSelectValue Get the current selected value from drop-down
assertImageURL Check that an image URL contains a specific string
robot Initiate native Screen iteration
robotClick Click an element on the screen by its image
robotDragAndDrop Click an element on the screen by its image