Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Multiexcerpt include macro
nameClick
pageWebButton Actions

Multiexcerpt include macro
nameVerifyExistence
pageWebButton Actions

Multiexcerpt include macro
nameVerifyVisibility
pageWebButton Actions

On this page:

Table of Contents
maxLevel2
absoluteUrltrue
stylesquare

Multiexcerpt include macro
nameDownloadFile
pageWebButton Actions

Multiexcerpt include macro
nameStorePropertyValue
pageWebButton Actions

Multiexcerpt include macro
nameMouseOver
pageWebButton Actions

Multiexcerpt include macro
nameMouseDown
pageWebButton Actions

Multiexcerpt include macro
nameMouseUp
pageWebButton Actions

Multiexcerpt include macro
nameClickAt
pageWebButton Actions

Multiexcerpt include macro
nameSetFocus
pageWebButton Actions

Multiexcerpt macro
nameDoubleClick

DoubleClick

This action double-clicks the specified web element.

Example:
DoubleClick

Multiexcerpt macro
nameRightClick

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.

Multiexcerpt include macro
nameWaitForObject
pageWebButton Actions

Multiexcerpt include macro
nameClickAndWait
pageWebButton Actions

Multiexcerpt macro
nameDragandDrop

DragAndDrop

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

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.

Yes

String

Y

The y-coordinate of the click.

Yes

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

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 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 has to be handled externally by the user.

This action requires AutoIt to be installed.

  1. Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
  2. Click on Download AutoIt v3.
  3. Choose full installation.
  4. 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.

No

String


Image Added Example:
Image Added

Image Added


Image Added

Image Added
Example  DownloadFile               "C:/ProgramData"           "Qualitia" 

Image Added  This action is tested on IE8, FF and Chrome. This action is not supported on IE9, IE10, and Google Chrome <16.

On this page:

Table of Contents
maxLevel2
minLevel2


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.

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. 

  • Stores True if the object exists.
  • Stores False if the object does not exist.

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.

  • Set True if you want to verify that the object is enabled. 
  • Set False if you want to verify that the object is disabled.

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.

  • Set True if you want to check the existence.
  • Set False if you want to check the non-existence.

Yes

String

Example:

DragAndDrop    

VerifyExistence        

"100"

             "

500

True"

Multiexcerpt include macro
nameStoreExistence
pageWebButton Actions

Multiexcerpt include macro
nameStoreChildCount-withoutlocator
pageWebButton Actions

Multiexcerpt include macro
nameScrollIntoView
pageWebButton Actions

Multiexcerpt include macro
nameClickJS
pageWebButton Actions

Multiexcerpt include macro
nameActionClick
pageWebButton Actions

New Actions

Multiexcerpt macronameStoreText

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.

  • Set True if you want to check the visibility.
  • Set False if you want to check the invisibility.

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 Desciption

Parameter Description

Mandatory

Data Type

keyText

Enter the key name to store the text from the specified object.

Yes

String

Example:
StoreText        "Key" 

multiexcerpt-macro

name

StoreLocation

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

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

" Multiexcerpt macronameStoreCSSProperty

"

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

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        "

Key

display"            "

display

Key"

multiexcerpt-macro

name

StoreSize

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"

WaitForStaleness

multiexcerpt-include-macro
name

WaitForStaleness

SendKeySequence
pageWebEdit Actions

SetValueAttribute

This action

waits until the element gets detached from the DOM. 

Input Parameters:

sets the data specified in the 'value' attribute of the object.

Parameter Name

Parameter Description

Mandatory

Data Type

timeOut

value

Enter the

timeout (in seconds) to wait for the value to be detached.  NoStringpollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the element before exhausting timeout. NoStringkeyStatus

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

status of this step

value will be stored

. Stores 0 for Pass, 1 for Fail, and 2 for Defect

.

NoStringstatusIfConditionNotSatisfied

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

value to be added for the Value attribute.Key value can be retried using the key name.

Yes

String

Example:

WaitForStaleness

StoreValueAttribute       

 

"

5"          "500"     "

Key

"       

"

Defect" Multiexcerpt macro
nameWaitForAttributeValueContains
WaitForAttributeValueContains

WaitForStaleness

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.  

until the element gets detached from the DOM. 
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

attributeNameEnter the attribute name whose value you want to check.YesStringattributeValue Enter the partial expected partial attribute value.YesString

timeOut

Enter the timeout (in seconds) to wait for the

expected

value to be detached.

 

  

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the

expected value

element before exhausting timeout. 

No

String

keyAttributeValueContains

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example

:WaitForAttributeValueContains      "id"           "we323es"

:
WaitForStaleness        "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForAttributeValueNotContains
WaitForAttributeValueNotContains

WaitForAttributeContains

This action waits

until

till the

specified attribute's

value of the

object

specified attribute changes to

other than

the expected partial

parameterized

value.

 This

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

partial expected partial attribute value.

Yes

String

timeOut

Enter the timeout (in seconds) to wait for the expected value

to change

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the

