Package com.vaadin.browserless.locator

Interface Locators

All Superinterfaces:

GeneratedLocators

All Known Subinterfaces:

CommercialLocators

All Known Implementing Classes:

BrowserlessUIContext

public interface Locators
extends GeneratedLocators

Mixin offering typed entry points for the find* tester API.

Most entry points come from GeneratedLocators, which is emitted by the locator annotation processor at build time. This interface adds the generic find(Supplier) for user-defined locators and the activateLocatorContext() hook that context-bound implementations (e.g. BrowserlessUIContext) override.

Method Summary

Modifier and Type	Method	Description
default void	activateLocatorContext()	Hook for context-bound implementations to install Vaadin thread-locals before a locator is built.
default <L extends Locator<?, L>> L	find(Supplier<L> factory)	Generic entry point for user-defined locators.

Methods inherited from interface com.vaadin.browserless.locator.GeneratedLocators

findAccordion, findAnchor, findBigDecimalField, findButton, findCheckbox, findCheckboxGroup, findComboBox, findConfirmDialog, findContextMenu, findDatePicker, findDateTimePicker, findDecimalRangeSlider, findDecimalSlider, findDescriptionList, findDetails, findDialog, findDiv, findEmailField, findEmphasis, findGrid, findH1, findH2, findH3, findH4, findH5, findH6, findHr, findImage, findInput, findIntegerField, findIntegerRangeSlider, findIntegerSlider, findListBox, findListItem, findLoginForm, findLoginOverlay, findMenuBar, findMessageInput, findMessageList, findMultiSelectComboBox, findMultiSelectListBox, findNativeButton, findNativeDetails, findNativeLabel, findNotification, findNumberField, findOrderedList, findParagraph, findPasswordField, findPopover, findPre, findRadioButton, findRadioButtonGroup, findRangeInput, findRouterLink, findSelect, findSideNav, findSpan, findTabs, findTabSheet, findTextArea, findTextField, findTimePicker, findUnorderedList, findUpload, findVirtualList, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use, use

Method Details

activateLocatorContext

default void activateLocatorContext()

Hook for context-bound implementations to install Vaadin thread-locals before a locator is built. Default is a no-op.

Specified by:

activateLocatorContext in interface GeneratedLocators

find

default <L extends Locator<?,
L>> L find(Supplier<L> factory)

Generic entry point for user-defined locators. Activates the locator context (so thread-locals and the security snapshot are restored on a window switch) and invokes the supplied factory.

 window.find(CheckoutFormLocator::new).withId("checkout").submit();
 

Throws:

IllegalStateException - if the factory returns null instead of a fresh locator instance.