Multiexcerpt include macro

name	Click
page	WebButton Actions

Multiexcerpt include macro

name	VerifyExistence
page	WebButton Actions

Multiexcerpt include macro

name	VerifyVisibility
page	WebButton Actions

Multiexcerpt include macro

name	StorePropertyValue
page	WebButton Actions

Multiexcerpt include macro

name	SetFocus
page	WebButton Actions

New Actions

Multiexcerpt macro

name	StoreText

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 NameParameter DesciptionMandatoryData TypekeyTextEnter the key name to store the text from the specified object

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.

Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
Click on Download AutoIt v3.
Choose full installation.
After the set up is completed, AutoIT installation path should be set against the Qualitia's configfile key "AutoITPath"

Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
folderName	The path where the file is to be download. Please check Table 1 "Parameter Mandate" to validate in the situation where this parameter will be mandatory. In case the parameter Mandatory; the user should take care that the folder path exists. The action does not validates whether the folder exist	Yes	String
Filename	The filename of the downloadable file, to be given incase the user requires to give specific name and not depend on the default name of the file. In case, the file already exist, similar window like below will appear. Such windows are not handled by the action. Incase, the user does not provide this data, the action will pick the default file name available while download.	No	String

Image Added Example:
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.

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:

StoreText

DragAndDropOffset

"

Key

100"

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.

"500"

MouseDown

This action simulates left-click at the specified location on the screen.
Input Parameters:

Parameter Name	Parameter

DesciptionEnter the key name to store the height of the location of the object

Description	Mandatory	Data Type

keyHeightEnter the key name to store the width of the location of the object

X

The x-coordinate of the click.

Yes

String

keyWidth

Y

The y-coordinate of the click.

Yes

String

Example:

StoreLocation

MouseDown

"Height"

"

Width" Multiexcerpt macro

name	StoreCSSProperty

StoreCSSProperty

This action stores the CSS property value of the object under the specified key. Key value can be retrieved using the key name.

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

DesciptionEnter the property name whose value you want to store

Description	Mandatory	Data Type

propertyEnter the key name under which the property value will be stored.

X

The x-coordinate of the click.

Yes

String

keyProperty

Y

The y-coordinate of the click.

Yes

String

Example

:

StoreCSSProperty

MouseUp "

display

5"

"

Key

10"

Multiexcerpt macro

name	StoreSize

StoreSize

RightClick

This action

stores the size of the specified object under keys. The key values can be retrieved using key names

right-clicks the specified web element.
Input Parameters:

Enter the key name under which you want to store the height of the object

Parameter Name	Parameter Description	Mandatory	Data Type

keyXPosition

option

The context menu option number that needs to be clicked.

Yes

String

keyYPositionEnter the key name under which you want to store the width of the object.YesString

Example:

StoreSize "Height"

Example:

RightClick "

Width" Multiexcerpt macro

name	SendKeys

SendKeySequence

This action sends one or multiple keys specified in the parameters to the specified object. You may use the syntaxes mentioned below to send normal or modifier keys. Multiple keys should be separated by caret.

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

arrayofKeys

Key

Enter

the keys you want to send. Multiple keys should be separated by caret (^)sendKeySequence

the key name under which the child count will be saved.

Yes

Array

Adding modifiers like SHIFT, Control, and so forth perform the activity of pressing these keys only. For releasing these keys, you must add these modifiers again based on requirements as shown in the example.

Example:

String

Example:
StoreChildCount "

~{SHIFT~}^w^~{SHIFT~}^elcome"

The example above will press the word Welcome.

Apart from the normal alphabets, you can also send the modifier keys. When sending modifier keys, you have to send them in the syntax given.

