Application.Element.MultiTap command

Uses an element identifier (XPath or specific attribute) to search for the element in the display of the active window and then sends one or more taps with one or more touch points on the element. Used in conjunction with either the Perfecto or Appium framework to interpret the element classes.

Limitations

This command is supported only on iOS devices only.

Parameters

Name Type Possible values Description

Device ID*

Device

 

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

Element identifier*

String

 

The object identifier. By default, an Xpath is generated by the object spy.

By

String

XPath | Class | Text | Partial text | Name | Id | Accessibility id | UIAutomator Selector | UIAutomation Selector | Class Chain

The identification method.

Number of taps

Number

  

The number of taps.

Number of touches

Number

  

The number of touch points (number of fingers).

Comment

String

  

Adds a comment to the script

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory

Examples

The following examples illustrate common ways to use the Application.Element.MultiTap command by combining the Number of taps and Number of touches parameters.

Example 1: Double‑tap on an element

Use this configuration when the application responds to a double‑tap gesture on a UI element, such as zooming in on an image.

  • Number of taps: 2

  • Number of touches: 1

This sends two consecutive taps using a single touch point (one finger) on the specified element.

Example 2: Two‑finger tap (multi‑touch gesture)

Use this configuration to simulate a gesture that requires two fingers tapping the element at the same time.

  • Number of taps: 1

  • Number of touches: 2

This sends a single tap using two simultaneous touch points (two fingers) on the element.

Example 3: Repeated tapping on an element

Use this configuration when an application requires multiple taps on the same element, for example to trigger a hidden or advanced action.

  • Number of taps: 5 (or higher, as required)

  • Number of touches: 1

This sends multiple consecutive taps using a single touch point on the element.