unexpected

expected value before exhausting timeout. 

No

String

keyAttributeValue

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForAttributeValueNotContains 

WaitForAttributeContains      "id"           "

232waf

we323es"        "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForAttributeValueToBe

WaitForAttributeValueToBe

WaitForAttributeNotContains

This action waits

till

until the specified attribute's value of the

specified attribute

object changes to other than the

exact expected

partial parameterized value.

This

 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 which should not be there in the attribute value.

Yes

String

timeOut

Enter the timeout (in seconds) to wait for the

expected

value to change

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the

expected

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForAttributeValueToBe 

WaitForAttributeValueContains     

   

"id"           "232waf"        "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForAttributeNotToBe

WaitForAttributeValueNotToBe

WaitForAttributeToBe

This action waits

until

till the

specified attribute's

value of the

object

specified attribute changes to

other than

the exact

parameterized

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 value which should not be there in the attribute

Enter the exact expected value.

Yes

String

timeOut

Enter the timeout (in seconds) to wait for the expected 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

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForAttributeValueNotToBe 

WaitForAttributeToBe         

  

"id"           "232waf"        "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForAttributeValueNotToBeEmpty
WaitForAttributeValueNotToBeEmpty

WaitForAttributeNotToBe

This action waits until the specified attribute's value of the object

gets filled with some value.

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

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

attribute

value to change.

  

 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the

attribute

expected value before exhausting timeout. 

No

String

keyAttributeValue

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForAttributeValueNotToBeEmpty 

WaitForAttributeNotToBe      "id"           "232waf"        "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForAttributeValueToBeEmpty
WaitForAttributeValueToBeEmpty

WaitForAttributeNotToBeEmpty

This action waits until the specified attribute's value of the object gets

empty

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

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForAttributeValueToBeEmpty 

WaitForAttributeNotToBeEmpty      "id"           "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForClickability
WaitForClickability

WaitForAttributeToBeEmpty

This action waits

for

until the specified

object to be clickable

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

object

attribute value to be

clickable

empty.

   

  

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for the

object clickability

attribute value before exhausting timeout. 

No

String

keyClickability

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForClickability 

WaitForAttributeToBeEmpty      "id"           "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForExistence
WaitForExistence

WaitForClickability

This action waits for

the existence of

the specified object to be clickable.

You

 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 to be clickable.   

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for the

existence of the

object clickability before exhausting timeout. 

No

String

keyExistence

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForExistence 

WaitForClickability     "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForInnerTextContains

WaitForInnerTextContains

WaitForExistence

This action waits for the

object to contain the expected partial text. The comparison is case-sensitive. You

existence of the specified object. You may specify the timeout and polling interval, if required. 
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data TypeinnerTextEnter the expected text you want to wait for.YesString

Data Type

timeOut

Enter the timeout (in seconds) to wait for the

expected text

existence of the object.   

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for the existence of the

expected text

object before exhausting timeout. 

No

String

keyInnerTextContains

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForInnerTextContains     

WaitForExistence     "

Connect

5"

     

 

"5"

        "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForInnerTextMatchesPattern
WaitForInnerTextMatchesPattern

WaitForInnerTextContains

This action waits for

inner text from

the

specified

object to

match

contain the expected partial text

regular expression pattern

.

 The

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

innerText

Enter

the expected pattern for the inner text. Pattern should be regular expression. Step fails in case the pattern is invalid

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

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForInnerTextMatchesPattern 

WaitForInnerTextContains         

  ".*[My]text.*

"Connect"       "5"       "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForInnerTextNotContains

WaitForInnerTextNotContains

WaitForInnerTextMatchesPattern

This action waits

until

for inner text from the specified

attribute's value of the

object

changes

to

other than the parameterized value. The

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

innerText

innerTextRegXPattern

Enter the expected pattern for the inner text

which

. Pattern should

not

be

there

regular expression. Step fails in case the

attribute value

pattern is invalid.

 

Yes

String

timeOut

Enter the timeout (in seconds) to wait for the

inner

expected 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

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForInnerTextNotContains 

WaitForInnerTextMatchesPattern           "

Connect

.[My]text."       "5"       "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForInnerTextNotToBe

WaitForInnerTextNotToBe

WaitForInnerTextNotContains

This action waits

till the inner text

until the specified attribute's value of the object changes

from the specified text. The

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

object

attribute value. 

Yes

String

timeOut

Enter the timeout (in seconds) to wait for the inner text

to change

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

keyInnerTextNotToBe

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForInnerTextNotToBe 

WaitForInnerTextNotContains          "Connect"       "5"       "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForInnerTextToBe

WaitForInnerTextToBe

WaitForInnerTextNotToBe

This action waits

for

till the inner text of the object

to contain the expected exact

changes from the specified text.

The

 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

text which should not be there in the object.

Yes

String

timeOut

Enter the timeout (in seconds) to wait for the

expected

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

keyInnerText

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForInnerTextToBe 

