Sets the device orientation.

Arguments:

• Orientation. The orientation of the device; String

Sends the AUT to the background when an SMS is received.

Arguments:

• Respond to event. If True, the device responds to the incoming SMS; Boolean

• Background Time. The amount of time (in seconds) the AUT stays in the background; Integer Min: 0; Default: 10

• From. The number of the SMS sender; String

• Body. The content of the SMS; String

Sends the AUT to the background when a call is received.

Arguments:

• Respond to event. If True, the device responds to the incoming call; Boolean

• Background Time. The amount of time (in seconds) the AUT stays in the background; Integer Min: 0; Default: 10

• From. The number of the caller; String

Presses a key on a keyboard including non-alphanumerical values, such as Space, Delete, and the expansion of the keyboard to show more numbers or characters.

Arguments:

• Key. The key to input.

Sets the device location to a new physical location.

Arguments:

• Latitude. Min: -90; Maximum: 90

• Longitude. Min: -180; Maximum: 180

Sends the AUT to the background.

Argument:

• Background Time. Amount of time (in seconds) the AUT stays in the background. ; Integer Min: 1; Max: 10

Types in text.

Argument:

• Value. The text to enter; String
• Typing Interval. The average time in milliseconds between keystrokes; Integer Min: 200; Max: 3000; A value of 0 indicates no wait between the keystrokes.

Performs a swipe in the specified direction.

Arguments:

• Direction. The direction of the swipe; String

• Start X Offset/Start Y Offset. The x and y coordinates at which to start the swipe. The specified x and y coordinates are relative to the upper left corner of the device; Float

• Number of Touches (iOS only). The number of points to touch, emulating the number of fingers you would use for the gesture on a real device; Integer

Switches the keyboard layout from letter to numbers and back.

Arguments:

• Layout. The keyboard layout: numbers(default) or letters.

Presses the device's Home button.

Presses the device's Back button.

Android

Presses the device's Menu button.

Opens the list of recent apps.

Presses the device's keypad enter button. (Relevant only in apps that support it.)

Presses the device's keypad search button (Relevant only in apps that support it.)

Presses the device's delete button, if it exists.

Simulates a Touch action on the device.

Arguments:

• X/Y Coordinate. The x/y coordinates of the touch. The specified x and y coordinates are relative to the upper left corner of the device; Float

Android

Scrolls an object into view.

Arguments:

• Direction. The direction of the scroll operation; String

• Object index. The index of the scrollable object on the screen; String

Makes the current WebView active.

SetFocus

Android, iOS

Sets the focus to the browser.

SetText

Android, iOS

Sends text to the browser.

Arguments:

• Value. Text to set in the input object; String

Tap

Android, iOS

Taps in the browser.

ScrollOnePage

Android, iOS

Scrolls a single page in the browser.

Arguments:

• Direction. The direction of the scroll; String

Navigate

Android, iOS

Navigates to the specified URL.

Arguments:

• Location. A URL

Refresh

Android, iOS

Refreshes the browser window.

Back

Android, iOS

Navigates back to the previously viewed page.

Forward

Android, iOS

Navigates forward to the previously viewed page.

Inputs the specified text.

Arguments:

• Value. The text to enter in the edit box; String

If the recorded SetText action is for a password field, we strongly recommend to store the encrypted password and use the TC.unmask function to retrieve the argument.

Sets the focus on the input object.

Removes the focus from the input object.

Picks an item in the view.

Arguments:

• Row index. The row index to select. Required if no Row title argument is specified; Integer

• Row title. The row title to select. Required if no Row index argument is specified; String

• Column index. The column index to which to apply the Row index and Row title; Integer

• X Offset/Y Offset. The x and y coordinates of the pick. The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object.; Float

Selects a check box.

Arguments:

• Value. on/off;

Selects a label.

Arguments:

• Value. on/off;

Sets the selected date, using the specified format.

Arguments:

• Selected Date. The value to set in the Date Selector. This can be a time or a date or both.

