Class ComboBoxTester<T extends ComboBox<Y>,Y>
java.lang.Object
com.vaadin.testbench.unit.ComponentTester<T>
com.vaadin.flow.component.combobox.ComboBoxTester<T,Y>
- All Implemented Interfaces:
Clickable<T>
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionGet the currently selected item.Get the actual items for the dropdown as a List.Get dropdown suggestions as String representations sent to the client.voidselectItem(String selection) Selects an item by its string representation (label).voidSimulate writing a filter to the combobox.Methods inherited from class com.vaadin.testbench.unit.ComponentTester
ensureComponentIsUsable, ensureComponentIsUsable, ensureVisible, ensureVisible, find, findAllByQuery, findByQuery, fireDomEvent, fireDomEvent, fireDomEvent, getComponent, getField, getField, getMethod, getMethod, isUsable, isUsable, notUsableReasons, notUsableReasons, roundTrip, setModal, setValueAsUserMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface com.vaadin.testbench.unit.Clickable
click, click, click, middleClick, middleClick, rightClick, rightClick
-
Constructor Details
-
ComboBoxTester
Wrap given component for testing.- Parameters:
component- target component
-
-
Method Details
-
setFilter
Simulate writing a filter to the combobox. UsegetSuggestions()to get the string values show in the dropdown orgetSuggestionItems()to get the actual items in the suggestion.- Parameters:
filter- string to use for filtering
-
selectItem
Selects an item by its string representation (label).This method searches for the item among the current suggestions, which are affected by any filter set via
setFilter(String). If no filter is set, all items are available for selection. If a filter is set, only the filtered items can be selected.To select an item when the ComboBox uses custom filtering logic (e.g., set via
setItems(ItemFilter, Collection)), first callsetFilter(String)to apply the filter, then call this method to select from the filtered results.Example usage with filtering:
// Apply filter first comboBoxTester.setFilter("search text"); // Then select from filtered items comboBoxTester.selectItem("Matching Item Label");- Parameters:
selection- the item's string representation (label) to select, ornullto clear the selection- Throws:
IllegalArgumentException- if no item with the given label is found among current suggestions- See Also:
-
getSelected
Get the currently selected item.- Returns:
- current selection
-
getSuggestions
Get dropdown suggestions as String representations sent to the client. Any filter that is set is taken into account.- Returns:
- List of item representation strings
-
getSuggestionItems
Get the actual items for the dropdown as a List. Any filter that is set is taken into account.- Returns:
- List of items
-