Mobile commands

Mobile tests use a mobile-specific command set. Targets are natural-language descriptions or percent pairs ("50%, 50%"). There are no CSS selectors or absolute pixel targets. See Test format for file shapes, targets, scroll containers, and conditionals.

AI

Command	Summary
`act`	Hand a natural-language goal to the AI agent, which taps and swipes to satisfy it.
`assert`	Run an AI assertion about the current screen. Fails the test by default.
`assertVisually`	Run an AI assertion about the screen using a screenshot only.
`extract`	Pull a value off the screen with the AI agent and save it to `env`.

Interact

Command	Summary
`tap`	Tap an element by description or percent-pair coordinates.
`type`	Type text into a field, optionally clearing and submitting.
`swipe`	Swipe the screen or a container in a direction.
`scrollTo`	Scroll a container until the target is visible.
`dragAndDrop`	Drag from one target and drop onto another.

Device

Command	Summary
`press`	Press a physical device button (home, back, volume).
`pressKey`	Press a software keyboard key (enter, delete).
`rotate`	Rotate the device to portrait or landscape.
`toggleSettings`	Toggle an Android system setting such as airplane mode or Wi-Fi.
`openNotifications`	Open the Android notification drawer.

App

Command	Summary
`openApp`	Launch an app by package name or bundle identifier.
`killApp`	Force-stop the app under test.
`installApp`	Install an app from a file path.
`uninstallApp`	Uninstall an app by package name.

Screen checks

Command	Summary
`checkScreenContains`	Assert that text appears somewhere on the screen.
`checkScreenDoesNotContain`	Assert that text does not appear on the screen.

Element checks

Command	Summary
`checkElement`	Assert a condition on the element itself (exists, visible, enabled).
`checkElementAttribute`	Assert a condition on an attribute of the element.
`checkElementContent`	Assert a condition on the element’s text content.
`checkElementName`	Assert a condition on the element’s type/class name.
`checkElementStyle`	Assert a condition on a computed style property.

Visual

Command	Summary
`visualDiff`	Compare a full-screen screenshot against a local golden image.

Network

Command	Summary
`request`	Issue an HTTP request and optionally save the response.

Scripts

Command	Summary
`javascript`	Run a JavaScript snippet and optionally store its return value.
`adb`	Run an `adb` command against the connected Android device.
`appium`	Execute an Appium script against the device.

Files

Command	Summary
`addFile`	Push a file from the host onto the device.

Waits

Command	Summary
`wait`	Sleep for a fixed number of milliseconds.

Control flow

Command	Summary
`if`	Run a block of steps only when a condition holds.
`module`	Invoke a reusable module of steps.

Debugging

Command	Summary
`debugState`	Capture the current device state for debugging.

openNotifications, installApp, uninstallApp, toggleSettings, and adb are Android-only.

Common options

Every step accepts these shared keys:

Option	Type	Description
`saveAs`	`string`	Variable to store this step’s return value on `env.<name>`.
`retries`	`number`	Times to retry the step on failure before failing the test.
`skipped`	`boolean`	Skip this step at execution time.

Overview

AI

Interactions

Device

Apps

Screen checks

Element checks

Visual

Network

Scripts

Files

Waits

Control flow

Debugging

AI

Interact

Device

App

Screen checks

Element checks

Visual

Network

Scripts

Files

Waits

Control flow

Debugging

Common options

​AI

​Interact

​Device

​App

​Screen checks

​Element checks

​Visual

​Network

​Scripts

​Files

​Waits

​Control flow

​Debugging

​Common options

AI

Interact

Device

App

Screen checks

Element checks

Visual

Network

Scripts

Files

Waits

Control flow

Debugging

Common options