Skip to main content

batch

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Run several tools in order, on one device, in one call — a known sequence such as tap, type, tap, without a round trip for each. These call app_batch.

batch​

batch(steps: BatchStep[]): Promise<BatchStepResult[]>

Runs several tools in order in one call; stops at the first failure.

Examples​

Tap through two screens in one call​

const steps = await device.batch([
  { name: 'app_tap', arguments: { target: 'text=Network & internet' } },
  { name: 'app_wait_for', arguments: { target: 'text=Internet' } },
])
for (const step of steps) console.log(step.name, step.text)

The same call from the command line, mobium batch steps.json, printed on an Android 15 emulator:

1. app_tap: tapped text=Network & internet at (407, 867)
2. app_wait_for: text=Internet is visible after 1.222s — @e3 Internet AndroidWifi (button)

mobium batch steps.json on an Android 15 emulator

mobium batch steps.json on an Android 15 emulator