press

Presses a physical device button. The simplified form takes the button name as a single string.

Parameters

Parameter	Type	Required	Description
`key`	`enum`	Yes	Button to press (see values below).
`longPress`	`boolean`	No	Hold the button instead of a quick press.
`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.

Button values: home, power, back, app_switcher, search, volume_up, volume_down, volume_mute. back, app_switcher, search, and the volume buttons are Android-only.

Shorthand

Button name as a single string.

- press: home

Examples

- press:
    key: back
    longPress: true # hold the button instead of a quick press

Test format
pressKey

Overview

AI

Interactions

Device

Apps

Screen checks

Element checks

Visual

Network

Scripts

Files

Waits

Control flow

Debugging

Parameters

Shorthand

Examples

​Parameters

​Shorthand

​Examples

​Related

Parameters

Shorthand

Examples

Related