select_option
Select an option from a native select or custom dropdown using a CSS selector, value, label, or index. Enumerate available options by omitting selection criteria.
Instructions
Select an option from a native or custom ARIA/portal dropdown. Identify the target control via CSS selector or @eN ref, then specify which option to select by its value attribute, visible label text, or zero-based index. Omit value, label, and index to open the dropdown, enumerate the currently available options, and return them without selecting. Returns post-action page_state showing any page changes triggered by the selection (e.g. dependent dropdowns updating).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| index | No | Zero-based index of the <option> to select (0 = first option). Use when value/label are unknown. | |
| label | No | The visible text of the option to select (e.g. "United States", "Medium"). Use when you know the display text. | |
| value | No | The value attribute of the option to select (e.g. "us", "medium"). For custom dropdowns without exposed values, this is matched against visible option text. | |
| widen | No | When true, return the full-page diff instead of scoping to the interacted container. Default: false. | |
| selector | Yes | CSS selector or @eN ref targeting the native select or custom dropdown trigger (e.g. "@e4", "select#country", "button[role='combobox']"). |