select_by_value

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

Syntax

Element.select_by_value(value: Any) -> Element

Usage

correct usage

py.get("#dropdown").select_by_value(2)

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

py.get("#dropdown").select_by_value("1").get_attribute("value")

incorrect usage

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

Arguments

• value (Any) - The value of the option to select. Usually a str, but can be other types.

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_value("")

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

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

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

See also

• select_by_index

• select_by_text

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