Document toolboxDocument toolbox

A new version of Qualitia Automation Studio for Web and Mobile 7.2.x is now available. We highly recommend you upgrade. Find more details here.

WebElement Actions

Owned by Sagar Dubewar (Unlicensed)
Last updated: Mar 02, 2018

Click

This action clicks the specified object.

This action does not have any parameter.

Example:
Click

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:

ParameterName

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"

On this page:

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"

MouseOver

This action simulates a mouse hovering over the specified object.

This action does not have any parameter. 

Example:
MouseOver

MouseDown

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String

Example:

MouseDown                 "5"           "10"

MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

MouseUp              "50"           "38"

ClickAt

This action clicks at the 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"

SetFocus

This action sets the focus on the specified object.

This action does not have any parameter. 

Example:
SetFocus

DoubleClick

This action double-clicks the particular web element.

This action does not have any input parameter.

Example:
DoubleClick


RightClick

This action right-clicks the specified web element.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String

Example:
RightClick             "3''

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

WaitForObject

This action waits for the object to 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.

ClickAndWait

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.

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





Example 
DownloadFile               "C:/ProgramData"              "Qualitia" 
(warning) This action is tested on IE8, FF & chrome. This action is not supported on IE9, IE10, and Google Chrome <16.

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.

Yes

String

Example:
DragAndDrop            "100"              "500"

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"

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"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameter. 

Example:

ScrollIntoView

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

ActionClick

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:

ActionClick

Not finding what you need?