Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Selects one or more options which match the values from a <select> element.
Parameter
Type
Default
Description
selector
string
''
A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
values
string or string[] or object
''
If the select has the multiple attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. Object can be made up of keys with value, label or index.
options
object
null
options.force
boolean
false
Setting this to true will bypass the actionability checks (visible, stable, enabled).
options.noWaitAfter
boolean
false
If set to true and a navigation occurs from performing this action, it will not wait for it to complete.
options.strict
boolean
false
When true, the call requires selector to resolve to a single element. If given selector resolves to more than one element, the call throws an exception.
options.timeout
number
30000
Maximum time in milliseconds. Pass 0 to disable the timeout. Default is overridden by the setDefaultTimeout option on BrowserContext or Page.