WebList Actions
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
ClickAction
This action clicks the specified object from the web application under test.
This action does not have any parameter.
Note: ActionClick uses underlying selenium WebDriver "Action" class to perform click action. Qualitia recommends using this action for web applications.
Example:
ClickAction
ClickAt
This action clicks at the specified point on the object.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
X | The x-coordinate of the click. | No | String |
Y | The y-coordinate of the click. | No | String |
Example
ClickAt "5" "10"
ClickJS
This action clicks the specified object from the web application under test.
This action does not have any parameter.
Note: ClickJS uses javascript code to perform the click action. Qualitia recommends using this action for web applications.
Example:
ClickJS
ClickJSAndSelectWindowUsingURL
This action is used to click the web element or object that opens single or multiple windows from which a specific window is selected.
This action accepts 'waitTimeForWindow' for the specific window to open.
This action is used in the following 2 scenarios:
When a single window opens after clicking the web element/object, you need to give only 'waitTimeForWindow' parameter.
When multiple windows open after clicking the web element or object, then you can provide the exact URL or regex patterned URL window. You must give the URL and 'isURLPatternString' parameters.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
waitTimeForWindow | Enter the wait time for the window to open. | Yes | String |
URL | Enter a specific URL or regex pattern of URL for the window you want to select. | No | String |
isURLPatternString | Enter one of the following:
| No | String |
Example 1
String waitTimeForWindow : "5",
String url : null(do not give any value)
String isURLPatternString : null(do not give any value)
Expected Result - Here you do not need to provide URL or isURLPatternString as after clicking the object or element opens. The action waits up to 5 seconds for the window to appear after clicking the web element or object and then select the window.
Example 2
String waitTimeForWindow - "5",
String url - "https://bflsme--preprod.cs57.my.salesforce.com/_ui/common/data/LookupPage? lkfm=editPage&lknm=cas3&lktp=003&lksrch=",
String isURLPatternString - "False",
The action waits for up to 5 seconds for multiple windows to appear after clicking web element or object and it selects the window with the url "https://bflsme--preprod.cs57.my.salesforce.com/_ui/common/data/LookupPage?lkfm=editPage&lknm=cas3&lktp=003&lksrch=". As the isURLPatternString parameter is 'false' , the action finds as per the given URL.
Example 3
String waitTimeForWindow - "5",
String url - "www.([A-Z])\w+",
String isURLPatternString - "True",
Expected Result - The action waits for up to 5 seconds for multiple windows to open after clicking web element/object and it selects the window which matches the regex pattern "www.([A-Z])\w+" as provided in the URL parameter. As the isURLPatternString parameter is 'True', the action treats the URL parameter as a regex pattern. In case there are multiple windows satisfying the regex pattern, the action selects the first window.
DeselectAll
This action deselects all the options from the web list.
This action does not have any parameter.
Example:
DeselectAll
DeselectItemByText
This action deselects option specified in the parameter.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
itemName | Enter the item name you want to deselect. | Yes | String |
Example:
DeselectItemByText "Name"
DeselectItemByValue
This action deselects the specified parameterized item from the list.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
value | Enter the item that you want to deselect from the list. | Yes | String |
Example:
DeselectItemByValue "Name"
On this page:
- 1 Click
- 2 ClickAction
- 3 ClickAt
- 4 ClickJS
- 5 ClickJSAndSelectWindowUsingURL
- 6 DeselectAll
- 7 DeselectItemByText
- 8 DeselectItemByValue
- 9 DeSelectItems
- 10 DeselectMultipleItemsByIndex
- 11 DoubleClick
- 12 DownloadFile
- 13 DragAndDropToOffset
- 14 IsMultiselectList
- 15 MouseOver
- 16 MouseDown
- 17 MouseUp
- 18 RightClick
- 19 ScrollIntoView
- 20 SelectItemAndWait (Deprecated)
- 21 SelectItemByIndex
- 22 SelectItemByText
- 23 SelectItemByValue
- 24 SelectItems
- 25 SelectMultipleItemsByIndex
- 26 SetFocus
- 27 SetValueAttribute
- 28 StoreChildCount
- 29 StoreCSSProperty
- 30 StoreExistence
- 31 StoreFirstSelectedItem
- 32 StoreItems
- 33 StoreItemCount
- 34 StoreLocation
- 35 StorePropertyValue
- 36 StoreSelectedItems
- 37 StoreSize
- 38 StoreText
- 39 StoreValueAttribute
- 40 VerifyEnability
- 41 VerifyExistence
- 42 VerifyItemsExist
- 43 VerifyItemsInSequence
- 44 VerifyNoItemsDuplication
- 45 VerifySelectedItems
- 46 VerifySize
- 47 VerifyVisibility
- 48 StoreVisibility
- 49 WaitForAttributeContains
- 50 WaitForAttributeNotContains
- 51 WaitForAttributeNotToBe
- 52 WaitForAttributeNotToBeEmpty
- 53 WaitForAttributeToBe
- 54 WaitForAttributeToBeEmpty
- 55 WaitForChildElement
- 56 WaitForClickability
- 57 WaitForExistence
- 58 WaitForInnerTextContains
- 59 WaitForInnerTextMatchesPattern
- 60 WaitForInnerTextNotContains
- 61 WaitForInnerTextNotToBe
- 62 WaitForInnerTextToBe
- 63 WaitForInvisibility
- 64 WaitForNonClickability
- 65 WaitForNonExistence
- 66 WaitForNumberOfElementsToBe
- 67 WaitForNumberOfElementsToBeLessThan
- 68 WaitForNumberOfElementsToBeMoreThan
- 69 WaitForSelection
- 70 WaitForSelectionStateToBe
- 71 WaitForStaleness
- 72 WaitForVisibility
- 73 ClickAndWait (Deprecated)
- 74 WaitForObject (Deprecated)
DeSelectItems
This action deselects the specified selected items from the specified list box. Multiple items for deselection can be given only for the list box that has multi-selection property.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
items | Enter the expected list items that are to be deselected from the list box. Separate multiple items by carat (^) operator. | No | Array |
Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" , if the user wishes to deselect "India and Australia", then this action can be used as follows:
DeSelectItems "India^Australia"
If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList to be deselected.
DeselectMultipleItemsByIndex
This action deselects multiple items specified in the parameter.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
indices | Enter the indices of the items you want to deselect. Multiple items should be separated by (^) caret. Index starts from 1. | Yes | Array |
Example:
DeselectMultipleItemsByIndex "1^5^8"
DoubleClick
This action double-clicks the specified web element.
This action does not have any parameter.
Example:
DoubleClick
DownloadFile
This action clicks the link/element that opens a download window, which is used to download the files. You need to handle the action externally as it does not wait until the file is downloaded.
Qualitia uses its internal mechanism to handle the Download File pop-up screen.
You can also use AutoIT to execute this action on Windows operating systems only. You need to install AutoIT.
After installing AutoIT, you can configure the AutoIT Install path in Qualitia client as follows: Project Configuration > General > Settings > AutoIT Install Path. The default AutoIT path is C:\Program Files (x86)\AutoitV3.
To configure the Auto Install Path for an offline suite:
Open the Qualitia Offline Configuration Manager.
Select the Offline Suite and the associated execution profile.
Click Qualitia Settings > General > AutoIT Path.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
folderPath | 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. | No | String |
Example:
Example
DownloadFile "C:/ProgramData" "Qualitia"
DragAndDropToOffset
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. | No | 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. | No | String |
Example:
DragAndDropOffset "100" "500"
IsMultiselectList
This action verifies that web list element supports selecting multiple options and stores the result under the specified key.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
Key | Enter the key name under which the result will be stored. The key value can be retrieved using the key name.
| No | String |
Example:
IsMultiselectList "Key"
MouseOver
This action simulates a mouse hovering over the specified object.
This action does not have any parameter.
Example:
MouseOver
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. | No | String |
Y | The x-coordinate of the click. | No | 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 of the click. | No | String |
Y | The y-coordinate of the click. | No | 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. | No | 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
SelectItemAndWait (Deprecated)
This action selects an item from the list and waits. It waits for the sync time set under the Configuration Settings (Execution) window. If the page loads before reaching the maximum sync time, then the action will stop waiting.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
item | Enter the item to be selected from the list. | No | String |
Example:
Consider a list containing names of countries. If it contains list items "India", "England", "Australia" and the user wishes to select "England", then this action can be used as follows
SelectItemAndWait "India"
If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList.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 is in ready state and assume that the page is loaded could however not work as expected at all times.
SelectItemByIndex
This action selects the specified item from the list. Index starts from 1.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
index | Enter the index value of the list item that you want to select. Index starts at 1. | No | String |
Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" and user wishes to select "Australia", then this action can be used as follows:
SelectItemByIndex "3"
SelectItemByText
This action selects option specified in the parameter.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
itemName | Enter the item name you want to select. | Yes | String |
Example:
SelectItemByText "Name"
SelectItemByValue
This action selects the item specified by value from the web list.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
Value | Enter the value of the item which you want to select. | Yes | String |
Example:
SelectItemByValue "Address 1"
SelectItems
This action selects particular item or items from a list. Multiple items for selection can be given only for the list box that has multi-selection property.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
items | Enter the name of the item that needs to be selected.You can have multiple items by using carat (^) operator to separate them. | No | Array |
Example:
SelectItems "England^India^Australia"
Consider a list containing names of countries. If it contains list items "India", "England", "Australia" and the user wishes to select "England", then this action can be used as follows. If an empty data ("" or $NULL$) is passed as the data, the action will be passed only if there exist an item "" in the webList to be selected.
SelectMultipleItemsByIndex
This action selects multiple items specified in the parameter.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
indices | Enter the indices of the items you want to select. Multiple items should be separated by (^) caret. Index starts from 1. | Yes | Array |
Example:
SelectMultipleItemsByIndex "1^2^4"
SetFocus
This action sets the focus on the specified object.
This action does not have any parameter.
Example:
SetFocus
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"
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"
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 Desciption | Mandatory | Data Type |
---|---|---|---|
keyProperty | Enter the key name under which the property value will be stored. | Yes | String |
property | Enter the property name whose value you want to store. | Yes | String |
Example:
StoreCSSProperty "Key" "display"
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"
StoreFirstSelectedItem
This action stores the first item 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 you want to store the item name. | Yes | String |
Example:
StoreFirstSelectedItem "Key"
StoreItems
This action stores all the items from the specified list under the key name. Items are separated by carat (^) operator and can be retrieved using the key name.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
key | Enter the key name under which you want to store the items. | Yes | String |
Example:
Consider a list having the items like, Monday, Tuesday, Wednesday.
StoreItems "Key"
The items in the key will be stored as Monday^Tuesday^Wednesday.
StoreItemCount
This action stores the total number of elements existing in the specified web list object.
Input parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
key | Enter the key name under which the value will be stored. The value can be retrieved using the key name. | Yes | String |
Example:
StoreItemCount "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 Desciption | Mandatory | Data Type |
---|---|---|---|
keyXPosition | Enter the key name to store the height of the location of the object. | Yes | String |
keyYPosition | Enter the key name to store the width of the location of the object. | Yes | String |
Example:
StoreLocation "Height" "Width"
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"
StoreSelectedItems
This action stores all the items of a list that are selected under the specified key. Multiple items are stored separated by carat (^) operator. 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 you want to store the items. | Yes | String |
Example:
StoreSelectedItems "selectedItemsKey"
Consider a list having the items Monday, Tuesday, Wednesday, Thursday, Friday. Suppose Tuesday and Friday is selected in the list.
The items in the key will be stored as Tuesday^Friday
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"
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 Desciption | Mandatory | Data Type |
---|---|---|---|
keyText | Enter the key name to store the text from the specified object. | Yes | String |
Example:
StoreText "Key"
StoreValueAttribute
This action stores the data present in the "value" attribute of the object.
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
strKey | Enter a variable to store the data present in the "value" attribute for the object. | Yes | String |
Example:
StoreValueAttribute "Key"
VerifyEnability
This action verifies the enability of the specified object.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
enability | Value for this parameter can be True or False.
| No | 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 parameter can be True or False.
| No | String |
Example:
VerifyExistence "True"
VerifyItemsExist
This action verifies the existence of the objects in the specified list.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
items | Enter the items for which you want too check the existence. Separate multiple items by carat (^) operator. | Yes | Array |
existence | Value of this parameter can be either True or False.
| Yes | String |
Example:
Consider a list containing names of countries "India", "Australia", "England", "South Africa". If the user wishes to verify if India, England, South Africa are in the list, then this action can be used as follows:
VerifyItemsExist "India^South Africa^England" "True"
"^" in Qualitia is a delimiter for items in an array.
If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList.
VerifyItemsInSequence
This action verifies whether the sequence of items in the specified web list is correct.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
items | Enter the list of items in expected sequence. Separate multiple items by carat (^) operator. | No | Array |
Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" then to verify a sequence in the list, this action can be used as follows:
VerifyItemsInSequence "India^England^Australia^SA"
VerifyNoItemsDuplication
This action verifies that the specified list does not contain duplicate items.
Example:
VerifyNoItemsDulication
Consider a list having the items Monday, Tuesday, Wednesday, Monday
In this case, this action fails because the list contains Monday two times.
VerifySelectedItems
This action verifies the selected items with the expected items list.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
items | Enter the list items that are expected to be selected from the list box. Separate multiple items by carat (^) operator. | No | Array |
Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" , if India and England are selected and this needs to be verified, the this action can be used as follows
VerifySelectedItems "India^England"
If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" selected item in the webList.
VerifySize
This action compares the actual number of items (size) from the specified list box with the expected number of items (size).
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
expectedSize | Enter the expected size of the list box that will be compared with the actual size of the list box. | No | String |
Example:
If a list contains the items "India","England,"S.A", then to verify its size this action can be used as follows.
VerifyListBoxSize "3"
VerifyVisibility
This action verifies the visibility of the specified object.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
visibility | Value for this parameter can be True or False.
| No | String |
Example:
VerifyVisibility "True"
StoreVisibility
This action stores the visibility status for a web element under the specified key name in the following conditions:
True: If the web element is visible.
False: If the web element is not visible.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
strKey | Enter a variable to store the visibility status. | No | String |
Example: StoreVisibility "Key"
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.
Note:
For the WaitFor actions to complete successfully, the specified object must exist.
Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.
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.
Note:
For the WaitFor actions to complete successfully, the specified object must exist.
Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.
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"
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"
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"
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"
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"
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"Example:
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"
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 |
---|---|---|---|
expectedNumOfElements | Enter the expected number of elements to wait for. Note: The default value is 1. | No | String |
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 |
---|---|---|---|
expectedNumOfElements | Enter the expected number of elements to wait for. | No | String |
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:
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 Description | Mandatory | Data Type |
---|---|---|---|
expectedNumOfElements | Enter the expected number of elements to wait for. | No | String |
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" "5" "500" "Key" "Defect"
WaitForSelection
This action waits till the specified object gets selected. 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 get selected. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the selection of the object before exhausting timeout. | No | String |
keySelection | 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. Default value is Fail. You can override this with Defect. | No | String |
Example:
WaitForSelection "5" "500" "Key" "Defect"
WaitForSelectionStateToBe
This action waits for the object to go to the specified state. You may specify the timeout and polling interval, if required.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
expectedSelectionState | Enter the expected selection state. Set True for selection and False for deselection. | No | Boolean |
timeOut | Enter the timeout (in seconds) to wait for the object to get selected. | No | String |
pollingInterval | Enter the frequency (in milliseconds) after which you want to check for the selection of the object before exhausting timeout. | No | String |
keySelectionState | 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. Default value is Fail. You can override this with Defect. | No | String |
Example:
WaitForSelectionStateToBe "False" "5" "500" "Key" "Defect"
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"
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"
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 associated execution profile.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
Timeout | Enter the number of seconds to wait for the object to appear or disappear. This has to be 0 or any positive number. | No | String |
existence | Value for this parameter can be True or False.
| No | String |
Example:
WaitForObject "10" "True"
The action waits for maximum 10 seconds for the object to appear. If the object appears before 10 seconds elapses, the execution continues to the next steps.
WaitForObject "15" "False"
The action shall wait for maximum 15 seconds for the object to disappear. If the object disappears before 15 seconds elapses, the execution continues to the next steps.