WaitForInnerTextNotToBe          "Connect"       "5"       "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForInvisibility
WaitForInvisibility

WaitForInnerTextToBe

This action waits for the object to

invisible. You

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

object to go invisible.    

expected text.   

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for the

invisibility

expected text before exhausting timeout. 

No

String

keyInvisibility

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForInvisibility 

Example:
WaitForInnerTextToBe          "Connect"       "5"       

 

"500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForNonClickability

WaitForNonClickability

This object

WaitForInvisibility

This action waits for the object to

become non clickable

invisible.

 You

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

go invisible

   

  

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for the

clickability

invisibility before exhausting timeout. 

No

String

keyNonClickability

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNonClickability 

WaitForInvisibility     

  

"5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForNonExistence

WaitForNonExistence

This action

WaitForNonClickability

This object waits for the

non existence of the specified object. You

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 non existence of

the object to become non clickable.     

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for

non existence of

the

object

clickability before exhausting timeout. 

No

String

keyNonExistence

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNonExistence 

WaitForNonClickability   

 

  "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForSelection
WaitForSelection

WaitForNonExistence

This action waits

till

for the non existence of the specified object

gets selected

.

 You

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

to get selected

.   

 

No

Integer

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for

the selection

non existence of the object before exhausting timeout. 

No

Integer

String

keySelection

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForSelection 

WaitForNonExistence     

  

"5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForSelectionStateToBe

WaitForSelectionStateToBe

This action waits

WaitForVisibility

This action waits for the object to

go to the specified state. You

be visible. You may specify the timeout and polling interval, if required. 

 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedSelectionStateEnter the expected selection state. Set True for selection and False for deselection.YesBoolean

timeOut

Enter the timeout (in seconds) to wait for the object

to get selected

visibility

   

  

No

Integer

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for

the selection of

the object visibility before exhausting timeout. 

No

Integer

String

keySelectionState

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForSelectionStateToBe          "False"

WaitForVisibility     

   

"5"          "500"     

 

"Key"       "Defect"

Multiexcerpt macro
nameWaitForVisibility

WaitForVisibility

WaitForNumberOfElementsToBe

This action waits for the number of elements of the specified object locator on the page to be

visible

same as the expected number. You may specify the timeout and polling interval, if required.

 


Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

number

Enter the expected number of elements to wait for.

Yes

Integer

timeOut

Enter the timeout (in seconds) to wait for the

object visibility

number elements to appear

  

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for the

object visibility

objects before exhausting timeout. 

No

String

keyVisibility

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForVisibility 

WaitForNumberOfElementsToBe       "2"         "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForNumberOfElementsToBe

WaitForNumberOfElementsToBe

WaitForNumberOfElementsToBeLessThan

This action waits for the number of elements of the specified object locator on the page to be

same as

less than the

expected

specified number. You may specify the timeout and polling interval, if required.
 Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

number

expectedNumOfElements

Enter the expected number of elements to wait for.

Yes

Integer

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

Integer

keyNumberOfElements

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNumberOfElementsToBe 

WaitForNumberOfElementsToBeLessThan       "2"         "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForNumberOfElementsToBeLessThan

WaitForNumberOfElementsToBeLessThan

WaitForNumberOfElementsToBeMoreThan

This action waits for the number of elements of the specified object locator on the page to be

less

more than the specified number. You may specify the timeout and polling interval, if required.

 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

number

expectedNumOfElements

Enter the expected number of elements to wait for.

Yes

String

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

Integer

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

. Default value is Fail. You can override this with

. value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNumberOfElementsToBeLessThan 

WaitForNumberOfElementsToBeMoreThan       "2"         "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForNumberOfElementsToBeMoreThan

WaitForNumberOfElementsToBeMoreThan

WaitForChildElement

This action waits for the

number of

child elements of the specified object

locator on the page to be more than the specified number

to appear. You may specify the timeout and polling interval, if required.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

number

childLocatorType

Enter the locator type of the object whose child you want to check.

Yes

String

childLocatorValue

Enter the

expected number of elements to wait for.

locator value of the child you want to check. 

Yes

Integer

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

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.

Default value is Fail. You can override this with

value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNumberOfElementsToBeMoreThan 

WaitForChildElement      "id"       "2"         "5"          "500"     "Key"       "Defect"

Multiexcerpt macro
nameWaitForChildElement

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 NameParameter DescriptionMandatoryData TypechildLocatorTypeEnter the locator type of the object whose child you want to check.YesStringchildLocatorValueEnter the locator value of the child you want to check. YesStringtimeOutEnter the timeout (in seconds) to wait for the elements to appear. NoStringpollingIntervalEnter the frequency (in milliseconds) after which you want to check for the objects before exhausting timeout. NoStringkeyExistenceEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoStringstatusIfConditionNotSatisfiedEnter 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.NoString

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

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.

  • Set true if you want to check for the appearance of the object.
  • Set false if you want to check for the disappearance of the object.

Yes

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, 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,execution continues to the next steps.