sootsim do
sootsim do
Grouping verb for user-interaction actions. sootsim do <action> covers the write side of the bridge: taps, typing, key presses, touch/scroll/drag/swipe/pinch gestures, reload, and local timing helpers.
terminal
Examples
terminal
Subcommands
Run sootsim do <verb> --help for the flags and examples of any subcommand.
targeting
| subcommand | description |
|---|---|
tap <x> <y> | tap absolute coords, or a node by —testid / —text |
double-tap <x> <y> [gapMs] | tap the same coordinates twice quickly |
tap-text <text> [--nth <n>] [--within <testID>] | findByText then tap (rich disambiguation flags) |
tap-id <id> | findByTestId then tap center |
tap-best <query> | testID-first, text-fallback robust tap |
native device
| subcommand | description |
|---|---|
scan <text> [--format <web-format>] | inject a barcode scan into active camera scanning |
text input
| subcommand | description |
|---|---|
type <text> | type through the iOS visual keyboard |
type-into <id> <text> | focus input by testID then type |
key <name> | special key (return, delete, space, shift, …) |
key-sequence <key> [<key> ...] | press multiple visual keyboard keys |
keycode <code> [<code> ...] | press DOM-style key codes via visual keyboard |
dismiss | dismiss the iOS keyboard |
dispatch <char> | raw key (bypasses visual shift state) |
gestures
| subcommand | description |
|---|---|
scroll <id> <x> <y> | scroll a ScrollView by testID or inspect node id |
drag <x1> <y1> <x2> <y2> [steps] [stepMs] | drag via real PointerEvents |
swipe <x1> <y1> <x2> <y2> [steps] [stepMs] | drag with faster defaults |
long-press <x> <y> [durationMs] | hold a press at coordinates |
touch <down|move|up|cancel> <x> <y> [pointerId] | low-level touch primitives |
gesture <preset> [durationMs] | preset gestures (scroll / edge swipes) |
pinch <x1> <y1> <x2> <y2> <x1'> <y1'> <x2'> <y2'> [steps] [stepMs] | two-pointer pinch helper |
animations
| subcommand | description |
|---|---|
stop-animation <id|all> | stop a running animation |
lifecycle
| subcommand | description |
|---|---|
reload | reload the page + wait for reconnect |
wait [seconds] | wait for sim reconnect |
settle [seconds] [--strict] | wait for animations to settle |
sleep [seconds] | local pause between commands |