select

Select options from dropdown menus by value, label, or index

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

options · SelectOptions · required

Configuration for the select action

Show SelectOptions properties

value · string

The value attribute of the option to select. One of value, label, or index is required.

label · string

The visible text of the option to select. One of value, label, or index is required.

index · number

The zero-based index of the option to select. One of value, label, or index is required.

description · string

Natural language description of the select element. Used for AI-powered element resolution when element or selector are not provided.

element · number

Counter number from snapshot HTML to identify the exact select element.

selector · string

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

ActionResult · Promise<ActionResult>

Show ActionResult properties

method · string

The action method name (“select”)

namespace · string

The namespace identifier for this session

persisted · boolean

Whether the element path was successfully persisted for future use

pathFile · string | null

Path to the file where element path is stored

selectorUsed · string | null

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'
})

Multiple Dropdowns in Form

// 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.

Related methods

• click - Click on custom dropdown elements
• input - Type into searchable dropdowns
• hover - Hover over dropdown elements