org.fluentlenium.core.wait

Class FluentWaitElementList

java.lang.Object

org.fluentlenium.core.wait.FluentWaitElementList

All Implemented Interfaces:

FluentWaitConditions<FluentWaitElementList>, FluentWaitConfiguration<FluentWaitElementList>, FluentWaitFunctional<FluentControl>, org.openqa.selenium.support.ui.Wait<FluentControl>

public class FluentWaitElementList
extends java.lang.Object
implements FluentWaitFunctional<FluentControl>, FluentWaitConditions<FluentWaitElementList>, FluentWaitConfiguration<FluentWaitElementList>

A wait object wrapping default selenium FluentWait object into a more complete API, allowing to wait for any condition to be verified on underlying elements.

Constructor Summary

Constructors

Constructor and Description
FluentWaitElementList(FluentWait controlWait, java.util.List<? extends FluentWebElement> elements) Creates a new fluent wait for a given elements.

Method Summary

Modifier and Type	Method and Description
FluentWaitElementList	atMost(java.time.Duration duration) Configure timeout for this wait object.
FluentWaitElementList	atMost(long timeInMillis) Configure wait timeout for this wait object.
FluentWaitElementList	atMost(long duration, java.util.concurrent.TimeUnit unit) Configure timeout for this wait object.
FluentWaitElementList	explicitlyFor(long amount) Waits unconditionally for an explicit amount of time.
FluentWaitElementList	explicitlyFor(long amount, java.util.concurrent.TimeUnit timeUnit) Waits unconditionally for an explicit amount of time.
org.openqa.selenium.support.ui.FluentWait	getWait() Get the underlying selenium wait object
boolean	hasMessageDefined() Check if a message is defined.
FluentWaitElementList	ignoreAll(java.util.Collection<java.lang.Class<? extends java.lang.Throwable>> types) Add given exceptions to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.
FluentWaitElementList	ignoring(java.lang.Class<? extends java.lang.RuntimeException> exceptionType) Add given exception to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.
FluentWaitElementList	ignoring(java.lang.Class<? extends java.lang.RuntimeException> firstType, java.lang.Class<? extends java.lang.RuntimeException> secondType) Add given exceptions to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.
FluentWaitElementList	pollingEvery(java.time.Duration duration) Configure polling time for this wait object.
FluentWaitElementList	pollingEvery(long duration) Configure polling time for this wait object.
FluentWaitElementList	pollingEvery(long duration, java.util.concurrent.TimeUnit unit) Configure polling time for this wait object.
FluentConditions	until() Get a conditions object used to wait for condition on current elements.
FluentConditions	until(FluentWebElement element) Get a conditions object used to wait for condition on given element.
<T> T	until(java.util.function.Function<? super FluentControl,T> function) Wait until the function returns a non-null and non-false object.
<T> T	until(com.google.common.base.Function<? super FluentControl,T> function) Deprecated.
FluentListConditions	until(java.util.List<? extends FluentWebElement> elements) Get a conditions object used to wait for a condition on given elements.
void	until(java.util.function.Supplier<java.lang.Boolean> supplier) Wait until the supplier returns true.
FluentConditions	untilEach() Get a conditions object used to wait for condition on current elements.
FluentListConditions	untilEach(java.util.List<? extends FluentWebElement> elements) Get a conditions object used to wait for a condition on given elements.
FluentListConditions	untilEachElements(java.util.function.Supplier<? extends java.util.List<? extends FluentWebElement>> selector) Get a conditions object used to wait for a condition on given elements.
FluentConditions	untilElement(java.util.function.Supplier<? extends FluentWebElement> selector) Get a conditions object used to wait for a condition on given element.
FluentListConditions	untilElements(java.util.function.Supplier<? extends java.util.List<? extends FluentWebElement>> selector) Get a conditions object used to wait for a condition on given elements.
FluentWaitPageConditions	untilPage() Get a condition object used to wait for a page condition.
FluentWaitPageConditions	untilPage(FluentPage page) Get a condition object used to wait for a page condition.
void	untilPredicate(java.util.function.Predicate<FluentControl> predicate) Wait until the predicate returns true.
FluentWaitWindowConditions	untilWindow(java.lang.String windowName) Get a condition object used to wait for a window condition.
FluentWaitElementList	withMessage(java.lang.String message) Configures a custom message to be used if the condition fails during the timeout duration.
FluentWaitElementList	withMessage(java.util.function.Supplier<java.lang.String> message) Configures a custom message supplier to be used if the condition fails during the timeout duration.
FluentWaitElementList	withNoDefaultsException() Removes default exceptions from exceptions ignore list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FluentWaitElementList

public FluentWaitElementList(FluentWait controlWait,
                             java.util.List<? extends FluentWebElement> elements)

