scout_type
Enter text into a field by element ref, appending to existing content or replacing it with replace=true. Handles boundary values and can press Enter after typing.
Instructions
Type into a text input/textarea/composer by ref, the way a real user does: if the field already holds content (e.g. an @-mention chip a menu click inserted), the text is APPENDED at the end — preserving that content — and the result reports what was already there (a separating space is added only at a word-to-word boundary). Pass replace=true to clear the field first (correcting a previous entry); an empty textValue always clears. Appending fires input events but not keydown, so keydown-driven triggers (slash/mention menus) will not react to appended text. Use for both valid values and boundary/fuzz values (empty, very long, unicode, script tags).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | Element ref, e.g. e12 | |
| value | No | Alias for `textValue`. | |
| replace | No | Clear the field before typing instead of appending to existing content | |
| session | No | Target this session directly instead of the active one — pass it explicitly when dispatching to MULTIPLE sessions in one turn (e.g. two scout_click calls with different `session`), which then run CONCURRENTLY rather than queueing. Omit for single-session sequential use. | |
| textValue | No | Text to type | |
| pressEnter | No | Press Enter after typing |