Drag command

Performs the drag gesture. You can define the touch sequence coordinates and time frame of the drag. The location parameter supplies the coordinates of the start and end points of the drag. There is a touchdown at the beginning of the drag and a touch-up at the end of the drag. A touchdown is performed with the first pair of coordinates. This is followed by a drag through all the coordinates until the last one, where a touch-up is performed.

Parameters

Name Type Possible values Description

Device ID*

Device

 

The device for this command. By default, this is the device under test (DUT).

Coordinates*

String

 

The touch event coordinates. The coordinate value can be in pixels or in percentage of screen size (0-100), as follows:

  • x1,y1,x2,y2

  • x1%,y1%,x2%,y2%

Consider using the percentage value as it translates to the screen resolution.

Auxiliary operation

String

Tap | No tap | Down | Up

Tap: Touch down at the beginning and touch up at the end
No Tap: No auxiliary operation
Down: Touch down at the beginning
Up: Touch up at the end

Duration

Number

 

The duration, in seconds, for performing the drag operation.

Comment

String

 

Adds a comment to the script

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter