tap

Taps a target. The simplified form takes a single string. Provide a natural-language description or a percent pair like "50%, 50%".

Parameters

Parameter	Type	Required	Description
`on`	`string`	No	Target description or percent pair.
`longPress`	`boolean`	No	Hold the tap instead of a quick press.
`longPressDuration`	`number`	No	Hold duration in milliseconds when `longPress` is set.
`iterations`	`number`	No	Number of taps to issue.
`tapDelay`	`number`	No	Milliseconds between taps when `iterations` > 1.
`offset`	`string \| { x, y }`	No	Pixel offset from the resolved target (`"x, y"` or `{ x, y }`).
`saveAs`	`string`	No	Variable to store this step’s return value on `env.<name>`.
`retries`	`number`	No	Times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Target as a single string.

- tap: the Add to cart button

- tap: "50%, 50%" # tap the center of the screen

- tap:
    on: the kebab menu in the top-right
    longPress: true
    longPressDuration: 1500 # hold for 1.5s