DownloadFile
This action clicks the link/element which will populate a download window, and then downloads the file.
The action supports and is explicitly tested for FF3, IE7, IE8. The action will not wait till the file is downloaded, this have to be handle externally by the user.
This action requires AutoIt to be installed.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- After the set up is completed, AutoIT installation path should be set against the Qualitia's configfile key "AutoITPath"
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
folderName
The path where the file is to be download. Please check Table 1 "Parameter Mandate" to validate in the situation where this parameter will be mandatory. In case the parameter Mandatory; the user should take care that the folder path exists. The action does not validates whether the folder exist
Yes
String
Filename
The filename of the downloadable file, to be given incase the user requires to give specific name and not depend on the default name of the file. In case, the file already exist, similar window like below will appear. Such windows are not handled by the action. Incase, the user does not provide this data, the action will pick the default file name available while download. This parameter is not mandatory
Yes
String
title | Important Notes: |
---|
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads.
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669
2. When a download window is populated, the following window will also exist.
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.
Important Notes for Firefox:
Firefox uses the default Firefox instance:-
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
Table 1: Parameter Mandate
Browser
locator
folderPath
fileName
Internet Explorer
Mandatory
Mandatory
Not mandatory
Above is the default download setting in the default Firefox instance invoke my Selenium.
Mandatory
Mandatory
Not mandatory
DownloadFile "C:/ProgramData" "Qualitia"
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.
On this page:
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
VerifyExistence
This action verifies the existence of the specified object.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
existence
Data type of this parameter is can be true or false.
If True – checks if the page exists
If False – checks if the page does not exist
Yes
TRUE
Example:
VerifyExistence "True"
VerifyVisibility
This action verifies the visibility of the specified object.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
visibility
Data type of this parameter is can be true or false.
If True – checks if the page is visible
If False – checks if the page is not visible
Yes
String
Example
VerifyVisibility "True"
Click
This action clicks the specified object
Example:
Click
StorePropertyValue
This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
key
Variable in which the property value will be stored
Yes
String
Property
Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.
Yes
String
Example:
StorePropertyValue "value" "name"
MouseOver
This action simulates the user hovering mouse over the specified object.
Example:
MouseOver
MouseDown
This action simulates user pressing the left mouse button at the specified locationDragAndDropToOffset
This action drags and drops the specified web element at the specified location.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
offsetX | Enter the offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10, and so on. | Yes | String |
offsetY | Enter the offset in pixels from the current location to which the element should be moved. The offset parameter can be as -100,100 , +100, and so on. | Yes | String |
Example:
DragAndDropOffset "100" "500"
MouseDown
This action simulates left-click at the specified location on the screen.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
X | The x-coordinate of the click. | Yes | String |
Y | The y-coordinate of the click. | Yes | String |
Example:
MouseDown "5" "10"
MouseOver
This action simulates a mouse hovering over the specified object.
This action does not have any parameter.
Example:
MouseOver
MouseUp
This action simulates the event that occurs when the user releases the mouse button.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
X | The x-coordinate of the click. | Yes | String |
Y | The y-coordinate of the click. | Yes | String |
Example
MouseUp "5" "10"
RightClick
This action right-clicks the specified web element.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
option | The context menu option number that needs to be clicked. | Yes | String |
Example:
RightClick "3''
This will select the third option from the context-menu.
ScrollIntoView
This action scrolls to view the specified object.
This action does not have any parameter.
Example:
ScrollIntoView
SetFocus
This action sets the focus on the specified object.
This action does not have any parameter.
Example:
SetFocus
StoreChildCount
This action stores the child count of the specified object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
Key | Enter the key name under which the child count will be saved. | Yes | String |
Example:
StoreChildCount "Key"
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
Key | Enter the key name under which the existence's Boolean value will be stored.
| Yes | String |
Example:
StoreExistence "Key"
StorePropertyValue
This action stores the property of the specified object under the key name. The stored key value can be retrieved using the key name.
Some Android and iOS properties are not accessible.
List of accessible properties for Android: "name", "contentDescription", "className", "resourceId", "text", "enabled", "checkable", "checked", "clickable", "focusable", "focused", "longClickable", "scrollable", "selected", "displayed"
List of accessible properties for iOS: "name", "value", "label", "hint"
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
Key | Enter the key name under which the property value will be stored. | Yes | String |
Property | Property/attribute name whose value needs to be stored under the specified key. This can be any accessible property of Android/iOS native object mentioned above. | Yes | String |
Example:
StorePropertyValue "key" "text"
VerifyEnability
This action verifies the enability of the specified object.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
enability | Value for this parameters can be true or false.
| Yes | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
existence | Value for this parameters can be true or false.
| Yes | String |
Example:
VerifyExistence "True"
VerifyVisibility
This action verifies the visibility of the specified object.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
visibility | Value for this parameters can be true or false.
| Yes | String |
Example:
VerifyVisibility "True"
StoreText
This action stores the text existing inside the specified object under the specified keys. The key values can be retrieved using the key names.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
keyText | Enter the key name to store the text from the specified object. | Yes | String |
Example:
StoreText "Key"
StoreLocation
This action stores the current location of the object under the specified keys. The key values can be retrieved using the key names.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
keyHeight | Enter the key name to store the height of the location of the object. | Yes | String |
keyWidth | Enter the key name to store the width of the location of the object. | Yes | String |
Example:
StoreLocation "Height" "Width"
StoreCSSProperty
This action stores the CSS property value of the object under the specified key. Key value can be retrieved using the key name.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
property | Enter the property name whose value you want to store. | Yes | String |
keyProperty | Enter the key name under which the property value will be stored. | Yes | String |
Example:
StoreCSSProperty "display" "Key"
StoreSize
This action stores the size of the specified object under keys. The key values can be retrieved using key names.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
keyXPosition | Enter the key name under which you want to store the height of the object. | Yes | String |
keyYPosition | Enter the key name under which you want to store the width of the object. | Yes | String |
Example:
StoreSize "Height" "Width"
Multiexcerpt include macro name SendKeySequence page WebEdit Actions
SetValueAttribute
This action sets the data specified in the 'value' attribute of the object.
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
value | Enter the value to be added for the Value attribute. | Yes | String |
Example:
SetValueAttribute "#ff0990"
StoreValueAttribute
This action stores the data present in the 'value' attribute of the object.
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
key | Enter the key name under which the value will be stored. Enter the value to be added for the Value attribute.Key value can be retried using the key name. | Yes | String |
Example:
StoreValueAttribute "Key"
WaitForStaleness
This action waits until the element gets detached from the DOM.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the value to be detached. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for existence of the element before exhausting timeout. | No | String |
keyStatus | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForStaleness "5" "500" "Key" "Defect"
WaitForAttributeContains
This action waits till the value of the specified attribute changes to the expected partial value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
attributeName | Enter the attribute name whose value you want to check. | Yes | String |
attributeValue | Enter the partial expected partial attribute value. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the expected value. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. | No | String |
keyAttributeValueContains | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForAttributeContains "id" "we323es" "5" "500" "Key" "Defect"
WaitForAttributeNotContains
This action waits until the specified attribute's value of the object changes to other than the partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
attributeName | Enter the attribute name whose value you want to check. | Yes | String |
attributeValue | Enter the value which should not be there in the attribute value. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the value to change. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for existence of the unexpected value before exhausting timeout. | No | String |
keyAttributeValue | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForAttributeValueContains "id" "232waf" "5" "500" "Key" "Defect"
WaitForAttributeToBe
This action waits till the value of the specified attribute changes to the exact expected value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
attributeName | Enter the attribute name whose value you want to check. | Yes | String |
attributeValue | Enter the exact expected value. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the expected value. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. | No | String |
keyAttributeValue | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForAttributeToBe "id" "232waf" "5" "500" "Key" "Defect"
WaitForAttributeNotToBe
This action waits until the specified attribute's value of the object changes to other than the exact parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
attributeName | Enter the attribute name whose value you want to check. | Yes | String |
attributeValue | Enter the value which should not be there in the attribute value. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the value to change. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. | No | String |
keyAttributeValueNotToBe | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForAttributeNotToBe "id" "232waf" "5" "500" "Key" "Defect"
WaitForAttributeNotToBeEmpty
This action waits until the specified attribute's value of the object gets filled with some value. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
attributeName | Enter the attribute name whose value you want to check. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the attribute value. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the attribute value before exhausting timeout. | No | String |
keyAttributeValue | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForAttributeNotToBeEmpty "id" "5" "500" "Key" "Defect"
WaitForAttributeToBeEmpty
This action waits until the specified attribute's value of the object gets empty. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
attributeName | Enter the attribute name whose value you want to check. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the attribute value to be empty. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the attribute value before exhausting timeout. | No | String |
keyAttributeValue | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForAttributeToBeEmpty "id" "5" "500" "Key" "Defect"
WaitForClickability
This action waits for the specified object to be clickable. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the object to be clickable. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the object clickability before exhausting timeout. | No | String |
keyClickability | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForClickability "5" "500" "Key" "Defect"
WaitForExistence
This action waits for the existence of the specified object. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the existence of the object. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the existence of the object before exhausting timeout. | No | String |
keyExistence | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForExistence "5" "500" "Key" "Defect"
WaitForInnerTextContains
This action waits for the object to contain the expected partial text. The comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
innerText | Enter the expected text you want to wait for. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the expected text. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the expected text before exhausting timeout. | No | String |
keyInnerTextContains | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForInnerTextContains "Connect" "5" "500" "Key" "Defect"
WaitForInnerTextMatchesPattern
This action waits for inner text from the specified object to match the expected text regular expression pattern. The comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
innerTextRegXPattern | Enter the expected pattern for the inner text. Pattern should be regular expression. Step fails in case the pattern is invalid. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the expected text. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the expected text before exhausting timeout. | No | String |
keyInnerText | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForInnerTextMatchesPattern ".[My]text." "5" "500" "Key" "Defect"
WaitForInnerTextNotContains
This action waits until the specified attribute's value of the object changes to other than the parameterized value. The comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
innerText | Enter the text which should not be there in the attribute value. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the inner text to disappear. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the expected text to be disappeared before exhausting timeout. | No | String |
keyInnerTextNotContains | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForInnerTextNotContains "Connect" "5" "500" "Key" "Defect"
WaitForInnerTextNotToBe
This action waits till the inner text of the object changes from the specified text. The comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
innerText | Enter the text which should not be there in the object. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the text to change. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the expected text before exhausting timeout. | No | String |
keyInnerTextNotToBe | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForInnerTextNotToBe "Connect" "5" "500" "Key" "Defect"
WaitForInnerTextToBe
This action waits for the object to contain the expected exact text. The comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
innerText | Enter the expected text you want to wait for. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the expected text. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the expected text before exhausting timeout. | No | String |
keyInnerText | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForInnerTextToBe "Connect" "5" "500" "Key" "Defect"
WaitForInvisibility
This action waits for the object to invisible. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the object to go invisible. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the invisibility before exhausting timeout. | No | String |
keyInvisibility | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForInvisibility "5" "500" "Key" "Defect"
WaitForNonClickability
This object waits for the object to become non clickable. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the object to become non clickable. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the clickability before exhausting timeout. | No | String |
keyNonClickability | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForNonClickability "5" "500" "Key" "Defect"
WaitForNonExistence
This action waits for the non existence of the specified object. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the non existence of the object. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for non existence of the object before exhausting timeout. | No | String |
keyNonExistence | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForNonExistence "5" "500" "Key" "Defect"
WaitForVisibility
This action waits for the object to be visible. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
timeOut | Enter the timeout (in seconds) to wait for the object visibility. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the object visibility before exhausting timeout. | No | String |
keyVisibility | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForVisibility "5" "500" "Key" "Defect"
WaitForNumberOfElementsToBe
This action waits for the number of elements of the specified object locator on the page to be same as the expected number. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|
X
number | Enter the expected number of elements to wait for. | Yes |
Integer |
Y
The Y-coordinate to click.
Yes
String
Example:
MouseDown "5" "10"
MouseUp
This action simulates the event that occurs when the user releases the mouse button.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
X
The x-coordinate to click.
Yes
String
Y
The Y-coordinate to click.
Yes
String
Example:
MouseUp "50" "38"
ClickAt
This action clicks at the particular point on the object.
timeOut | Enter the timeout (in seconds) to wait for the number elements to appear. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the objects before exhausting timeout. | No | String |
keyNumberOfElements | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForNumberOfElementsToBe "2" "5" "500" "Key" "Defect"
WaitForNumberOfElementsToBeLessThan
This action waits for the number of elements of the specified object locator on the page to be less than the specified number. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|
X
The x-coordinate to click.
Yes
String
Y
expectedNumOfElements | Enter the expected number of elements to wait for. | Yes | String |
Example:
ClickAt "60" "67"
SetFocus
This action moves the focus to the specified web element.
Example:
SetFocus
DoubleClick
This action double-clicks the particular web element.
Example:
DoubleClick
RightClick
This action right-clicks the specified web element.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
option
The context menu option number that needs to be clicked.
Yes
String
Example:
RightClick "3''
This will select the third option from the context-menu.
WaitForObject
This action waits for the object to exist or not exist for the maximum no of seconds specified.
If the object is found or not found before the maximum time specified, the action shall stop waiting.
If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) windowtimeOut | Enter the timeout (in seconds) to wait for the number elements to appear. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the objects before exhausting timeout. | No | Integer |
keyNumOfElementsLessThan | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForNumberOfElementsToBeLessThan "2" "5" "500" "Key" "Defect"
WaitForNumberOfElementsToBeMoreThan
This action waits for the number of elements of the specified object locator on the page to be more than the specified number. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter |
---|
Mandatory
Data Type
waitTime
The maximum no of seconds to wait for the object to exist or not exist
This has to be 0 ,"",or a positive integer value
Yes
String
existence
Boolean value to specify if the object should exist or not.
Yes
String
WaitForObject
Description | Mandatory | Data Type | |
---|---|---|---|
expectedNumOfElements | Enter the expected number of elements to wait for. | Yes | Integer |
timeOut | Enter the timeout (in seconds) to wait for the number elements to appear. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the objects before exhausting timeout. | No | String |
keyNumOfElementsLessThan | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForNumberOfElementsToBeMoreThan "2" "105" "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.WaitForObject 500" "15Key" "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.
ClickAndWait
This action clicks the page object and waits.It waits for the maximum sync time set in the Qualitia Configuration (Execution) window for key Sync Time. If the page page loads before the maximum sync time, then the action will stop waiting.
Example:
ClickAndWait
Note |
---|
In Webdriver we wait for the document to come in ready state. If it is in ready state it is assumed that the page is loaded completely and Webdriver will stop waiting. The condition to wait till the document is in ready state and assume that the page is loaded could however not work as expected at all times. |
DragAndDrop
This action drags and drops the specified web element at the specified location.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
offsetX
Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…
Yes
String
offsetY
offset in pixels from the current location to which the element should be moved The offset parameter can be as -100,100 , +100
Yes
String
Example:
DragAndDrop "-100" "500"
StoreExistence
This action stores the existence of an object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
Parameter Name
Parameter Description
Mandatory
Data Type
Key
The variable in which the existence (true/false) of the object is stored.
Yes
String
Example:
StoreExistence "Key"
StoreChildCount
This action stores the child count of the specified object under the key name. The key value can be retrieved using the key name"Defect"
WaitForChildElement
This action waits for the child elements of the specified object to appear. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
childLocatorType | Enter the locator type of the object whose child you want to check. | Yes | String |
childLocatorValue | Enter the locator value of the child you want to check. | Yes | String |
timeOut | Enter the timeout (in seconds) to wait for the elements to appear. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the objects before exhausting timeout. | No | String |
keyExistence | Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect. | No | String |
statusIfConditionNotSatisfied | Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect. | No | String |
Example:
WaitForChildElement "id" "2" "5" "500" "Key" "Defect"
ClickAndWait (Deprecated)
This action clicks the specified object and waits for the seconds specified in Sync Time under the Configuration Settings (Execution) window.
Default value is 20 seconds. If the page loads before reaching the maximum sync time execution continues to the next steps.
This action does not have any parameter.
Example:
ClickAndWait
Webdriver waits for the document to come in ready state. If it is in ready state it is assumed that the page is loaded completely and Webdriver stops waiting. The condition to wait till the document to load in ready state and assume that the page is loaded could however not work as expected at all times.
WaitForObject (Deprecated)
This action waits for the object to appear or disappear for the maximum number of seconds specified.
If the object is found or not found before the maximum time specified, execution continues to the next steps.
If the wait time is "" then the wait time shall be the "Sync Time" set under the Configuration Settings (Execution) window.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|
Key
waitTime | Enter the number of seconds to wait for the object to appear or disappear. This has to be 0 or any positive number. | Yes | String |
existence | Value for this parameter can be true or false.
| Yes | String |
Example:
StoreChildCount WaitForObject "10" "true"
The action waits for maximum 10 seconds for the object to appear. If the object appears before 10 seconds elapses, execution continues to the next steps.
WaitForObject "15" "Key"
ScrollIntoView
This action scrolls to view the specified object.
This action does not have any parameters.
Example:
ScrollIntoView
Insert excerpt
The action shall wait for maximum 15 seconds for the object to disappear. If the object disappears before 15 seconds elapses,execution continues to the next steps.