Documentation Index Fetch the complete documentation index at: https://mintlify.com/steerlabs/opensteer/llms.txt
Use this file to discover all available pages before exploring further.
Method Signature
await opensteer . select ( options : SelectOptions ): Promise < ActionResult >
Selects an option from a <select> dropdown element. You must specify one of: value, label, or index.
Parameters
Configuration for the select action Show SelectOptions properties
The value attribute of the option to select. One of value, label, or index is required.
The visible text of the option to select. One of value, label, or index is required.
The zero-based index of the option to select. One of value, label, or index is required.
Natural language description of the select element. Used for AI-powered element resolution when element or selector are not provided.
Counter number from snapshot HTML to identify the exact select element.
CSS selector to identify the select element.
wait
false | ActionWaitOptions
Post-action wait configuration. Set to false to disable waiting, or provide options to customize wait behavior.
Returns
Show ActionResult properties
The action method name (“select”)
The namespace identifier for this session
Whether the element path was successfully persisted for future use
Path to the file where element path is stored
The actual selector used to find the element
Examples
Select by Label
// Select option by visible text
await opensteer . select ({
description: 'Country dropdown' ,
label: 'United States'
})
Select by Value
// Select option by value attribute
await opensteer . select ({
description: 'Language selector' ,
value: 'en-US'
})
Select by Index
// Select the third option (zero-based index)
await opensteer . select ({
description: 'Priority dropdown' ,
index: 2
})
Select with Selector
// Use CSS selector to identify dropdown
await opensteer . select ({
selector: '#country-select' ,
label: 'Canada' ,
description: 'Country dropdown'
})
Select with Element Counter
// Use element counter from snapshot
await opensteer . select ({
element: 18 ,
description: 'State dropdown' ,
value: 'CA'
})
// Fill out a form with multiple select elements
await opensteer . select ({
description: 'Country' ,
label: 'United States'
})
await opensteer . select ({
description: 'State' ,
label: 'California'
})
await opensteer . select ({
description: 'City' ,
value: 'san-francisco'
})
Select First Option
// Select the first option in a dropdown
await opensteer . select ({
description: 'Sort by dropdown' ,
index: 0
})
Important Notes
You must provide exactly one of value, label, or index. The action will fail if none are specified.
This method only works with native <select> elements. For custom dropdown components (like those built with <div> and <ul>), use click and input actions instead.
click - Click on custom dropdown elements
input - Type into searchable dropdowns
hover - Hover over dropdown elements