Document toolboxDocument toolbox

MobileRadioButton Actions

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.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

State

Value of this parameter can be either True or False.

  • Set True if you want to check that the radio button is selected.
  • Set False if you want to check that the radio button is deselected.

No

String


If radio button is selected and state is "true", result is success. If radio button is selected and state is "false" result is failure.

If radio button is not selected and state is "true", result is failure. If radio button is not selected and state is "false" result is success.

Example:

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.

This action does not have any parameter. 

Example:

Select

On this page:


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.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

groupName

Enter the resource ID of the radio group.

Yes

 String

Index

Enter the index of the radio button in the radio group. Index starts at 1.

No

String

Example:

SelectByIndex              "com.sample.app:id/radiogroup1"         "2"

SelectIfTrue

This action selects the radio button if parameter passed is TRUE.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Select

Value of this parameter can be true or false.

  • Set True if you want to select the radio button.
  • Set False if you do not want to select the radio button.

No

String

Example:

SelectIfTrue                        "True"

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"

Swipe

This action performs swipe and finds object until timeout occurs.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

upDownLeftRight

Enter the direction of swipe:

  • Up: Move finger from down to up on the device screen.
  • Down: Move finger from up to down on the device screen.
  • Left: Move finger from right to left on the device screen.
  • Right: Move finger from left to right on the device screen.

No

String

timeoutInSeconds

Enter the timeout in seconds.

No

String

swipePageInSeconds

Enter in how many seconds one page should be swiped. Default is 1 second.
Use this parameter with caution only when control on swipe speed is required.

No

String

Example:

Swipe                  "up"                   "10"             "1"

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"

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

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.