Mobile commands - Momentic

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.
`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.

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.

​AI

​Interact

​Device

​App

​Screen checks

​Element checks

​Network

​Scripts

​Files

​Waits

​Control flow

​Debugging

​Common options

AI