aquality.selenium.core.elements.interfaces

Interface IElementFinder

All Superinterfaces:

org.openqa.selenium.SearchContext

All Known Implementing Classes:

ElementFinder, RelativeElementFinder

public interface IElementFinder
extends org.openqa.selenium.SearchContext

Provides ability to find elements by locator and search criteria. The criteria for search could be: - empty - to get all elements; - desired ElementState; - with DesiredState; - with Predicate.

Method Summary

Modifier and Type	Method and Description
default org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By locator) Finds element in any state with default timeout.
default org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By locator, Duration timeout) Finds element in any state.
default org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By locator, ElementState state) Finds element in desired ElementState with default timeout.
default org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By locator, ElementState state, Duration timeout) Finds element in desired ElementState
default org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By locator, Predicate<org.openqa.selenium.WebElement> elementStateCondition) Finds element in desired ElementState defined by predicate with default timeout.
default org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By locator, Predicate<org.openqa.selenium.WebElement> elementStateCondition, Duration timeout) Finds element in desired element's state defined by predicate.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator) Finds elements in any state with default timeout.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, DesiredState desiredState) Finds elements in state defined by DesiredState with default timeout.
List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, DesiredState desiredState, Duration timeout) Finds elements in state defined by DesiredState.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, Duration timeout) Finds elements in any state.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, ElementState state) Finds elements in desired ElementState with default timeout.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, ElementState state, Duration timeout) Finds elements in desired ElementState.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, Predicate<org.openqa.selenium.WebElement> elementStateCondition) Finds elements in state defined by predicate with default timeout.
default List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By locator, Predicate<org.openqa.selenium.WebElement> elementStateCondition, Duration timeout) Finds elements in state defined by predicate.
default DesiredState	resolveState(ElementState state) Provides DesiredState with predicate for desired ElementState.

Method Detail

resolveState

default DesiredState resolveState(ElementState state)

Provides DesiredState with predicate for desired ElementState.

Parameters:

state - desired ElementState

Returns:

DesiredState with predicate.

findElement

default org.openqa.selenium.WebElement findElement(org.openqa.selenium.By locator,
                                                   ElementState state,
                                                   Duration timeout)

Finds element in desired ElementState

Parameters:

locator - elements locator

state - desired ElementState

timeout - timeout for search

Returns:

found element

Throws:

org.openqa.selenium.NoSuchElementException - if element was not found in time in desired state

findElement

default org.openqa.selenium.WebElement findElement(org.openqa.selenium.By locator,
                                                   ElementState state)

Finds element in desired ElementState with default timeout.

Parameters:

locator - elements locator

state - desired ElementState

Returns:

found element

Throws:

org.openqa.selenium.NoSuchElementException - if element was not found in time in desired state

findElement

default org.openqa.selenium.WebElement findElement(org.openqa.selenium.By locator,
                                                   Duration timeout)

Finds element in any state.

Parameters:

locator - elements locator

timeout - timeout for search

Returns:

found element

Throws:

org.openqa.selenium.NoSuchElementException - if element was not found in time

findElement

default org.openqa.selenium.WebElement findElement(org.openqa.selenium.By locator)

Finds element in any state with default timeout.

Specified by:

findElement in interface org.openqa.selenium.SearchContext

Parameters:

locator - elements locator

Returns:

found element

Throws:

org.openqa.selenium.NoSuchElementException - if element was not found in time

findElement

default org.openqa.selenium.WebElement findElement(org.openqa.selenium.By locator,
                                                   Predicate<org.openqa.selenium.WebElement> elementStateCondition,
                                                   Duration timeout)

Finds element in desired element's state defined by predicate.

Parameters:

locator - elements locator

elementStateCondition - predicate to define element state

timeout - timeout for search

Returns:

found element

Throws:

org.openqa.selenium.NoSuchElementException - if element was not found in time in desired state

findElement

default org.openqa.selenium.WebElement findElement(org.openqa.selenium.By locator,
                                                   Predicate<org.openqa.selenium.WebElement> elementStateCondition)

Finds element in desired ElementState defined by predicate with default timeout.

Parameters:

locator - elements locator

elementStateCondition - predicate to define element state

Returns:

found element

Throws:

org.openqa.selenium.NoSuchElementException - if element was not found in time in desired state

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                          ElementState state,
                                                          Duration timeout)

Finds elements in desired ElementState.

Parameters:

locator - elements locator

state - desired ElementState

timeout - timeout for search

Returns:

list of found elements

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                          Duration timeout)

Finds elements in any state.

Parameters:

locator - elements locator

timeout - timeout for search

Returns:

list of found elements

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                          ElementState state)

Finds elements in desired ElementState with default timeout.

Parameters:

locator - elements locator

state - desired ElementState

Returns:

list of found elements

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator)

Finds elements in any state with default timeout.

Specified by:

findElements in interface org.openqa.selenium.SearchContext

Parameters:

locator - elements locator

Returns:

list of found elements

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                          Predicate<org.openqa.selenium.WebElement> elementStateCondition,
                                                          Duration timeout)

Finds elements in state defined by predicate.

Parameters:

locator - elements locator

timeout - timeout for search

elementStateCondition - predicate to define element state

Returns:

list of found elements

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                          Predicate<org.openqa.selenium.WebElement> elementStateCondition)

Finds elements in state defined by predicate with default timeout.

Parameters:

locator - elements locator

elementStateCondition - predicate to define element state

Returns:

list of found elements

findElements

List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                  DesiredState desiredState,
                                                  Duration timeout)

Finds elements in state defined by DesiredState.

Parameters:

locator - elements locator

timeout - timeout for search

desiredState - object with predicate to define element state

Returns:

list of found elements

findElements

default List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By locator,
                                                          DesiredState desiredState)

Finds elements in state defined by DesiredState with default timeout.

Parameters:

locator - elements locator

desiredState - object with predicate to define element state

Returns:

list of found elements