This section includes the detailed documentation for the following object classes of Mobile.
Mobile General Actions
Mobile.DragAndDropToObject
This action drags the specified mobile object and drops on another specified mobile object.
Input Parameters:
| Parameter Nane | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
| dragLocator | The locator value of the mobile element you want to drag. | Yes | String |
| dragLocatorType | The locator type of mobile element you want to drag. | Yes | String |
| dropToLocator | The locator value of the mobile element on which you want to drop. | Yes | String |
| dropToLocatorType | The locator type of the mobile element on which you want to drop. | Yes | String |
Mobile.CloseApp
This action closes the specified application or mobile browser.
...
As the mobile app is closed, you cannot have any mobile action after the step containing this action.
Example:
Mobile.CloseApp
Mobile.HideKeyboard
This action hides the keyboard if present on the screen.
...
Example:
Mobile.HideKeyboard "Tap_Outside" "Done"
Mobile.OpenApp
This action launches native/hybrid mobile Android or iOS application on the mobile device (emulator or physical). If the app does not exist in the device, this action will take the APK/ IPA file path specified and install it on the device before launching it.
...
Mobile.OpenApp "D:\myapp.apk" "com.app.package" "com.app.package.MainActivity"
Mobile.PressAt
This action clicks at the specified point on the device screen.
...
Mobile.PressAt "5" "10"
Mobile.PressHomeButton
This action opens the home screen of the device.
...
Example:
Mobile.PressHomeButton
Mobile.PressRecentsButton
This action shows the recent application.
...
Example:
Mobile.PressRecentsButton
...
Mobile.SwitchApp
This action launches new native/hybrid mobile Android or iOS application to which you want to switch from the already launched native/hybrid mobile application.
...
Mobile.SwitchApp "com.app.package" "com.app.package.MainActivity"
SwitchWebExecutionPlatform
This action changes the current Web execution platform from Desktop to Mobile or from Mobile to Desktop. When used, web application test case will run on specified platform.
...
SwitchWebExecutionPlatform "Mobile"
Mobile.PressBackButton
This action taps back button on the Mobile device.
...
Example:
Mobile.PressBackButton
Mobile.StoreWebViewHandle
This action stores the web view handle under the specified key. The key value can be retrieved using the key name.
...
Example:
Mobile.StoreWebViewHandle "Key"
Mobile.SelectWebView
This action selects the web view present in the current page hybrid app. If key is provided (by using StoreWebViewHandle action), system selects the webview specified in key. If key is not provided, default webview will be selected.
...
Example:
Mobile.SelectWebView "Key"
Mobile.SelectNativeContext
This action can be used to select native context from the hybrid app.
...
Example:
Mobile.SelectNativeContext
Mobile.SelectWebViewUsingURL
This action selects the web view using the URL or pattern specified in the parameters.
...
Mobile.SelectWebviewUsingURL "www.google.com" "False"
Mobile.PressKeys
This action presses the specified keys using the mobile keyboard.
...
Mobile.Presskeys “CAP_LOCKED”
Mobile.Swipe
This action performs swipe based on the coordinates provided in the parameters.
...
Mobile.Swipe "100" "123" "145" "121" "1"
Mobile.OpenNotification
A notification is a message at the device level against the application and stored in the notification panel.
...
Example:
Mobile.OpenNotification
Mobile.VerifyToast
A toast provides simple feedback about an operation in a small popup.
...
Mobile Element Actions
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
...
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.
...
Example: StorePropertyValue "key" "text"
StoreVisibility
This action stores visibility of the mobile object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
Example:
StoreVisibility "Key"
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
Example: VerifyExistence "True"
WaitForObject (Deprecated)
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...
MobileButton Actions
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
...
StoreExistence "Key"
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
...
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
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.
...
StorePropertyValue "key" "text"
StoreVisibility
This action stores visibility of the mobile object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
Example:
StoreVisibility "Key"
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
VerifyExistence "True"
WaitForObject
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...
MobileCheckbox Actions
Check
This action selects the specified check box.
This action does not have any parameter.
Example:
Check
CheckIfTrue
This action selects the check box, only if the parameter passed is True.
...
CheckIfTrue "True"
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
...
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
IsChecked
This action verifies whether the specified check box is selected.
...
IsChecked "True"
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
...
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.
...
StorePropertyValue "key" "text"
StoreVisibility
This action stores visibility of the mobile object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
Example:
StoreVisibility "Key"
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
Uncheck
This action deselects the specified check box.
This action does not have any parameter.
Example:
UnCheck
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
VerifyExistence "True"
WaitForObject
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...
MobileDropDown Actions
| Note |
|---|
These actions are available when working with the Android application testing only. |
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
SelectItemByName
This action selects the specified item from the MobileDropDown. The parameter value specified here is case-sensitive.
...
SelectItemByName "Qualitia"
...
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
...
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.
...
StorePropertyValue "key" "text"
StoreVisibility
This action stores visibility of the mobile object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
Example:
StoreVisibility "Key"
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
VerifyExistence "True"
WaitForObject
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...
MobileList Actions
| Info |
|---|
MobileList control is abstract control for any layout/widget having list-item like structures in UIAutomator. UIAutomation such as Android (android.widget.ListView, any RelativeLayout having listItems child, elements grandchild, and TableLayout android.widget.GridView) In the iOS platform, only UITable with UITableCell is seen (only that is supported for now). The following limitations of the MobileList control are:
|
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
ClickElement
This action clicks the element present at the specified location.
...
ClickElement "3" "2"
CompareListItemMembersData
This action compares the data present at the specified list item member index.
...
CompareListItemMembersData "2" "Qualitia^QTP^WebDriver"
CompareListItemData
This action compares the data present at the specified list item index.
...
CompareListItemData "2" "Qualitia^QTP^WebDriver"
...
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
DeSelectCheckboxAtListItemMember
This action deselects the check box present at given list item index.
...
DeSelectCheckboxAtListItemMemberIndex "3" "7"
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
SelectCheckboxAtListItemMember
This action selects the check box present in the specified list item member.
...
SelectCheckboxatListItemMember "5" "4"
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
...
StoreExistence "Key"
StoreListItemCount
This action stores the count of list items in the specified key. The key value can be retrieved using the key name.
...
StoreListItemCount "Key"
StoreListItemIndexContainingMaxValue
This action stores the list item index which contains the maximum value. This action only works with numerical data.
...
StoreListItemIndexContainingMaxValue "Key" "1"
StoreListItemIndexContainingMinValue
This action stores the list item index which contains the minimum value. This action only works with numerical data.
...
StoreListItemIndexContainingMinValue "Key" "1"
StoreListItemIndexContainingText
This action stores the list item index which contains the specified text.
...
StoreListItemIndexContainingText "Key" "Qualitia" "1"
StoreListItemIndexContainingTextInArray
This action checks if each string separated by caret is part of the list item member data.
...
StoreListItemIndexContainingTextInArray "Key" "d^f" "3"
StoreListItemMembersCount
This action stores the total count of the specified list item members under the specified key. The key value can be retrieved using the key name.
...
StoreListItemMembersCount "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.
...
StorePropertyValue "key" "text"
StoreVisibility
This action stores visibility of the mobile object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
Example:
StoreVisibility "Key"
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
VerifyDataExistenceInListItem
This action verifies the existence of the data in the specified list item.
...
VerifyDataExistenceInListItem "7" "Zensoft^9" "True"
VerifyDataExistenceInListItemMembers
This action verifies the existence of the data present in the specified list item member index.
...
VerifyDataExistenceInListItemMembers "5" "Qualitia^6" "False"
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
VerifyExistence "True"
VerifyListItemCount
This action verifies the total count of items present under the list with the expected specified count.
...
Example:
VerifyListItemCount "5"
VerifyListItemMemberCount
This action verifies the list item member count with the expected specified count.
...
VerifyListItemMemberCount "5"
VerifyText
This action verifies the actual data of the specified location matches with the expected data.
...
VerifyText "Qualitia" "3" "1"
WaitForObject (Deprecated)
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...
MobileText Actions
ClearText
This action clears the text present in the specified MobileEdit box.
This action does not have any parameter.
Example:
ClearText
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
SecureSet
This action enters the value into the specified MobileEdit box. When you remove the mouse from the parameter in Test Case Editor screen, the value is displayed in the encrypted format.
Input Parameters:
| Paramters Name | Parameter Description | Mandatory | String |
|---|---|---|---|
| Text | Enter the test that needs to be entered in the specified text box in the specified format. Format: Encrypt(<TEXT TO BE ADDED>) | Yes | String |
...
SecureSet "Encrypt(Abc)". When you remove mouse from the parameter in Test Case Editor screen, you will view the data ABC as encrypted form such as "vHpmlfI4R3PQkCN4sZnuqw==þNWE3ZDdkNjE3N2JmNDM2ODgxMzQwYWI1MTA3YWNjMDc="
Set
This action sets the text into mobile text box object.
...
Set "Qualitia"
...
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
...
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.
...
StorePropertyValue "key" "text"
StoreText
This action reads the existing text available in mobile text box and stores it into the specified key.
...
StoreText "Key"
StoreVisibility
This action stores visibility of the object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
StoreVisibilty "Key"
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
VerifyExistence "True"
WaitForObject
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...
MobileRadioButton Actions
| Note |
|---|
These actions are available when working with the Android application testing only. |
Click
This action clicks the specified object.
This action does not have any parameter.
Example:
Click
IsSelected
This action verifies whether the radio button is selected or deselected.
...
IsSelected "True"
LongPress
This action performs the long press event on the specified object.
This action does not have any parameter.
Example:
LongPress
Select
This action selects the specified radio button.
...
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
SelectByIndex
This action selects the specified radio button based on its index number. The index starts from 1. This action should be used only when radio button is part of a radio-group and group has a valid resource ID on Android.
...
SelectByIndex "com.sample.app:id/radiogroup1" "2"
SelectIfTrue
This action selects the radio button if parameter passed is TRUE.
...
SelectIfTrue "True"
StoreExistence
This action stores existence of the object under the specified key. The key value can be retrieved using the key name.
...
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.
...
StorePropertyValue "key" "text"
StoreVisibility
This action stores visibility of the mobile object under the specified key. The key value can be retrieved using the key name.
Input Parameters:
...
Example:
StoreVisibility "Key"
Swipe
This action performs swipe and finds object until timeout occurs.
...
Swipe "up" "10" "1"
VerifyEnability
This action verifies the enability of the specified object.
...
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|---|---|---|
enability | Value for this parameter can be True or False.
| No | String |
Example:
VerifyEnability "True"
VerifyExistence
This action verifies the existence of the specified object.
...
VerifyExistence "True"
WaitForObject
This action waits for the object to appear or disappear for the maximum number of seconds specified.
...