fill_form
Fill form fields in a Chrome tab using field labels or names, with optional submit and intent labeling for audit logs.
Instructions
Fill form fields and optionally submit. Pass intent="..." (≤120 chars) to label this action in audit logs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| refs | No | Optional ref→value map (#831). Refs come from a recent read_page(mode="ax") snapshot. When present, refs are processed before `fields` and skip AX/CSS discovery. Stale refs produce a STALE_REF error — no silent coordinate fallback. | |
| tabId | Yes | Tab ID to execute on | |
| fields | No | Field label/name/placeholder to value map. Checkboxes: "true"/"false" | |
| intent | No | Human-readable label for this action in audit logs (≤120 chars) | |
| submit | No | Submit button query after fill | |
| verify | No | Verify mode. boolean is legacy: true→"screenshot", false→"none". String enum returns a compact diff signal (AX-hash delta + pHash, ≤4KB). | |
| waitForMs | No | Poll timeout for dynamic fields in ms. Default: 0 | |
| loginCheck | No | After submit, run a generic login-failure detector that flips success → failure when the password form is still mounted. Default: "auto". Set "off" to restore pre-#658 behavior. | |
| clear_first | No | Clear before fill. Default: true | |
| pollInterval | No | Poll interval in ms (50-2000). Default: 300 | |
| capture_artifact | No | When true, stage replay artifact steps for oc_skill_record after successfully filled fields. Default false is a strict no-op. | |
| returnAfterState | No | Optional chaining hint. When "ax" or "dom", the response includes a page snapshot of that mode captured after the post-action wait, removing the need for a follow-up read_page call. Default: "none". |