Working with Single-Select Dropdowns

Master single-select dropdowns using selectByVisibleText, selectByValue, and selectByIndex

Concept

Single-select dropdowns allow choosing only one option at a time. Selecting a new option automatically deselects the previous one.

selectByVisibleText()

Selects an option by its visible label.

select.selectByVisibleText(
"Four"
);

When to use

Use when the label text is stable and meaningful to your test (most readable option).

selectByValue()

Selects an option by its value attribute.

select.selectByValue(
"four"
);

When to use

Use when backend logic depends on value attributes or when visible text changes frequently.

selectByIndex()

Selects an option by its 0-based index position.

select.selectByIndex(
2
);

Use sparingly

Use only when position is stable. If options change order, tests may break.

Best Practice Notes

✓Use selectByVisibleText(...) when the label text is stable
✓Use selectByValue(...) when backend relies on specific value attributes
⚠Avoid selectByIndex(...) unless option order is guaranteed stable
✗Avoid selecting disabled options; Selenium will throw an exception

Interactive Practice

Imagine a page called "Select List Playground" with a Number Selector:

Number Selector (single-select)

Pick a number

Currently selected number: One

Options Details:

Index 0: "One" — value="one"
Index 1: "Two" — value="two"
Index 2: "Four" — value="four"
Index 3: "Still learning how to count, apparently" — value="still learning how to count, apparently"

Try selecting different options to see the selection change!

Manual interaction (what the student would do)

Open the dropdown
Select "Four"
Confirm the label shows "Currently selected number: Four"
Notice that selecting "Four" automatically deselected the previous option

Your Selenium code will automate this using the Select class with three different selection methods.

Java Code Example

SingleSelectExample.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
WebElement numberSelectElement = driver.findElement(By.name("selectomatic"));
Select numberSelect = new Select(numberSelectElement);

// Method 1: Select by visible text (most readable)
numberSelect.selectByVisibleText("Four");

// Method 2: Select by value attribute (useful for backend validation)
numberSelect.selectByValue("four");

// Method 3: Select by index (use when position is stable)
numberSelect.selectByIndex(2);  // Index 2 = "Four"

// Verify the selection
WebElement selectedOption = numberSelect.getFirstSelectedOption();
System.out.println("Selected: " + selectedOption.getText());
// Output: "Selected: Four"

driver.quit();

Code Breakdown

driver.findElement(By.name("selectomatic")): Locates the Number Selector <select> element using its name="selectomatic".
Select numberSelect = new Select(numberSelectElement);: Wraps the number <select> in a Select object, enabling helper methods for selecting options.
numberSelect.selectByVisibleText("Four");: Chooses the option whose visible text is "Four". This is the most readable selection method and works well when the label is stable.
numberSelect.selectByValue("four");: Selects the option with value="four". Useful when your tests need to mirror backend logic that depends on value attributes.
numberSelect.selectByIndex(2);: Selects the option at index 2 (0-based), which is "Four" in this list. Use sparingly—only when option order is guaranteed not to change.
numberSelect.getFirstSelectedOption();: Returns the currently selected option as a WebElement. Use getText() to verify the selection.
driver.quit();: Closes the browser and ends the WebDriver session.

Pro Tip

Prefer selectByVisibleText

Prefer selectByVisibleText(...) for readability. Tests that select "United States" are more maintainable than selecting "us" or index 2.

Always Verify Selection

After selecting, use getFirstSelectedOption() to verify the correct option was selected. This catches selection failures immediately.

Watch for NoSuchElementException

If you get NoSuchElementException, the visible text or value doesn't match exactly. Check for extra spaces, case sensitivity, or special characters.

Concept

Single-select dropdowns allow choosing only one option at a time. Selecting a new option automatically deselects the previous one.

selectByVisibleText()

Selects an option by its visible label.

select.selectByVisibleText(
"Four"
);

When to use

Use when the label text is stable and meaningful to your test (most readable option).

selectByValue()

Selects an option by its value attribute.

select.selectByValue(
"four"
);

When to use

Use when backend logic depends on value attributes or when visible text changes frequently.

selectByIndex()

Selects an option by its 0-based index position.

select.selectByIndex(
2
);

Use sparingly

Use only when position is stable. If options change order, tests may break.

Best Practice Notes

✓Use selectByVisibleText(...) when the label text is stable
✓Use selectByValue(...) when backend relies on specific value attributes
⚠Avoid selectByIndex(...) unless option order is guaranteed stable
✗Avoid selecting disabled options; Selenium will throw an exception

Interactive Practice

Imagine a page called "Select List Playground" with a Number Selector:

Number Selector (single-select)

Pick a number

Currently selected number: One

Options Details:

Index 0: "One" — value="one"
Index 1: "Two" — value="two"
Index 2: "Four" — value="four"
Index 3: "Still learning how to count, apparently" — value="still learning how to count, apparently"

Try selecting different options to see the selection change!

Manual interaction (what the student would do)

Open the dropdown
Select "Four"
Confirm the label shows "Currently selected number: Four"
Notice that selecting "Four" automatically deselected the previous option

Your Selenium code will automate this using the Select class with three different selection methods.

Java Code Example

SingleSelectExample.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
WebElement numberSelectElement = driver.findElement(By.name("selectomatic"));
Select numberSelect = new Select(numberSelectElement);

// Method 1: Select by visible text (most readable)
numberSelect.selectByVisibleText("Four");

// Method 2: Select by value attribute (useful for backend validation)
numberSelect.selectByValue("four");

// Method 3: Select by index (use when position is stable)
numberSelect.selectByIndex(2);  // Index 2 = "Four"

// Verify the selection
WebElement selectedOption = numberSelect.getFirstSelectedOption();
System.out.println("Selected: " + selectedOption.getText());
// Output: "Selected: Four"

driver.quit();

Code Breakdown

driver.findElement(By.name("selectomatic")): Locates the Number Selector <select> element using its name="selectomatic".
Select numberSelect = new Select(numberSelectElement);: Wraps the number <select> in a Select object, enabling helper methods for selecting options.
numberSelect.selectByVisibleText("Four");: Chooses the option whose visible text is "Four". This is the most readable selection method and works well when the label is stable.
numberSelect.selectByValue("four");: Selects the option with value="four". Useful when your tests need to mirror backend logic that depends on value attributes.
numberSelect.selectByIndex(2);: Selects the option at index 2 (0-based), which is "Four" in this list. Use sparingly—only when option order is guaranteed not to change.
numberSelect.getFirstSelectedOption();: Returns the currently selected option as a WebElement. Use getText() to verify the selection.
driver.quit();: Closes the browser and ends the WebDriver session.

Pro Tip

Prefer selectByVisibleText

Prefer selectByVisibleText(...) for readability. Tests that select "United States" are more maintainable than selecting "us" or index 2.

Always Verify Selection

After selecting, use getFirstSelectedOption() to verify the correct option was selected. This catches selection failures immediately.

Watch for NoSuchElementException

If you get NoSuchElementException, the visible text or value doesn't match exactly. Check for extra spaces, case sensitivity, or special characters.