Drag (FR)

Perfecto Command

mobile:touch:drag

Purpose

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
location (Mandatory)	String		The touch event coordinates. Format - either "x1,y1,x2,y2" or "x1%,y1%,x2%,y2%" Coordinate value can be in pixels or in percentage of screen size (0-100). For percentage use the % sign. Example - "20%, 25%" It is recommended to use the percentage value as it translates to the screen resolution.
duration	Int	1-30	The duration, in seconds, for performing the drag operation.
auxiliary	String	tap \| notap \| 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

Name

Type

Possible Values

Description

location (Mandatory)

String

The touch event coordinates.

Format - either "x1,y1,x2,y2" or "x1%,y1%,x2%,y2%"

Coordinate value can be in pixels or in percentage of screen size (0-100).

For percentage use the % sign. Example - "20%, 25%"

It is recommended to use the percentage value as it translates to the screen resolution.

duration

Int

1-30

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

auxiliary

String

tap | notap | 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

Return Value

None

Exceptions

None

Examples

Copy

Java sample

Map<String, Object> params = new HashMap<>();
params.put("location", "20%,27%,20%,65%");
params.put("duration", "5");
Object res = driver.executeScript("mobile:touch:drag", params);

Copy

C# sample

Dictionary<String, Object> pars = new Dictionary<String, Object>();
pars.Add("location", "20%,27%,20%,65%");
pars.Add("duration", "5");
Object res = driver.ExecuteScript("mobile:touch:drag", pars);