Mobile Keywords

5.2.1. Active App

Active app with application ID.

• Target: No Object Repository is required.
• Data Input

appID: Input the Id of application want to active.

5.2.2. Check Device Is Locker

Check the device if it is locked.

• Target: No Object Repository is required.

• Data: No Data input is required.

Create output for this step in Variable Tab of the test case

​ Then result will return as shown in report below.

5.2.3. Check Keyboard Is Showing

Check keyboard if it is showing.

• Target: No Object Repository is required.

• Data: No Data input is required.

Create output for this step in Variable Tab of the test case

​ Then result will return as shown in report below.

5.2.4. Clear Text

Clear text of a mobile element within a time in second unit.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

5.2.5. Click

Click on the given element.

• Target: Select Mobile UIObject that you defined in Object Repository

​ This represents for element that you want to click on.

• Timeout: System will wait at most timeout (second) to return result

• Data Input: No Data Input is required.

5.2.6. Double Tap

Perform a double-tap action on a mobile element.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input No Data Input is required.

5.2.7. Double Tap With Coordinates

Double tap an element with coordinates.

• Target: No Object Repository is required.

• Data Input

x: point coordinates to tap on the screen on the horizontal axis

y: point coordinates to tap on the screen along the vertical axis.

5.2.8. DouDrag And Drop To Element

Drag an object and drop it onto another object.

• Target: Select UIObject of moved element.

• Data Input

In this Data Input, you will input data of destinationObject, where you want to drop to

Field	Description
Parameter type	You have to select a Mobile UIObject from Object Repositories.
Value	Double-click here, system will prompt a Mobile UIObjects screen for you to choose Mobile UIObject for destination Object.
Timeout	System will wait at most timeout (seconds) to return result.

5.2.9. Drag And Drop To Position

Drag an object and drop it to position.

• Target: Select UIObject of moved element.

• Data Input

In this Data Input, you will input data of destinationObject, where you want to drop to

Parameter	Description	Type
x	Point coordinates to tap on the screen on the horizontal axis	Integer
y	Point coordinates to tap on the screen along the vertical axis	Integer
timeout	System will wait at most timeout (seconds) to return result.	Integer

5.2.10. Get App State

Get the app’s state with application’s ID.

• Target: No Object Repository is required.
• Data Input

Input the application’s ID in cell “Input”.

• Data Output: Create output for this step in Variable Tab of the test case. Then result will return as shown in report below.

5.2.11. Get Attribute Value

Get a specific attribute of a mobile element.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	- attributeName: such as id, name, class, text…. - timeout: System will wait at most timeout (seconds) to return resultPoint coordinates to tap on the screen along the vertical axis
Parameter type	Default is string and you cannot edit
Value	I nput which attribute of the element that you want to get information from
Output	Create output for this step in Variable Tab of the test case.

5.2.12. Get Device Time

Get time in device follow the output’s format.

• Target: No Object Repository is required

• Data Input

- Create an output in the “Output” column to see the result.

- Input the format time you want. Example in the photo below

5.2.13. Get Location

Get the device's location.

• Target: No Object Repository is required.
• Data Input: No Data input is required

• Data Output: Create output for this step in Variable Tab of the test case. Then result will return as shown in report

5.2.14. Get Screen Height

Get the device's physical height.

• Target: No Object Repository is required.
• Data Input: No data input is required.

• Data Output: Create output for this step in Variable Tab of the test case. Then result will return as shown in report below.

5.2.15. Get Screen Orientation

Get the current screen orientation of the device.

• Target: No Object Repository is required.
• Data Input: No data input is required.

• Data Output: Create output for this step in Variable Tab of the test case

5.2.16. Get Screen Width

Get the device's physical width.

• Target: No Object Repository is required.

• Data Input: No data input is required.

5.2.17. Get Text

Get the visible (i.e. not hidden by CSS) inner text of the element, including sub-elements, without any leading or trailing whitespace.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input: Input timeout then System will wait at most timeout (seconds) to return result
• Data Output: Create output for this step in Variable Tab of the test case.

5.2.18. Hide Keyboard

Hide the keyboard in device.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.19. Look Device

Lock the device.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.20. Long Press

Perform a long press action on a mobile element.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Parameter	Description	Type
pressDuration	Set the time in second to perform long press in element	Integer
timeout	Input timeout then System will wait at most timeout (seconds) to return result	Integer

5.2.21. Long Press Android Keycode

Long Press using Mobile key code (it’s the same as using keyboard when testing Web app).

• Target: No Object Repository is required for this keyword.

• Data Input

In this Data Input, you will input data of destinationObject, where you want to drop to

Field	Description
Parameter name	keycode: These belong to Mobile actions, not application
Parameter type	Default is above image, you cannot edit
Value	Choose value from the dropdown list, which lists all Mobile actions.

5.2.22. Long Press With Coordinates

Longpress in viewport with coordinates.

• Target: No Object Repository is required.

• Data Input

In this Data Input, you will input data of destinationObject, where you want to drop to

Parameter	Description	Type
x	Point coordinates to tap on the screen on the horizontal axis	Integer
y	Point coordinates to tap on the screen along the vertical axis	Integer
pressDuration	Duration for press within seconds time unit.	Integer

5.2.23. Press Android Keycode

Long Press using Mobile key code (it’s the same as using keyboard when testing Web app).

• Target: No Object Repository is required for this keyword.

• Data Input

In this Data Input, you will input data of destinationObject, where you want to drop to

Field	Description
Parameter name	keycode: These belong to Mobile actions, not application
Parameter type	Default is above image, you cannot edit
Value	Choose value from the dropdown list, which lists all Mobile actions.

5.2.24. Scroll By Coordinate

Scroll in view port using coordinate.

• Target: No Object Repository is required.

• Data Input

Parameter	Description	Type
xStart	Starting point coordinates on the horizontal axis to swipe on the screen	Integer
yStart	Starting point coordinates on the vertical axis to swipe on the screen	Integer
xEnd	Ending point coordinates on the horizontal axis to swipe on the screen	Integer
yEnd	Ending point coordinates on the vertical axis to swipe on the screen.	Integer

5.2.25. Scroll Down Till Element In View Port

Scroll down in view port till element display in view port.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Parameter	Description	Type
maximumNumberOfScroll	The maximum number of scroll down in view port	Integer
findElementTimeout	Timeout for find element	Integer

5.2.26. Send Keys

Send text to a mobile element.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	Text: the text you want to send; timeout: System will wait at most timeout (second) to return result.
Parameter type	Default is above image, you cannot edit
Value	Input value for Parameter Name explained above.

5.2.27. Set Location

Set location for device.

• Target: No Object Repository is required for this keyword.

• Data Input

In this Data Input, you will input data of destinationObject, where you want to drop to

Field	Description
Parameter name	- latitude: The Latitude of location - longitude: The Longitude of location - altitude: The altitude of location.
Parameter type	Default is above image, you cannot edit
Value	Input value for Parameter Name explained above

5.2.28. Shake

Simulate shake the device.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.29. Start Mobile Automation

Start up a mobile application.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.30. Stop Mobile Automation

Close the currently running application.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.31. Swipe By Coordinate

Simulate swiping fingers on the mobile device with coordinate.

• Target: No Object Repository is required.

• Data Input

Parameter	Description	Type
xStart	Starting point coordinates on the horizontal axis to swipe on the screen	Integer
yStart	Starting point coordinates on the vertical axis to swipe on the screen	Integer
xEnd	Ending point coordinates on the horizontal axis to swipe on the screen	Integer
yEnd	Ending point coordinates on the vertical axis to swipe on the screen.	Integer

5.2.32. Switch to Landscape

Change the device’s screen view to Landscape mode.

• Target: No Object Repository is required.

• Data Input: No Data input is required.

5.2.33. Switch to Portrait

Change the device’s screen view to Portrait mode.

• Target: No Object Repository is required.

• Data Input: No Data input is required.

5.2.34. Tap

Tap an element in screen within timeout is seconds unit.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input: Input the timeout.

5.2.35. Tap With Coordinates

Tap an element in screen with coordinate.

• Target: No Object Repository is required.

• Data Input

x: point coordinates to tap on the screen on the horizontal axis

y: point coordinates to tap on the screen along the vertical axis.

5.2.36. Terminate App

Terminate application (turn off totally app) with given application ID.

• Target: No Object Repository is required.

• Data Input

5.2.37. Toggle Data

Simulate user switch toogle for using mobile data (3G,4G...).

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.38. Toggle Location Service

Simulate user toggle location service icon.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.39. Toggle Wifi

Simulate user toggle wifi icon.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.40. Unlock Device

Simulate user unlock the device.

• Target: No Object Repository is required.
• Data Input: No Data input is required.

5.2.41. Verify Element Attribute Value

Verify if the mobile element has an attribute with the specified name and value.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	- attributeName: such as id, name, class, text…. - expectedValue: value of given attribute above. For example: class="btn btn-add-to-cart" - Input timeouts: is waiting time for returning result(s).
Parameter type	Default is above image and you cannot edit.
Value	Input value for Parameter Name explained above.

5.2.42. Verify Element Attribute Value By Regex

Verify if the mobile element has an attribute with the name and suitable value by regex.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	- attributeName: such as id, name, class, text…. - regex: A regular expression (shortened as regex or regexp; sometimes referred to as rational expression) is a sequence of characters that specifies a search pattern in text - Input timeouts: is waiting time for returning result(s).
Parameter type	Default is above image and you cannot edit.
Value	Input value for Parameter Name explained above.

