select_by_text

The command to select an <option> by its text within a <select> dropdown element.

Syntax

Element.select_by_text(text: str) -> Element

Usage

correct usage

py.get("#dropdown").select_by_text("Option 1")

---or--- # chain an Element command

py.get("#dropdown").select_by_text("Option 2").get_attribute("value")

incorrect usage

# Errors, can only perform this command on a <select> dropdown element
py.get("ul > li").select_by_text("Option 3")

Arguments

• text (str) - The text of the option to select.

Yields

• Element - The current instance of Element so you can chain commands.

Examples

Given this HTML

<select id="dropdown">
    <option value="" disabled="disabled" selected="selected">Please select an option</option>
    <option value="1">Option 1</option>
    <option value="2">Option 2</option>
</select>

We can select any of the options

dropdown = py.get("dropdown")

# Select the first option that is "disabled"
dropdown.select_by_text("Please select an option")

# Select Option 1
dropdown.select_by_text("Option 1")

# Select Option 2
dropdown.select_by_text("Option 2")

Give this a try yourself! https://the-internet.herokuapp.com/dropdown

See also

• select_by_index

• select_by_value

• click() - If the dropdown is NOT a <select> element, .click() will work