Instrument reference

Form instruments

Click, Fill, Select, Upload and Keyboard.

Form instruments interact with page elements. They all take a selector — use Pick selector to point and click instead of writing one — and they all accept the element modifiers (For each, Filter, Target) plus Run if, Repeat and Retry.

Click#

Clicks a button, link, or any element. Options below the selector:

  • Button — left (default), right, or middle click.
  • Click count — set 2 for a double-click.
  • Force — click even if the element isn't strictly "actionable" (useful when an invisible overlay technically covers it).

If several elements match, Click acts on the first — use Target or For each to change that. Typical failures: nothing matched the selector, or the element never became clickable because it's still loading or behind an overlay.

Fill#

Types a value into an input or textarea.

  • Text to type — supports $variables, and a conditional value: click add condition next to the field to switch between two values based on a JS expression.
  • Delay per key (ms) — blank fills instantly; a number simulates real typing, one keystroke at a time. Use it on forms that react to keystrokes — autocomplete, live validation.

Select#

Chooses an option from a <select> dropdown by its value attribute. The value field supports $variables and conditional values. For custom (div-based) dropdowns, Select won't work — use two Clicks: open the dropdown, then click the option.

Upload#

Attaches a file to an <input type="file"> field. Give it the path to a file on your machine. No file-picker dialog opens — the file is set directly on the input.

Keyboard#

Presses a key: Enter, Tab, Escape, ArrowDown… Combinations work too, like Control+A or Shift+Tab. The key goes to whatever currently has focus, so it usually follows a Click or Fill.