Reference
device_press
Tap a UI element by its @ref from device_snapshot. Supports double-tap, repeated taps, long hold, and post-tap focus settle. Requires an open session. Stale @refs self-heal by identity re-resolution (meta.reResolved); swallowed taps auto-retry once (meta.tapRetried/noUiChange).
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
ref | string | Yes | Element ref from device_snapshot (e.g. “e3” or “@e3”) | ||
doubleTap | boolean | No | Use double-tap gesture | ||
count | unknown | No | min: 1, max: 50, integer | Repeat tap N times (for rapid-fire interactions) | |
holdMs | unknown | No | min: 0, max: 10000, integer | Hold duration in ms (for long-press via ref) | |
waitForFocusMs | unknown | No | min: 0, max: 5000, integer | ||
settleTimeoutMs | unknown | No | min: 500, max: 30000, integer | ||
retryIfNoChange | unknown | No |
device_press(ref: <string>)