Creates a new fluent wait for a given elements.

Parameters:

controlWait - underlying wait from control interface

elements - underlying elements

Method Detail

until

public FluentConditions until()

Get a conditions object used to wait for condition on current elements.

At least one element must verify the condition to be verified.

Returns:

conditions object

untilEach

public FluentConditions untilEach()

Get a conditions object used to wait for condition on current elements.

Each element must verify the condition to be verified.

Returns:

conditions object

getWait

public org.openqa.selenium.support.ui.FluentWait getWait()

Description copied from interface: FluentWaitConfiguration

Get the underlying selenium wait object

Specified by:

getWait in interface FluentWaitConfiguration<FluentWaitElementList>

Returns:

selenium wait

atMost

public FluentWaitElementList atMost(java.time.Duration duration)

Description copied from interface: FluentWaitConfiguration

Configure timeout for this wait object.

Specified by:

atMost in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

duration - duration

Returns:

this object to chain method calls

atMost

public FluentWaitElementList atMost(long duration,
                                    java.util.concurrent.TimeUnit unit)

Description copied from interface: FluentWaitConfiguration

Configure timeout for this wait object.

Specified by:

atMost in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

duration - duration

unit - time unit

Returns:

this object to chain method calls

atMost

public FluentWaitElementList atMost(long timeInMillis)

Description copied from interface: FluentWaitConfiguration

Configure wait timeout for this wait object.

Specified by:

atMost in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

timeInMillis - duration in millisecond

Returns:

this object to chain method calls

pollingEvery

public FluentWaitElementList pollingEvery(java.time.Duration duration)

Description copied from interface: FluentWaitConfiguration

Configure polling time for this wait object.

Specified by:

pollingEvery in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

duration - duration between each condition invocation

Returns:

this object to chain method calls

pollingEvery

public FluentWaitElementList pollingEvery(long duration,
                                          java.util.concurrent.TimeUnit unit)

Description copied from interface: FluentWaitConfiguration

Configure polling time for this wait object.

Specified by:

pollingEvery in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

duration - duration between each condition invocation

unit - time unit

Returns:

this object to chain method calls

pollingEvery

public FluentWaitElementList pollingEvery(long duration)

Description copied from interface: FluentWaitConfiguration

Configure polling time for this wait object.

Specified by:

pollingEvery in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

duration - duration in millisecond between each condition invocation

Returns:

this object to chain method calls

ignoreAll

public FluentWaitElementList ignoreAll(java.util.Collection<java.lang.Class<? extends java.lang.Throwable>> types)

Description copied from interface: FluentWaitConfiguration

Add given exceptions to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.

Specified by:

ignoreAll in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

types - collection of exception type to ignore

Returns:

this object to chain method calls

ignoring

public FluentWaitElementList ignoring(java.lang.Class<? extends java.lang.RuntimeException> exceptionType)

Description copied from interface: FluentWaitConfiguration

Add given exception to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.

Specified by:

ignoring in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

exceptionType - exception type to ignore

Returns:

this object to chain method calls

ignoring

public FluentWaitElementList ignoring(java.lang.Class<? extends java.lang.RuntimeException> firstType,
                                      java.lang.Class<? extends java.lang.RuntimeException> secondType)

Description copied from interface: FluentWaitConfiguration

Add given exceptions to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.

Specified by:

ignoring in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

firstType - exception type to ignore

secondType - exception type to ignore

Returns:

this object to chain method calls

untilPredicate

public void untilPredicate(java.util.function.Predicate<FluentControl> predicate)

Description copied from interface: FluentWaitFunctional

Wait until the predicate returns true.

Specified by:

untilPredicate in interface FluentWaitFunctional<FluentControl>

Parameters:

predicate - predicate condition to wait for

until

public void until(java.util.function.Supplier<java.lang.Boolean> supplier)

Description copied from interface: FluentWaitFunctional

Wait until the supplier returns true.

Specified by:

until in interface FluentWaitFunctional<FluentControl>

Parameters:

supplier - supplier condition to wait for.

until

public <T> T until(java.util.function.Function<? super FluentControl,T> function)

Description copied from interface: FluentWaitFunctional

Wait until the function returns a non-null and non-false object.

Specified by:

until in interface FluentWaitFunctional<FluentControl>

Specified by:

until in interface org.openqa.selenium.support.ui.Wait<FluentControl>

Type Parameters:

T - type of returned object

Parameters:

function - function returning a non-null and non-false object when condition is verified.

Returns:

object returned by function

withMessage

public FluentWaitElementList withMessage(java.lang.String message)

Description copied from interface: FluentWaitConfiguration

Configures a custom message to be used if the condition fails during the timeout duration.

Specified by:

withMessage in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

message - failing message

Returns:

this object to chain method calls

withMessage