• Date Format. The format of the Selected Date argument.

  Click to see the supported formats

  yyyy-MM-dd — e.g. 2017-01-02

  d/MM/yyyy — e.g. 2/01/2017

  MMM d, y — e.g. Jan 2, 2017

  d MMM y — e.g. 2 Jan 2017

  d MMMM, y — e.g. 2 Jan, 2017

  In addition, you can append the hour format to any of the above date formats. HH indicates a 24-hour clock, while hh indicates a 12-hour clock. The a character specifies the period of the day, AM or PM, for the hh, 12-hour clock format.

  HH:mm — e.g. 22:30

  hh:mm — e.g. 10:30

  hh:mma — e.g. 10:30PM

  hh:mm a — e.g. 10:30 PM

Inherits all View actions.

Selects the indexed page.

Arguments:

• Index. The numeric index of the page to select; Integer Min: 0

Selects the button in the radio group, by index or text.

Arguments:

One of these arguments must be specified:

• Index. The numeric index of the button in the radio group; Integer

• Text. The name of the button to select; String

Selects the rating value.

Arguments:

• Value. The rating value to select in the rating bar.

Moves the slider to the specified position.

Arguments:

• Value. The new position for the slider.

Possible values for position are determined by the range of the slider.

Increments or decrements the stepper.

Arguments:

• Value. increment/decrement

Arguments:

• Value. on/off

Selects a tab.

Arguments:

One of the following must be specified:

• Index. The 0-based index of the tab to select; Integer

• Text. The name of the tab to select; String

Turns a button on or off.

Arguments:

• Value. on/off

Scrolls to an item and section in the collection view.

Arguments:

Specify either the Item and Section parameters or the x/y offset parameters.

• Item/Section. The numeric index of the item and section to which to scroll; Integer Min: 0
• X Offset/Y Offset. The x and y coordinates of the scroll, relative to the upper left corner of the object. The default value is the center of the object; Float

Selects an item and section in the collection view.

Arguments:

• Item. The index of item to select in the collection; Integer

• Section. The section to select inside the item; Integer

• X Offset/Y Offset. The x and y coordinates of the selection. The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object; Float

Deselects an item and section in the collection view.

Arguments:

• Item. The numerical index of the item to select in the collection; Integer

• Section. The numerical index of the section to select within the item; Integer

Scrolls the collection view one page over in the selected direction.

Arguments:

• Direction. The direction to scroll; String

Scrolls to the top of the collection view.

iOS only: Scrolls the element the specified number of pixels.

Arguments:

• X Offset/Y Offset. The x/y coordinates of the scroll.

Android: No arguments. The scroll location is decided according to the internal object representation.

Enlarges or decreases the object view according to the specified scale.

Arguments:

• X Offset/Y Offset. The x/y coordinates of the zoom. The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object; Float

• Scale. The zoom scale (for example, 0.5 to reduce to half, or 2 to double the size); Float

Scrolls the page up or down in the selected direction.

Arguments:

• X Offset/Y Offset (Android only): The x/y coordinates at which to start the scroll. The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object; Float

• Direction. The direction to scroll (up or down); String

Taps the table where specified.

Arguments:

• Row. The index of the row in the table to tap on; Integer Min: 0

• Section. The numeric index of the section in the table that contains the row to tap on; Integer Min: 0

• X Offset/Y Offset. The x/y coordinates to tap inside the table; Float

Deletes a row from the table.

Arguments:

• Row. The numeric index of the row to delete; Integer Min: 0

• Section. The numeric index of the section from which to delete the row; Integer Min: 0

Selects a row in a section in the table.

Arguments:

• Row. The index of the row in the table to select; Integer

• Section. The numeric index of the section in the table that contains the row being selected; Integer

• X Offset/Y Offset. The x/y coordinates to select inside the table; Float

Selects a row in a section in the table.

Arguments:

• Label. The label of the row to select; String

Scrolls up or down.

Arguments:

• Row. The row index in the table to tap on; Integer

• Section. The section containing the row to tap on, usually the column; Integer