KeySyntaxNULL~{NULL~}CANCEL (Esc)~{CANCEL~}HELP~{HELP~}BACK_SPACE~{BACK_SPACE~}TAB~{TAB~}CLEAR~{CLEAR~}RETURN~{RETURN~}ENTER~{ENTER~}SHIFT~{SHIFT~}LEFT_SHIFT(SHIFT)~{LEFT_SHIFT~}CONTROL~{CONTROL~}LEFT_CONTROL(CONTROL)~{LEFT_CONTROL~}ALT~{ALT~}LEFT_ALT~{LEFT_ALT~}PAUSE~{PAUSE~}ESCAPE~{ESCAPE~}SPACE~{SPACE~}PAGE_UP~{PAGE_UP~}PAGE_DOWN~{PAGE_DOWN~}END~{END~}HOME~{HOME~}LEFT~{LEFT~}ARROW_LEFT~{ARROW_LEFT~}UP~{UP~}ARROW_UP~{ARROW_UP~}RIGHT~{RIGHT~}ARROW_RIGHT~{ARROW_RIGHT~}DOWN~{DOWN~}ARROW_DOWN~{ARROW_DOWN~}INSERT~{INSERT~}DELETE~{DELETE~}SEMICOLON~{SEMICOLON~}EQUALS~{EQUALS~}NUMPAD0~{NUMPAD0~}NUMPAD1~{NUMPAD1~}NUMPAD2~{NUMPAD2~}NUMPAD3~{NUMPAD3~}NUMPAD4~{NUMPAD4~}NUMPAD5~{NUMPAD5~}NUMPAD6~{NUMPAD6~}NUMPAD7~{NUMPAD7~}NUMPAD8~{NUMPAD8~}NUMPAD9~{NUMPAD9~}MULTIPLY~{MULTIPLY~}ADD~{ADD~}SEPARATOR~{SEPARATOR~}SUBTRACT~{SUNSTRACT~}DECIMAL~{DECIMAL~}DIVIDE~{DIVIDE~}F1~{F1~}F2~{F2~}F3~{F3~}F4~{F4~}F5~{F5~}F6~{F6~}F7~{F7~}F8~{F8~}F9~{F9~}F10~{F10~}F11~{F11~}F12~{F12~}META~{META~}COMMAND (META)~{COMMAND~}ZENKAKU_HANKAKU~{ZENKAKU_HANKAKU~}CLICK~{CLICK~}DOUBLECLICK~{DOUBLECLICK~}RIGHTCLICK~{CONTEXTCLICK~} Multiexcerpt macro

name	setValueAttribute

SetValueAttribute

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

Parameter NameParameter DescriptionMandatoryData TypevalueEnter the value to be added for the Value attribute.YesString

Example:

SetValueAttribute "#ff0990"

Multiexcerpt macro

name	StoreValueAttribute

StoreValueAttribute

This action stores the data present in the 'value' attribute of the object.

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:

VerifyExistence "True"

VerifyVisibility

This action verifies the visibility of the specified object.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value for this parameters can be true or false.

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 Description	Mandatory	Data Type
keyText	Enter the key name to store the text from the specified object.	Yes	String

Example:
StoreText "Key"

StoreLocation

This action stores the current location of the object under the specified keys. The key values can be retrieved using the key names.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
keyHeight	Enter the key name to store the height of the location of the object.	Yes	String
keyWidth	Enter the key name to store the width of the location of the object.	Yes	String

Example:
StoreLocation "Height" "Width"

StoreCSSProperty

This action stores the CSS property value of the object under the specified key. Key value can be retrieved using the key name.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
property	Enter the property name whose value you want to store.	Yes	String
keyProperty	Enter the key name under which the property value will be stored.	Yes	String

Example:
StoreCSSProperty "display" "Key"

StoreSize

This action stores the size of the specified object under keys. The key values can be retrieved using key names.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
keyXPosition	Enter the key name under which you want to store the height of the object.	Yes	String
keyYPosition	Enter the key name under which you want to store the width of the object.	Yes	String

Example:
StoreSize "Height" "Width"

Multiexcerpt include macro

name	SendKeySequence
page	WebEdit Actions

SetValueAttribute

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

Parameter Name	Parameter Description	Mandatory	Data Type
value	Enter the value to be added for the Value attribute.	Yes	String

Example:
SetValueAttribute "#ff0990"

StoreValueAttribute

This action stores the data present in the 'value' attribute of the object.

Parameter Name	Parameter Description	Mandatory	Data Type
key	Enter the key name under which the value will be stored. Enter the value to be added for the Value attribute.Key value can be retried using the key name.	Yes	String

Example:
StoreValueAttribute "Key"

