Document toolboxDocument toolbox

WebPage Actions

Owned by ravi.chandran (Unlicensed)
Last updated: Feb 20, 2021

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

ClickJSAndSelectWindowUsingURL

This action is used to click the web element or object that opens single or multiple windows from which a specific window is selected.
This action accepts 'waitTimeForWindow' for the specific window to open.

This action is used in the following 2 scenarios:

  • When a single window opens after clicking the web element/object, you need to give only 'waitTimeForWindow' parameter. 
  • When multiple windows open after clicking the web element or object, then you can provide the exact URL or regex patterned URL  window. You must give the URL and 'isURLPatternString' parameters.
    Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTimeForWindow

Enter the wait time for the window to open.

Yes

String

URL

Enter a specific URL or regex pattern of URL for the window you want to select.

NoString
isURLPatternString

Enter one of the following:

  • True: If you want to apply the regex pattern to URL.
  • False: If you do not want to apply the regex pattern to URL.
NoString

Example 1

String waitTimeForWindow : "5",

String url : null(do not give any value)

String isURLPatternString : null(do not give any value)

Expected Result - Here you do not need to provide URL or isURLPatternString as after clicking the object or element opens. The action waits up to 5 seconds for the window to appear after clicking the web element or object and then select the window.

Example 2

String waitTimeForWindow - "5",

String url - "https://bflsme--preprod.cs57.my.salesforce.com/_ui/common/data/LookupPage?                                                             lkfm=editPage&lknm=cas3&lktp=003&lksrch=",

String isURLPatternString - "False",

The action waits for up to 5 seconds for multiple windows to appear after clicking web element or object and it selects the window with the url "https://bflsme--preprod.cs57.my.salesforce.com/_ui/common/data/LookupPage?lkfm=editPage&lknm=cas3&lktp=003&lksrch=". As the isURLPatternString parameter is 'false' , the action finds as per the given URL.  

Example 3

String waitTimeForWindow - "5",

String url - "www.([A-Z])\w+",

String isURLPatternString - "True",

Expected Result - The action waits for up to 5 seconds for multiple windows to open after clicking web element/object and it selects the window which matches the regex pattern  "www.([A-Z])\w+" as provided in the URL parameter. As the isURLPatternString parameter is 'True', the action treats the URL parameter as a regex pattern. In case there are multiple windows satisfying the regex pattern, the action selects the first window.  

ClickLinkByText

This action clicks the link specified by the user on the page.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

link

Enter the text of the link which you want to click. 

Yes

String

Example:

ClickLinkByText                             "Advanced Search"

On this page:

DoubleClickLinkByText

This action double-clicks the link specified by the user on the page.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

link

Enter the text of the link which you want to double-click. 

Yes

String

Example

DoubleClickLinkByText           "Advanced Search"

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.

No

String

Example:

RightClick             "3''

This will select the third option from the context-menu.

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameter. 

Example:

ScrollIntoView

SetFocus

This action sets the focus on the specified object.

This action does not have any parameter. 

Example:

SetFocus

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

keyProperty

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

Yes

String

propertyEnter the property name whose value you want to store.YesString


Example:

StoreCSSProperty        "display"            "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"

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

keyXPosition

Enter the key name to store the height of the location of the object.

Yes

String

keyYPosition

Enter the key name to store the width of the location of the object.

Yes

String

Example:

StoreLocation        "Height"            "Width"

StorePropertyValue

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

Some Android and iOS properties are not accessible.

List of accessible properties for Android: "name", "contentDescription", "className", "resourceId", "text", "enabled", "checkable", "checked", "clickable", "focusable", "focused", "longClickable", "scrollable", "selected", "displayed"

List of accessible properties for iOS: "name", "value", "label", "hint"

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

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

Yes

 String

Property

Property/attribute name whose value needs to be stored under the specified key. This can be any accessible property of Android/iOS native object mentioned above.

Yes

 String

Example:

StorePropertyValue                            "key"                     "text"

StoreSize

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

keyXPosition

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

Yes

String

keyYPosition

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

Yes

String

Example:

StoreSize           "Height"                   "Width"

StoreText

This action stores the text existing inside the specified object under the specified keys. The key values can be retrieved using the key names. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

keyText

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

Yes

String

Example:

StoreText        "Key" 

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameter can be true or false.

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

No

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 parameter can be true or false.

  • Set True if you want to check the visibility.
  • Set False if you want to check the invisibility.
    Note: If you do not enter any value, the default value is set to True during the test case execution.

No

String

Example: VerifyVisibility                      "True"

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"

WebObject.StoreVisibility 

This action stores the visibility status for a web element under the specified key name in the following conditions:

  • True: If the web element is visible.
  • False: If the web element is not visible.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

Enter a variable to store the visibility status.
No

String

Example: WebObject.StoreVisibility   "Key"

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.