Tap On Elements

The Tap On Elements command (Command Type: 5) selects elements by a given CSS selector, calculates their position on screen, and taps on them.

Command Type

Command Type ID: 5

Parameters

Parameter	Type	Description	Required
selector	string	The CSS selector to identify the element(s) to tap	Yes
timeout	number	The timeout for the command in milliseconds	Yes
filters	Filters	Optional filters to refine the elements to tap	No
viewportAreaPercentage	number	Percentage of the viewport area (0–100) used to decide which part of the element to tap	No

Filters Object

Field	Type	Description	Required
className	string	Filter elements by a specific class name	No
includeInnerText	Array of string	Include elements whose inner text contains any of the specified strings	No
excludeInnerText	Array of string	Exclude elements whose inner text contains any of the specified strings	No

Usage Examples

Tap a Button

{
  "command": "tap-on-elements",
  "params": {
    "selector": "button.submit",
    "timeout": 10000
  }
}

Tap with Inner Text Filter

{
  "command": "tap-on-elements",
  "params": {
    "selector": ".list-item",
    "timeout": 10000,
    "filters": {
      "includeInnerText": ["Accept"]
    }
  }
}

Run App - Launch the app before tapping
Mouse Click On Elements - Browser equivalent

Quick Start

Commands Glossary

Command Type

Parameters

Filters Object

Usage Examples

Tap a Button

Tap with Inner Text Filter

​Command Type

​Parameters

​Filters Object

​Usage Examples

​Tap a Button

​Tap with Inner Text Filter

​Related Commands

Command Type

Parameters

Filters Object

Usage Examples

Tap a Button

Tap with Inner Text Filter

Related Commands