WaitForStaleness

This action waits until the element gets detached from the DOM.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
timeOut	Enter the timeout (in seconds) to wait for the value to be detached.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for existence of the element before exhausting timeout.	No	String
keyStatus	Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.	No	String
statusIfConditionNotSatisfied	Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.	No	String

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

WaitForAttributeContains

This action waits till the value of the specified attribute changes to the expected partial value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
attributeName	Enter the attribute name whose value you want to check.	Yes	String
attributeValue	Enter the partial expected partial attribute value.	Yes	String
timeOut	Enter the timeout (in seconds) to wait for the expected value.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout.	No	String
keyAttributeValueContains	Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.	No	String
statusIfConditionNotSatisfied	Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.	No	String

Example:
WaitForAttributeContains "id" "we323es" "5" "500" "Key" "Defect"

WaitForAttributeNotContains

This action waits until the specified attribute's value of the object changes to other than the partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type

key

attributeName

Enter the

key

attribute name

under which the value will be stored. Enter the value to be added for the Value attribute.Key value can be retried using the key name.YesString

Example:

StoreValueAttribute "Key"

Multiexcerpt macro

name	WaitForStaleness

WaitForStaleness

This action waits until the element gets detached from the DOM.

Input Parameters:

Parameter NameParameter DescriptionMandatoryData Type

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

be detached

change.

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

element

unexpected value before exhausting timeout.

No

String

keyStatus

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:

WaitForStaleness

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

Multiexcerpt macro

name	WaitForAttributeContains

WaitForAttributeContains

WaitForAttributeToBe

This action waits till the value of the specified attribute changes to the exact expected

partial

value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.

Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
attributeName	Enter the attribute name whose value you want to check.	Yes	String
attributeValue	Enter the

partial

exact 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

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:

WaitForAttributeContains

WaitForAttributeToBe "id" "

we323es

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

Multiexcerpt macro

name	WaitForAttributeNotContains

WaitForAttributeNotContains

WaitForAttributeNotToBe

This action waits until the specified attribute's value of the object changes to other than the

partial

exact 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 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

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:

WaitForAttributeValueContains

WaitForAttributeNotToBe

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

Multiexcerpt macro

name	WaitForAttributeToBe

WaitForAttributeToBe

WaitForAttributeNotToBeEmpty

This action waits

till

until the specified attribute's value of the

specified attribute changes to the exact expected value. This comparison is case-sensitive

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

.YesStringattributeValue Enter the exact expected value

.	Yes	String
timeOut	Enter the timeout (in seconds) to wait for the

expected

attribute value.

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

existence of

the

expected

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:

WaitForAttributeToBe

WaitForAttributeNotToBeEmpty

"id" "

232waf" "

5" "500" "Key" "Defect"

Multiexcerpt macro

name	WaitForAttributeNotToBe

WaitForAttributeNotToBe

WaitForAttributeToBeEmpty

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

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

.YesStringattributeValue 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

be empty.

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

existence of

the

expected

attribute 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:

WaitForAttributeNotToBe

WaitForAttributeToBeEmpty "id" "

232waf" "

5" "500" "Key"

"Defect" Multiexcerpt macro

name	WaitForAttributeNotToBeEmpty

WaitForAttributeNotToBeEmpty

"Defect"

WaitForClickability

This action waits

until

for the specified

attribute's value of the object gets filled with some value. You

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

Parameter Name	Parameter Description	Mandatory	Data Type

attributeNameEnter the attribute name whose value you want to check.

YesString

timeOut

Enter the timeout (in seconds) to wait for the

attribute value.

object to be clickable.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for the

attribute value

object clickability before exhausting timeout.

No

String

keyAttributeValue

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:

WaitForAttributeNotToBeEmpty "id"

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

Multiexcerpt macro

name	WaitForAttributeToBeEmpty

WaitForAttributeToBeEmpty

WaitForExistence

This action waits

until the specified attribute's value

for the existence of the specified object

gets empty

.

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

Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type

attributeNameEnter the attribute name whose value you want to check.

YesString

timeOut

Enter the timeout (in seconds) to wait for the

attribute value to be empty.

existence of the object.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for the existence of the

attribute value

