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.