Skip to main content
Requires exactly one of label, value, or index to identify the option to choose.

Parameters

ParameterTypeRequiredDescription
fromstringNoDescription of the <select> element.
cssstringNoCSS selector for the target. Use instead of the description key.
coordsstring | { x, y }NoAbsolute viewport coordinates. Either an x, y string (e.g. 120, 40) or a { x, y } object.
xnumber | stringNoX coordinate. Must be provided together with y.
ynumber | stringNoY coordinate. Must be provided together with x.
forcebooleanNoForce the action even when the element is not actionable.
iframestringNoURL or URL pattern of the iframe that contains the target element.
labelstringNoVisible label of the option to choose.
valuestringNovalue attribute of the option to choose.
indexnumber | stringNoZero-based index of the option to choose.
saveAsstringNoName of the variable to write this step’s return value to.
retriesnumberNoNumber of times to retry the step on failure before failing the test.
skippedbooleanNoSkip this step at execution time.

Examples

- select:
    from: The select element labeled "Dropdown:"
    label: "{{ env.OPTION_LABEL }}"
- select:
    from: The select element "Dropdown:"
    value: "{{ env.OPTION_VALUE }}"
- select:
    from: The "Dropdown:" select element
    index: "{{ env.OPTION_INDEX }}"