5.2.43. Verify Element Attribute Value Different From

Verify if the mobile element has an attribute different with the name and value.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	- attributeName: such as id, name, class, text…. - valueToAvoid: input the value you don’t want attribute name equal - Input timeouts: is waiting time for returning result(s).
Parameter type	Default is above image and you cannot edit.
Value	Input value for Parameter Name explained above.

5.2.44. Verify Element Disabled

Verify if the given element is disabled.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input

Input timeouts: is waiting time for returning result(s).

5.2.45. Verify Element Enabled

Verify if the given element is enable.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input

Input timeouts: is waiting time for returning result(s).

5.2.46. Verify Element Has Attribute

Verify if the mobile element has an attribute with the specified name.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input

attributeName: such as id, name, class….

Input timeouts: is waiting time for returning result(s)

5.2.47. Verify Element In View Port

Verify if the mobile element in view port within the given time (in second).

• Target: Select Mobile UIObject that you defined in Object Repositories.
• Data Input: Input timeouts: is waiting time for returning result(s).

5.2.48. Verify Element Not Has Attribute

Verify if the mobile element doesn't have an attribute with the specified name.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	- such as id, name, class….to verify whether the element has this attribute - timeout: is waiting time for returning result(s)
Parameter type	Default is above image and you cannot edit.
Value	Input value for Parameter Name explained above.

5.2.49. Verify Element In View Port

Verify if the mobile element in view port within the given time (in seconds).

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Input timeouts: is waiting time for returning result(s).

5.2.50. Verify Element Not Present

Verify if the given mobile element does NOT present on the DOM.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: timeout: is waiting time for returning result(s).

5.2.51. Verify Element Not Selected

Verify if the element are not selected.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: timeout: is waiting time for returning result(s).

5.2.52. Verify Element Not Visible

Verify if given mobile element is NOT visible even it presents on the DOM.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: timeout: is waiting time for returning result(s).

5.2.53. Verify Element Present

Verify if the given mobile element does present on DOM.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: timeout: is waiting time for returning result(s).

5.2.54. Verify Element Selected

Verify if the element are selected.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: timeout: is waiting time for returning result(s).

5.2.55. Verify Element Text

Verify text of an element equal with expected text input.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Parameter	Description	Type
expectedText	In the example above, the title has text “Title” and we use Key word “Verify Element Text” to verify exactly the text must be “Title”	String
trimText	Yes/No remove spaces before and after the string, leaving only spaces between words	Boolean
ignoreCase	Yes/No skip the uppercase, lowercase word case check	Boolean
Input timeouts	It is waiting time for returning result(s).	Integer

5.2.56. Verify Element Text By Regex

Verify text contains of an element regex: A regular expression (shortened as regex or regexp; sometimes referred to as rational expression) is a sequence of characters that specifies a search pattern in text.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Input timeouts: is waiting time for returning result(s). Example: rege(x(es)?|xps?) => contains {regex, regexes, regexp, regexps}

5.2.57. Verify Element Text Different From

Verify text of an element different with text input.

• Target: Select UIObject that you defined in Object Repositories.

• Data Input

Field	Description
Parameter name	- textToAvoid: the text you want to avoid it - trimText: Boolean type: yes/no remove spaces before and after the string, leaving only spaces between words - IignoreCase: Boolean type: yes/no skip the uppercase, lowercase word case check - Input timeouts: is waiting time for returning result(s).
Parameter type	Default is above image and you cannot edit.
Value	- textToAvoid: input the text you want to avoid it - trimText: true/false - IignoreCase: true/false - Input timeouts: is waiting time for returning result(s).

5.2.58. Verify Element Visible

Verify if the given mobile element is visible.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.59. Wait For Element Disabled

Wait for element disabled within a time in second unit.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.60. Wait For Element Enabled

Wait for element enabled within a time in second unit.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.61. Wait For Element In View Port

Wait for the given element in view port within the given time (in second).

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.62. Wait For Element Not In View Port

Wait for the given element NOT in view port within the given time (in second).

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.63. Wait For Element Not Present

Wait for the given element to NOT present (appear) within the given time (in second).

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.64. Wait For Element Not Selected

Wait for the given element are NOT selected with in the given time (in second)

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: is waiting time for returning result(s).

5.2.65. Wait For Element Not Visible

Wait until the given mobile element is NOT visible within a timeout.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.66. Wait For Element Present

Wait for the given element to present within the given time (in second).

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.

5.2.67. Wait For Element Selected

Wait for the given element are selected within the given time (in second)

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: is waiting time for returning result(s).

5.2.68. Wait For Element Visible

Wait until the given mobile element is visible within the timeout.

• Target: Select Mobile UIObject that you defined in Object Repositories.

• Data Input: Timeout: System will wait at most timeout (second) to return result.