public FluentWaitElementList withMessage(java.util.function.Supplier<java.lang.String> message)

Description copied from interface: FluentWaitConfiguration

Configures a custom message supplier to be used if the condition fails during the timeout duration.

Specified by:

withMessage in interface FluentWaitConfiguration<FluentWaitElementList>

Parameters:

message - failing message

Returns:

this object to chain method calls

hasMessageDefined

public boolean hasMessageDefined()

Description copied from interface: FluentWaitConfiguration

Check if a message is defined.

Specified by:

hasMessageDefined in interface FluentWaitConfiguration<FluentWaitElementList>

Returns:

true if this fluent wait use a custom message, false otherwise

withNoDefaultsException

public FluentWaitElementList withNoDefaultsException()

Description copied from interface: FluentWaitConfiguration

Removes default exceptions from exceptions ignore list.

Specified by:

withNoDefaultsException in interface FluentWaitConfiguration<FluentWaitElementList>

Returns:

this object to chain method calls

until

public FluentConditions until(FluentWebElement element)

Description copied from interface: FluentWaitConditions

Get a conditions object used to wait for condition on given element.

Specified by:

until in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

element - element to wait for

Returns:

conditions object

until

public FluentListConditions until(java.util.List<? extends FluentWebElement> elements)

Description copied from interface: FluentWaitConditions

Get a conditions object used to wait for a condition on given elements.

At least one element must verify the condition to be verified.

Specified by:

until in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

elements - elements to wait for

Returns:

conditions object

untilEach

public FluentListConditions untilEach(java.util.List<? extends FluentWebElement> elements)

Description copied from interface: FluentWaitConditions

Get a conditions object used to wait for a condition on given elements.

Each element must verify the condition to be verified.

Specified by:

untilEach in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

elements - elements to wait for

Returns:

conditions object

untilElement

public FluentConditions untilElement(java.util.function.Supplier<? extends FluentWebElement> selector)

Description copied from interface: FluentWaitConditions

Get a conditions object used to wait for a condition on given element.

Specified by:

untilElement in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

selector - element to wait for

Returns:

conditions object

untilElements

public FluentListConditions untilElements(java.util.function.Supplier<? extends java.util.List<? extends FluentWebElement>> selector)

Description copied from interface: FluentWaitConditions

Get a conditions object used to wait for a condition on given elements.

At least one element must verify the condition to be verified.

Specified by:

untilElements in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

selector - elements to wait for

Returns:

conditions object

untilEachElements

public FluentListConditions untilEachElements(java.util.function.Supplier<? extends java.util.List<? extends FluentWebElement>> selector)

Description copied from interface: FluentWaitConditions

Get a conditions object used to wait for a condition on given elements.

Each element must verify the condition to be verified.

Specified by:

untilEachElements in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

selector - elements to wait for

Returns:

conditions object

untilWindow

public FluentWaitWindowConditions untilWindow(java.lang.String windowName)

Description copied from interface: FluentWaitConditions

Get a condition object used to wait for a window condition.

Specified by:

untilWindow in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

windowName - name of the window to wait for

Returns:

window conditions object

untilPage

public FluentWaitPageConditions untilPage()

Description copied from interface: FluentWaitConditions

Get a condition object used to wait for a page condition.

Specified by:

untilPage in interface FluentWaitConditions<FluentWaitElementList>

Returns:

page conditions object

untilPage

public FluentWaitPageConditions untilPage(FluentPage page)

Description copied from interface: FluentWaitConditions

Get a condition object used to wait for a page condition.

Specified by:

untilPage in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

page - page to wait for

Returns:

page conditions object

explicitlyFor

public FluentWaitElementList explicitlyFor(long amount,
                                           java.util.concurrent.TimeUnit timeUnit)

Description copied from interface: FluentWaitConditions

Waits unconditionally for an explicit amount of time.

The method should be used only as a last resort.

In most cases you should wait for some condition, e.g. visibility of particular element on the page.

Specified by:

explicitlyFor in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

amount - amount of time

timeUnit - unit of time

Returns:

this object to chain method calls

explicitlyFor

public FluentWaitElementList explicitlyFor(long amount)

Description copied from interface: FluentWaitConditions

Waits unconditionally for an explicit amount of time.

The method should be used only as a last resort.

In most cases you should wait for some condition, e.g. visibility of particular element on the page.

Specified by:

explicitlyFor in interface FluentWaitConditions<FluentWaitElementList>

Parameters:

amount - amount of time to wait in milliseconds

Returns:

this object to chain method calls

until

@Deprecated
public <T> T until(com.google.common.base.Function<? super FluentControl,T> function)

Deprecated.

Wait until function returns true

Type Parameters:

T - FluentWaitElementList

Parameters:

function - function to be performed

Returns:

FluentWaitElementList