SelectElement
Playwright element wrapper for <vaadin-select>. Provides helpers to open the overlay and pick items by visible text, along with aria/placeholder/validation mixins.
Component Tag
vaadin-select
Implements
FocusableElementHasAriaLabelElementHasInputFieldElementHasPrefixElementHasThemeElementHasPlaceholderElementHasEnabledElementHasTooltipElementHasValidationPropertiesElement
Factory Methods
getByLabel
public static SelectElement getByLabel(Page page, String label)
SelectElement by its label. Uses ARIA role BUTTON.
The accessible label of the field
SelectElement
Constructor
SelectElement
public SelectElement(Locator locator)
SelectElement.
The locator for the <vaadin-select> element
Methods
selectItem
public void selectItem(String item)
Label of the item to select
getValue
@Override
public String getValue()
getAriaLabel
@Override
public String getAriaLabel()
null if not set
assertAriaLabel
@Override
public void assertAriaLabel(String ariaLabel)
Expected ARIA label, or null to assert it’s hidden
assertPlaceholder
@Override
public void assertPlaceholder(String placeholder)
Expected placeholder text
assertValue
@Override
public void assertValue(String expected)
Expected label or empty for no selection
@Override
public Locator getInputLocator()
getAriaLabelLocator
@Override
public Locator getAriaLabelLocator()
getFocusLocator
@Override
public Locator getFocusLocator()
getEnabledLocator
@Override
public Locator getEnabledLocator()
getLabelLocator
@Override
public Locator getLabelLocator()
Usage Examples
Basic Selection
SelectElement select = SelectElement.getByLabel(page, "Sort by");
select.assertVisible();
select.assertValue(null);
select.selectItem("Rating: high to low");
select.assertValue("Rating: high to low");
Validation
SelectElement select = SelectElement.getByLabel(page, "Select with theme");
select.assertValue(null);
select.assertValid();
ButtonElement.getByText(page, "Validate").click();
select.assertInvalid();
assertThat(select.getErrorMessageLocator()).hasText("Required field");
Placeholder
SelectElement select = SelectElement.getByLabel(page, "Select with placeholder and clear button");
select.assertVisible();
select.assertPlaceholder("Enter text here");
assertEquals("Enter text here", select.getPlaceholder());
Prefix
SelectElement select = SelectElement.getByLabel(page, "Sort by");
assertThat(select.getPrefixLocator()).isVisible();
assertThat(select.getPrefixLocator()).hasText("Prefix");
select.assertPrefixHasText("Prefix");
assertEquals("Prefix", select.getPrefixText());
Focus and Enabled State
SelectElement select = SelectElement.getByLabel(page, "Sort by");
select.assertIsFocused();
SelectElement disabledSelect = SelectElement.getByLabel(page, "Enabled/Disabled Field");
disabledSelect.assertDisabled();
page.locator("#enable-disable-button").click();
disabledSelect.assertEnabled();
ARIA Label
SelectElement select = SelectElement.getByLabel(page, "Invisible label");
select.assertVisible();
select.assertAriaLabel("Invisible label");
SelectElement select = SelectElement.getByLabel(page, "Sort by");
select.assertVisible();
select.assertTooltipHasText("Tooltip for select");