object before exhausting timeout.

No

String

keyAttributeValue

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

:WaitForAttributeToBeEmpty "id"

:
WaitForExistence

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

Multiexcerpt macro

name	WaitForClickability

WaitForClickability

WaitForInnerTextContains

This action waits for the

specified

object to

be clickable

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

object to be clickable

expected text.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for the

object clickability

expected text before exhausting timeout.

No

String

keyClickability

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:

WaitForClickability

Example:
WaitForInnerTextContains "Connect" "5"

"500" "Key" "Defect"

Multiexcerpt macro

name	WaitForExistence

WaitForExistence

WaitForInnerTextMatchesPattern

This action waits for

the existence of

inner text from the specified object

. You

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 NameParameter DescriptionMandatoryData Type

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

existence of the object

expected text.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for the

existence of the object

expected text before exhausting timeout.

No

String

keyExistence

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:

WaitForExistence

WaitForInnerTextMatchesPattern ".[My]text." "5"

"500" "Key" "Defect"

Multiexcerpt macro

name	WaitForInnerTextContains

WaitForInnerTextContains

WaitForInnerTextNotContains

This action waits

for

until the specified attribute's value of the object changes to

contain the expected partial text. The

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

expected text you want to wait for.

text which should not be there in the attribute value.	Yes	String
timeOut	Enter the timeout (in seconds) to wait for the

expected

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

keyInnerTextContains

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:

WaitForInnerTextContains

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

Multiexcerpt macro

name	WaitForInnerTextMatchesPattern

WaitForInnerTextMatchesPattern

WaitForInnerTextNotToBe

This action waits

for

till the inner text of the object changes 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

innerText

Enter

the expected pattern for

the

inner

text

. Pattern

which should not be

regular expression. Step fails

there in

case

the

pattern is invalid

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:

WaitForInnerTextMatchesPattern

WaitForInnerTextNotToBe "

.*[My]text.*

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

Multiexcerpt macro

name	WaitForInnerTextNotContains

WaitForInnerTextNotContains

WaitForInnerTextToBe

This action waits

until the specified attribute's value of the object changes to other than the parameterized value.

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

text which should not be there in the attribute value.

expected text you want to wait for.	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

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

Multiexcerpt macro

name	WaitForInnerTextNotToBe

WaitForInnerTextNotToBe

WaitForInvisibility

This action waits

till the inner text of

for the object

changes from the specified text. The comparison is case-sensitive. You

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

Parameter Name	Parameter Description	Mandatory	Data Type

innerTextEnter the text which should not be there in the object.YesString

timeOut

Enter the timeout (in seconds) to wait for the

text

object to

change

go invisible.

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

expected text

invisibility before exhausting timeout.

No

String

keyInnerTextNotToBe

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:

WaitForInnerTextNotToBe

WaitForInvisibility

"

Connect

5"

"5"

"500" "Key" "Defect"

Multiexcerpt macro

name	WaitForInnerTextToBe

WaitForInnerTextToBe

This action

WaitForNonClickability

This object waits for the object to

contain the expected exact text. The comparison is case-sensitive.

become non clickable. You may specify the timeout and polling interval, if required.
Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type

innerTextEnter the expected text you want to wait for.YesString

timeOut

Enter the timeout (in seconds) to wait for

the expected text

the object to become non clickable.	No	String
pollingInterval	Enter the frequency (in milliseconds) after which you want to check for the

expected text

clickability before exhausting timeout.

No

String

keyInnerText

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:

WaitForInnerTextToBe

WaitForNonClickability

"

Connect

5"

"5"

"500" "Key" "Defect"

Multiexcerpt macro

name	WaitForInvisibility

WaitForInvisibility

WaitForNonExistence

This action waits for the non existence of the specified 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

non existence of the object.

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

invisibility

object before exhausting timeout.

No

String

keyInvisibility

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:

WaitForInvisibility

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

Multiexcerpt macro

name	WaitForNonClickability

WaitForNonClickability

This object

WaitForVisibility

This action waits for the object to

become non clickable. You

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

to become non clickable

visibility.

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

clickability

object visibility before exhausting timeout.

No

String

keyNonClickability

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:

WaitForNonClickability