• X Offset/Y Offset (iOS only). The x/y offsets (in pixels) inside the table. If you use these arguments, set the x-offset to 0. ; Float

  Note: The specified coordinates are relative to the upper left corner of the table.

Scrolls to a specific label.

Arguments:

• Label. The label text; String

Scrolls forward, backward, left, or right.

Arguments:

• Direction. The direction to scroll; String

Scrolls to the top of the table.

Inserts a row in the table.

Arguments:

• Row. The index of the row to insert; Integer Min: 0

• Section. The index of the section in which to insert the row.; Integer Min: 0

Deletes a row from the table.

Arguments:

• Row. The index of the row to delete; Integer
• Section. The index of the section from which to delete the row; Integer

Moves a row to a new location in the table.

Arguments:

• Source row. The index of the row to move; Integer

• Destination row. The index of the new location for the row; Integer

• Source section. The numeric index of the section that contains the Source row; Integer

• Destination section. The numeric index of the section that contains the Destination row; Integer

Simulates tapping on the device's screen.

Arguments:

• X Offset/Y Offset. Horizontal and vertical offset values; Float

  The combination of the x/y offsets gives the point of the tap. This is optional since the tap location is based firstly on the object representation, and only then on the x/y offsets.

Simulates a long press of the user.

Arguments:

• Number of Taps (iOS only). The number of times to tap the object; Integer

• Number of Touches (iOS only). The number of points to touch, emulating the number of fingers you would use for the gesture on a real device; Integer

• Duration. The number of seconds to continue pressing; Integer

• X Offset/Y Offset. The x and y-coordinates of the long press. The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object; Float

Retrieves the specified property.

Arguments:

• Property. The name of the property to retrieve; String

• Variable. The name of the JavaScript variable to store the value for later use; String

Swipes the view in the specified direction.

Arguments:

• Direction. The direction of the swipe; String

• Start X Offset/Start Y Offset. The x and y coordinates at which to start the swipe. The specified coordinates are relative to the upper left corner of the device. The default value is the center of the device; Float

• Number Of Touches(for iOS only). The number of points to press, similar to the number of fingers you would use for the gesture on a real device; Integer

Performs a Pan gesture on the object.

Arguments:

• Offsets:

  The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object.

  • Start X Offset/Start Y Offset. The x and y coordinates at which to start the pan gesture; Float

  • End X Offset/End Y Offset. The x and y coordinates at which to end the pan gesture; Float

  • Velocity X Offset/Velocity Y Offset. The horizontal and vertical velocity of the pan gesture; Float

Performs a Pinch gesture.

Arguments:

• Scale. The scale for the pinch gesture. This number is the ratio between the start distance and the end distance between the two touch points used for the pinch; Float

  Example: If you were to touch a screen with your fingers 6 cm apart, and pinch until your fingers were 3 cm apart, the scale would be 0.5.

• Velocity. The speed at which to perform the pinch gesture. This number specifies the scale factor per second—i.e. the ratio between the touch point distance at one second, and the touch point distance one second later; Float

  Example: If performing a pinch from 6 cm to 3 cm (0.5 scale) takes 2 seconds, then the velocity is 0.25.

• X Offset/Y Offset. The x and y coordinates for the pinch gesture.

  The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object.; Float

Rotates the view.

Arguments:

• Rotation. The degrees to rotate the view; Integer

• Velocity. The speed at which to perform the rotation gesture. This number specifies the scale factor per second—that is, the ratio between the touch point distance at one second, and the touch point distance one second later; Float

• X Offset/Y Offset. The x and y coordinates for the rotation gesture. The specified coordinates are relative to the upper left corner of the object. The default value is the center of the object; Float

Verifies the view.

Arguments:

• Value. The string, number, or regular expression to verify.

• Property. The object property for which to verify the value.

• Condition. The verification condition: "Contain", "Not Contain", "Equal", "Not Equal", "Less Than", "Greater Than", "Less Than or Equal", "Greater Than or Equal", or "Regular Expression".