Skip to main content
Input options for the ‘tap’ mutation (touch-based click).

​
Definition

input TapOptions {
  force: Boolean
  modifiers: [ModifierKey]
  position: PointOptions
  timeout: Int
  trial: Boolean
}

​
Fields

​
force

Boolean Whether to bypass normal actionability checks. Defaults to false.

​
modifiers

[ModifierKey] Array of modifier keys (e.g., SHIFT) to simulate during the tap. Less common for touch.

​
position

PointOptions Specific point, relative to the element’s top-left corner, to tap. Example: { x: 10, y: 20 }

​
timeout

Int Maximum time in milliseconds to wait for the element to be tappable. Defaults to a global timeout.

​
trial

Boolean If true, the tap will not be performed if it would trigger a navigation. Defaults to false.
⌘I