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.