Fill Field
fillFill input, textarea, or contenteditable elements with a specified value. Use CSS selector or matching visible text; native setter fires input/change events for React, and errors on non-fillable targets.
Instructions
Set the value of an input, textarea or contenteditable. Uses the native setter and fires input and change, so React and similar frameworks register it. Fails with an error naming the tag when the target cannot be filled: a heading or other non-input, a disabled or readonly field, or a (use select_option for those). "text=Label" matches on visible text as a substring, with exact matches ranked first, so a short label also matches longer ones. Check the returned "matches" count, and pass exact when it is above 1.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nth | No | Which match to fill, 0-based | |
| exact | No | For "text=" selectors, require the whole trimmed text to equal the label instead of containing it. No effect on CSS selectors. | |
| value | Yes | Value to set | |
| submit | No | Press Enter and request form submit afterwards. The tab usually navigates, so follow with wait_for_load: the returned tab snapshot may predate the navigation, and urlBefore reports the url from just before the key press. | |
| tab_id | No | Arc tab id from list_tabs. Omit to use this agent's current tab, falling back to whatever tab is active in Arc. | |
| verbose | No | Include the bulky element rect and longer attribute values | |
| selector | Yes | CSS selector, or "text=Some label" to match on visible text (substring, exact matches ranked first) |