FluentWaitElement (FluentLenium Core 3.0.3 API)

java.lang.Object
- org.fluentlenium.core.wait.FluentWaitElement

All Implemented Interfaces:

FluentWaitConditions<FluentWaitElement>, FluentWaitConfiguration<FluentWaitElement>, FluentWaitFunctional<FluentControl>, org.openqa.selenium.support.ui.Wait<FluentControl>
```
public class FluentWaitElement
extends Object
implements FluentWaitFunctional<FluentControl>, FluentWaitConditions<FluentWaitElement>, FluentWaitConfiguration<FluentWaitElement>
```
A wait object wrapping default selenium FluentWait object into a more complete API, allowing to wait for any condition to be verified on an underlying element.

Constructor Summary

Constructors
Constructor and Description

FluentWaitElement(FluentWait controlWait, FluentWebElement element)
Creates a new fluent wait for a given element.

Constructors
Constructor and Description
`FluentWaitElement(FluentWait controlWait, FluentWebElement element)` Creates a new fluent wait for a given element.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`FluentWaitElement`	`atMost(long timeInMillis)` Configure wait timeout for this wait object.
`FluentWaitElement`	`atMost(long duration, TimeUnit unit)` Configure timeout for this wait object.
`FluentWaitElement`	`explicitlyFor(long amount)` Waits unconditionally for an explicit amount of time.
`FluentWaitElement`	`explicitlyFor(long amount, 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.
`FluentWaitElement`	`ignoreAll(Collection<Class<? extends Throwable>> types)` Add given exceptions to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.
`FluentWaitElement`	`ignoring(Class<? extends RuntimeException> exceptionType)` Add given exception to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.
`FluentWaitElement`	`ignoring(Class<? extends RuntimeException> firstType, Class<? extends RuntimeException> secondType)` Add given exceptions to ignore list to avoid breaking the wait when they occurs in the underlying condition evaluation.
`FluentWaitElement`	`pollingEvery(long duration)` Configure polling time for this wait object.
`FluentWaitElement`	`pollingEvery(long duration, TimeUnit unit)` Configure polling time for this wait object.
`FluentConditions`	`until()` Get a conditions object used to wait for condition on current element.
`FluentConditions`	`until(FluentWebElement element)` Get a conditions object used to wait for condition on given element.
`<T> T`	`until(com.google.common.base.Function<? super FluentControl,T> isTrue)` Wait until the function returns a non-null and non-false object.
`FluentListConditions`	`until(List<? extends FluentWebElement> elements)` Get a conditions object used to wait for a condition on given elements.
`void`	`until(com.google.common.base.Supplier<Boolean> isTrue)` Wait until the supplier returns true.
`FluentListConditions`	`untilEach(List<? extends FluentWebElement> elements)` Get a conditions object used to wait for a condition on given elements.
`FluentListConditions`	`untilEachElements(com.google.common.base.Supplier<? extends List<? extends FluentWebElement>> selector)` Get a conditions object used to wait for a condition on given elements.
`FluentConditions`	`untilElement(com.google.common.base.Supplier<? extends FluentWebElement> selector)` Get a conditions object used to wait for a condition on given element.
`FluentListConditions`	`untilElements(com.google.common.base.Supplier<? extends 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(com.google.common.base.Predicate<FluentControl> predicate)` Wait until the predicate returns true.
`FluentWaitWindowConditions`	`untilWindow(String windowName)` Get a condition object used to wait for a window condition.
`FluentWaitElement`	`withMessage(String message)` Configures a custom message to be used if the condition fails during the timeout duration.
`FluentWaitElement`	`withMessage(com.google.common.base.Supplier<String> message)` Configures a custom message supplier to be used if the condition fails during the timeout duration.
`FluentWaitElement`	`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
  - FluentWaitElement
```
public FluentWaitElement(FluentWait controlWait,
                         FluentWebElement element)
```
    Creates a new fluent wait for a given element.
    
    Parameters:
    
    controlWait - underlying wait from control interface
    
    element - underlying element
- Method Detail
  - until
```
public FluentConditions until()
```
    Get a conditions object used to wait for condition on current element.
    
    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<FluentWaitElement>
    
    Returns:
    
    selenium wait
  - atMost
```
public FluentWaitElement atMost(long duration,
                                TimeUnit unit)
```
    Description copied from interface: FluentWaitConfiguration
    
    Configure timeout for this wait object.
    
    Specified by:
    
    atMost in interface FluentWaitConfiguration<FluentWaitElement>
    
    Parameters:
    
    duration - duration
    
    unit - time unit
    
    Returns:
    
    this object to chain method calls
  - atMost
```
public FluentWaitElement atMost(long timeInMillis)
```
    Description copied from interface: FluentWaitConfiguration
    
    Configure wait timeout for this wait object.
    
    Specified by:
    
    atMost in interface FluentWaitConfiguration<FluentWaitElement>
    
    Parameters:
    
    timeInMillis - duration in millisecond
    
    Returns:
    
    this object to chain method calls
  - pollingEvery
```
public FluentWaitElement pollingEvery(long duration,
                                      TimeUnit unit)
```
    Description copied from interface: FluentWaitConfiguration
    
    Configure polling time for this wait object.
    
    Specified by:
    
    pollingEvery in interface FluentWaitConfiguration<FluentWaitElement>
    
    Parameters:
    
    duration - duration between each condition invocation
    
    unit - time unit
    
    Returns:
    
    this object to chain method calls
  - pollingEvery
```
public FluentWaitElement pollingEvery(long duration)
```
    Description copied from interface: FluentWaitConfiguration
    
    Configure polling time for this wait object.
    
    Specified by:
    
    pollingEvery in interface FluentWaitConfiguration<FluentWaitElement>
    
    Parameters:
    
    duration - duration in millisecond between each condition invocation
    
    Returns:
    
    this object to chain method calls
  - ignoreAll
```
public FluentWaitElement ignoreAll(Collection<Class<? extends 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<FluentWaitElement>
    
    Parameters:
    
    types - collection of exception type to ignore
    
    Returns:
    
    this object to chain method calls
  - ignoring
```
public FluentWaitElement ignoring(Class<? extends 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<FluentWaitElement>
    
    Parameters:
    
    exceptionType - exception type to ignore
    
    Returns:
    
    this object to chain method calls
  - ignoring
```
public FluentWaitElement ignoring(Class<? extends RuntimeException> firstType,
                                  Class<? extends 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<FluentWaitElement>
    
    Parameters:
    
    firstType - exception type to ignore
    
    secondType - exception type to ignore
    
    Returns:
    
    this object to chain method calls
  - withMessage
```
public FluentWaitElement withMessage(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<FluentWaitElement>
    
    Parameters:
    
    message - failing message
    
    Returns:
    
    this object to chain method calls
  - withMessage
```
public FluentWaitElement withMessage(com.google.common.base.Supplier<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<FluentWaitElement>
    
    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<FluentWaitElement>
    
    Returns:
    
    true if this fluent wait use a custom message, false otherwise
  - withNoDefaultsException
```
public FluentWaitElement withNoDefaultsException()
```
    Description copied from interface: FluentWaitConfiguration
    
    Removes default exceptions from exceptions ignore list.
    
    Specified by:
    
    withNoDefaultsException in interface FluentWaitConfiguration<FluentWaitElement>
    
    Returns:
    
    this object to chain method calls
  - untilPredicate
```
public void untilPredicate(com.google.common.base.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(com.google.common.base.Supplier<Boolean> isTrue)
```
    Description copied from interface: FluentWaitFunctional
    
    Wait until the supplier returns true.
    
    Specified by:
    
    until in interface FluentWaitFunctional<FluentControl>
    
    Parameters:
    
    isTrue - supplier condition to wait for.
  - until
```
public <T> T until(com.google.common.base.Function<? super FluentControl,T> isTrue)
```
    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:
    
    isTrue - function returning a non-null and non-false object when condition is verified.
    
    Returns:
    
    object returned by function
  - 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<FluentWaitElement>
    
    Parameters:
    
    element - element to wait for
    
    Returns:
    
    conditions object
  - until
```
public FluentListConditions until(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<FluentWaitElement>
    
    Parameters:
    
    elements - elements to wait for
    
    Returns:
    
    conditions object
  - untilEach
```
public FluentListConditions untilEach(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<FluentWaitElement>
    
    Parameters:
    
    elements - elements to wait for
    
    Returns:
    
    conditions object
  - untilElement
```
public FluentConditions untilElement(com.google.common.base.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<FluentWaitElement>
    
    Parameters:
    
    selector - element to wait for
    
    Returns:
    
    conditions object
  - untilElements
```
public FluentListConditions untilElements(com.google.common.base.Supplier<? extends 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<FluentWaitElement>
    
    Parameters:
    
    selector - elements to wait for
    
    Returns:
    
    conditions object
  - untilEachElements
```
public FluentListConditions untilEachElements(com.google.common.base.Supplier<? extends 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<FluentWaitElement>
    
    Parameters:
    
    selector - elements to wait for
    
    Returns:
    
    conditions object
  - untilWindow
```
public FluentWaitWindowConditions untilWindow(String windowName)
```
    Description copied from interface: FluentWaitConditions
    
    Get a condition object used to wait for a window condition.
    
    Specified by:
    
    untilWindow in interface FluentWaitConditions<FluentWaitElement>
    
    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<FluentWaitElement>
    
    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<FluentWaitElement>
    
    Parameters:
    
    page - page to wait for
    
    Returns:
    
    page conditions object
  - explicitlyFor
```
public FluentWaitElement 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<FluentWaitElement>
    
    Parameters:
    
    amount - amount of time to wait in milliseconds
    
    Returns:
    
    this object to chain method calls
  - explicitlyFor
```
public FluentWaitElement explicitlyFor(long amount,
                                       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<FluentWaitElement>
    
    Parameters:
    
    amount - amount of time
    
    timeUnit - unit of time
    
    Returns:
    
    this object to chain method calls

Class FluentWaitElement

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FluentWaitElement

Method Detail

until

getWait

atMost

atMost

pollingEvery

pollingEvery

ignoreAll

ignoring

ignoring

withMessage

withMessage

hasMessageDefined

withNoDefaultsException

untilPredicate

until

until

until

until

untilEach

untilElement

untilElements

untilEachElements

untilWindow

untilPage

untilPage

explicitlyFor

explicitlyFor