WaitForVisibility

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

Multiexcerpt macro

name	WaitForNonExistence

WaitForNonExistence

WaitForNumberOfElementsToBe

This action waits for the

non existence of the specified object

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
number	Enter the expected number of elements to wait for.	Yes	Integer
timeOut	Enter the timeout (in seconds) to wait for the

non existence of the object

number elements to appear.

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

non existence of

the

object

objects before exhausting timeout.

No

String

keyNonExistence

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:

WaitForNonExistence

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

Multiexcerpt macro

name	WaitForVisibility

WaitForVisibility

WaitForNumberOfElementsToBeLessThan

This action waits

for the object to be visible

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.	Yes	String
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

Integer

keyVisibility

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:

WaitForVisibility

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

Multiexcerpt macro

name	WaitForNumberOfElementsToBe

WaitForNumberOfElementsToBe

WaitForNumberOfElementsToBeMoreThan

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

same as

more 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
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

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

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

Multiexcerpt macro

name	WaitForNumberOfElementsToBeLessThan

WaitForNumberOfElementsToBeLessThan

WaitForChildElement

This action waits for the

number of

child elements of the specified object

locator on the page to be less 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

expectedNumOfElements


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	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

Integer

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:

WaitForNumberOfElementsToBeLessThan

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

Defect" Multiexcerpt macro

name	WaitForNumberOfElementsToBeMoreThan

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 NameParameter DescriptionMandatoryData TypeexpectedNumOfElementsEnter the expected number of elements to wait for.YesIntegertimeOutEnter the timeout (in seconds) to wait for the number elements to appear. NoStringpollingIntervalEnter the frequency (in milliseconds) after which you want to check for the objects before exhausting timeout. NoStringkeyNumOfElementsLessThanEnter 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:

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

Multiexcerpt macro

name	WaitForChildElement

WaitForChildElement

This action waits for the child elements of the specified object to appear. You may specify the timeout and polling interval, if required

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

childLocatorType

waitTime

Enter 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)

number of seconds to wait for the

elements

object 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.No

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:

WaitForChildElement

WaitForObject

"id"

"

2

10" "

5"

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 "

500

15"

"Key"

"

Defect"

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.

Page Comparison

Versions Compared

Old Version 46

New Version Current

Key

On this page:

DoubleClick

Click

ClickAction

ClickAt

ClickJS

DoubleClick

RightClick

DownloadFile

DragAndDropToOffset

New Actions

StoreText

On this page:

DragAndDropToOffset

StoreLocation

MouseDown

StoreCSSProperty

MouseOver

MouseUp

RightClick

SendKeySequence

ScrollIntoView

SetFocus

StoreChildCount

SetValueAttribute

StoreValueAttribute

StoreExistence

StorePropertyValue

VerifyEnability

VerifyExistence

VerifyVisibility

StoreText

StoreLocation

StoreCSSProperty

StoreSize

SetValueAttribute

StoreValueAttribute

WaitForStaleness

WaitForAttributeContains

WaitForAttributeNotContains

WaitForStaleness

WaitForAttributeToBe

WaitForAttributeNotContains

WaitForAttributeNotToBe

WaitForAttributeNotToBeEmpty

WaitForAttributeToBeEmpty

WaitForAttributeNotToBeEmpty

WaitForClickability

WaitForAttributeToBeEmpty

WaitForExistence

WaitForClickability

WaitForInnerTextContains

WaitForExistence

WaitForInnerTextMatchesPattern

WaitForInnerTextContains

WaitForInnerTextNotContains

WaitForInnerTextMatchesPattern

WaitForInnerTextNotToBe

WaitForInnerTextToBe

WaitForInnerTextNotToBe

WaitForInvisibility

WaitForInnerTextToBe

WaitForNonClickability

WaitForInvisibility

WaitForNonExistence

WaitForNonClickability

WaitForVisibility

WaitForNonExistence

WaitForNumberOfElementsToBe

WaitForVisibility

WaitForNumberOfElementsToBeLessThan

WaitForNumberOfElementsToBe

WaitForNumberOfElementsToBeMoreThan

WaitForNumberOfElementsToBeLessThan

WaitForChildElement