Skip to content

Reference

device_fill

Type text into an input field by its @ref from device_snapshot. Always re-taps the element first so keyboard focus is on the correct field even in sequential fills. On “no focused text input” errors, automatically falls back: Pressable→TextInput resolution (common RN design-system pattern where outer Pressable wraps inner TextInput) → coordinate re-tap + retry → Android adb input / iOS Maestro inputText. Check meta.fallbackUsed in the result to see which strategy succeeded. Requires an open session.

NameTypeRequiredDefaultConstraintsDescription
refstringYesInput field ref from device_snapshot (e.g. “e5” or “@e5”)
textstringYesText to type into the field
waitForKeyboardMsunknownNomin: 0, max: 5000, integer
testIDunknownNo
settleTimeoutMsunknownNomin: 500, max: 30000, integer
device_fill(ref: <string>, text: <string>)