FluentListImpl (FluentLenium Core 3.7.1 API)

java.lang.Object
- org.fluentlenium.core.domain.DelegatingList<T>
- - org.fluentlenium.core.domain.ComponentList<E>
  - - org.fluentlenium.core.domain.FluentListImpl<E>

Type Parameters:

E - type of fluent element

All Implemented Interfaces:

java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>, FluentActions<FluentList<E>,E>, FluentJavascriptActions, LazyComponents, FluentList<E>, WrapsElements, HookControl<FluentList<E>>, FluentLabel<FluentList<E>>, FluentProxyState<FluentList<E>>, SearchControl<E>
```
public class FluentListImpl<E extends FluentWebElement>
extends ComponentList<E>
implements FluentList<E>
```
Map the list to a FluentList in order to offers some events like click(), submit(), value() ...

Field Summary
- Fields inherited from class org.fluentlenium.core.domain.ComponentList
  componentClass, control, instantiator, proxy
- Fields inherited from class org.fluentlenium.core.domain.DelegatingList
  list

Constructor Summary

Constructors
Constructor and Description
`FluentListImpl(java.lang.Class<E> componentClass, java.util.List<E> list, FluentControl control, ComponentInstantiator instantiator)` Creates a new fluent list.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`FluentList<E>`	`$(org.openqa.selenium.By locator, SearchFilter... filters)` Find list of elements with Selenium locator and filters.
`FluentList<E>`	`$(java.util.List<org.openqa.selenium.WebElement> rawElements)` Wrap raw selenium elements into a list of elements.
`FluentList<E>`	`$(SearchFilter... filters)` Find list of elements with filters.
`FluentList<E>`	`$(java.lang.String selector, SearchFilter... filters)` Find list of elements with CSS selector and filters.
`<T extends FluentWebElement> FluentList<T>`	`as(java.lang.Class<T> componentClass)` Wrap all underlying elements in a componen..
`java.util.List<java.lang.String>`	`attributes(java.lang.String attribute)` Return a custom attribute of elements on the list
`FluentWaitElementList`	`await()` Build a wait object to wait for a condition of this element list.
`FluentListConditions`	`awaitUntilEach()` Build a condition object on this element list that will match if each underlying element match, automatically waiting for condition to be verified.
`FluentListConditions`	`awaitUntilOne()` Build a condition object on this element list that will match if one or more underlying element match, automatically waiting for condition to be verified.
`void`	`clear()` Clear visible elements on the list
`FluentList<E>`	`clearAll()` Clear all elements on the list
`void`	`clearList()` Calls `List.clear()` from underlying List implementation.
`FluentList`	`click()` Click on all elements on the list Only the clickable elements are clicked
`FluentList<E>`	`contextClick()` context click on all elements on the list Only the clickable elements are clicked
`int`	`count()` Count elements without actually loading the lazy list.
`FluentList`	`doubleClick()` double click on all elements on the list Only the clickable elements are clicked
`FluentListConditions`	`each()` Build a condition object on this element list that will match if each underlying element match.
`E`	`el(org.openqa.selenium.By locator, SearchFilter... filters)` Find first element with Selenium locator and filters.
`E`	`el(SearchFilter... filters)` Find first element with filters.
`E`	`el(java.lang.String selector, SearchFilter... filters)` Find first element with CSS selector and filters.
`E`	`el(org.openqa.selenium.WebElement rawElement)` Wrap existing raw selenium element into an element.
`Fill`	`fill()` Construct a Fill Builder in order to allow easy fill of visible input fields.
`FillSelect`	`fillSelect()` Construct a Fill Select Builder in order to allow easy fill of visible input fields.
`FluentList<E>`	`find(org.openqa.selenium.By locator, SearchFilter... filters)` Find list of elements with Selenium locator and filters.
`FluentList<E>`	`find(java.util.List<org.openqa.selenium.WebElement> rawElements)` Wrap raw selenium elements into a list of elements.
`FluentList<E>`	`find(SearchFilter... filters)` find elements in the children with the corresponding filters
`FluentList<E>`	`find(java.lang.String selector, SearchFilter... filters)` find elements into the children with the corresponding filters
`E`	`first()` Retrieve the first element.
`FluentList<E>`	`frame()` Select a frame using this element.
`java.util.List<java.lang.String>`	`ids()` Return the id of elements on the list
`E`	`index(int index)` Retrieve an element at given index.
`E`	`last()` Retrieve the last element.
`boolean`	`loaded()` Check if the element is loaded.
`java.util.List<java.lang.String>`	`names()` Return the name of elements on the list
`FluentList<E>`	`now()` Search for the element now, actually performing the search on the `WebDriver`.
`FluentList<E>`	`now(boolean force)` Search for the element now, actually performing the search on the `WebDriver`.
`FluentListConditions`	`one()` Build a condition object on this element list that will match if one or more underlying element match.
`java.util.Optional<FluentList<E>>`	`optional()` Builds an optional.
`boolean`	`present()` Check if the element is present in the DOM.
`FluentList<E>`	`reset()` Reset the element.
`E`	`single()` Retrieve the first element and checks is it exactly one element in the list
`FluentList<E>`	`submit()` submit on all elements on the list Only the visible elements are submitted
`java.util.List<java.lang.String>`	`tagNames()` Return the tag name of elements on the list
`java.util.List<java.lang.String>`	`textContents()` Return the text contents of list elements
`java.util.List<java.lang.String>`	`texts()` Return the texts of list elements
`java.util.List<org.openqa.selenium.WebElement>`	`toElements()` Creates a list of Selenium `WebElement` from this list
`java.lang.String`	`toString()`
`java.util.List<java.lang.String>`	`values()` Return the value of elements on the list
`FluentList`	`write(java.lang.String... with)` Fill all elements on the list with the corresponding cell in the with table.

Methods inherited from class org.fluentlenium.core.domain.ComponentList
getWrappedElements

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List
add, add, addAll, addAll, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable
forEach

Methods inherited from interface org.fluentlenium.core.action.FluentJavascriptActions
scrollIntoView, scrollIntoView, scrollToCenter

Methods inherited from interface org.fluentlenium.core.hook.HookControl
noHook, noHook, noHook, noHook, noHookInstance, noHookInstance, restoreHooks, withHook, withHook

Methods inherited from interface org.fluentlenium.core.label.FluentLabel
withLabel, withLabelHint

Methods inherited from interface org.fluentlenium.core.components.LazyComponents
addLazyComponentsListener, isLazy, isLazyInitialized, removeLazyComponentsListener

- Constructor Detail
  - FluentListImpl
```
public FluentListImpl(java.lang.Class<E> componentClass,
                      java.util.List<E> list,
                      FluentControl control,
                      ComponentInstantiator instantiator)
```
    Creates a new fluent list.
    
    Parameters:
    
    componentClass - component class
    
    list - list of fluent element
    
    control - control interface
    
    instantiator - component instantiator
- Method Detail
  - toElements
```
public java.util.List<org.openqa.selenium.WebElement> toElements()
```
    Description copied from interface: FluentList
    
    Creates a list of Selenium WebElement from this list
    
    Specified by:
    
    toElements in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of selenium elements
  - await
```
public FluentWaitElementList await()
```
    Description copied from interface: FluentList
    
    Build a wait object to wait for a condition of this element list.
    
    Specified by:
    
    await in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    a wait object
  - first
```
public E first()
```
    Description copied from interface: FluentList
    
    Retrieve the first element.
    
    Specified by:
    
    first in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    first element
  - single
```
public E single()
```
    Description copied from interface: FluentList
    
    Retrieve the first element and checks is it exactly one element in the list
    
    Specified by:
    
    single in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    first element
  - last
```
public E last()
```
    Description copied from interface: FluentList
    
    Retrieve the last element.
    
    Specified by:
    
    last in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    last element
  - index
```
public E index(int index)
```
    Description copied from interface: FluentList
    
    Retrieve an element at given index.
    
    Specified by:
    
    index in interface FluentList<E extends FluentWebElement>
    
    Parameters:
    
    index - position of the element to retrieve
    
    Returns:
    
    element at given index
  - count
```
public int count()
```
    Description copied from interface: FluentList
    
    Count elements without actually loading the lazy list.
    This method ignore defined hooks.
    
    Specified by:
    
    count in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    elements count
  - present
```
public boolean present()
```
    Description copied from interface: FluentProxyState
    
    Check if the element is present in the DOM.
    
    Specified by:
    
    present in interface FluentProxyState<FluentList<E extends FluentWebElement>>
    
    Returns:
    
    true if the element is present, false otherwise
  - now
```
public FluentList<E> now()
```
    Description copied from interface: FluentProxyState
    
    Search for the element now, actually performing the search on the WebDriver.
    It has no effect if the element is already loaded.
    
    Specified by:
    
    now in interface FluentProxyState<FluentList<E extends FluentWebElement>>
    
    Returns:
    
    this object reference to chain calls.
  - now
```
public FluentList<E> now(boolean force)
```
    Description copied from interface: FluentProxyState
    
    Search for the element now, actually performing the search on the WebDriver.
    It has no effect if the element is already loaded.
    
    Specified by:
    
    now in interface FluentProxyState<FluentList<E extends FluentWebElement>>
    
    Parameters:
    
    force - force the search even if element is already loaded
    
    Returns:
    
    this object reference to chain calls.
  - reset
```
public FluentList<E> reset()
```
    Description copied from interface: FluentProxyState
    
    Reset the element. Subsequent calls will perform the search again, instead of using the cached result.
    
    Specified by:
    
    reset in interface FluentProxyState<FluentList<E extends FluentWebElement>>
    
    Returns:
    
    this object reference to chain calls.
  - loaded
```
public boolean loaded()
```
    Description copied from interface: FluentProxyState
    
    Check if the element is loaded.
    
    Specified by:
    
    loaded in interface FluentProxyState<FluentList<E extends FluentWebElement>>
    
    Returns:
    
    true if the element is loaded, false otherwise
  - click
```
public FluentList click()
```
    Description copied from interface: FluentList
    
    Click on all elements on the list Only the clickable elements are clicked
    
    Specified by:
    
    click in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Specified by:
    
    click in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    this object reference to chain methods calls
    
    See Also:
    
    WebElement.click()
  - doubleClick
```
public FluentList doubleClick()
```
    Description copied from interface: FluentList
    
    double click on all elements on the list Only the clickable elements are clicked
    
    Specified by:
    
    doubleClick in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Specified by:
    
    doubleClick in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    this object reference to chain methods calls
  - contextClick
```
public FluentList<E> contextClick()
```
    Description copied from interface: FluentList
    
    context click on all elements on the list Only the clickable elements are clicked
    
    Specified by:
    
    contextClick in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Specified by:
    
    contextClick in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    this object reference to chain methods calls
  - write
```
public FluentList write(java.lang.String... with)
```
    Description copied from interface: FluentList
    
    Fill all elements on the list with the corresponding cell in the with table. Only the visible elements are filled If there is more elements on the list than in the with table, the last element of the table is repeated
    
    Specified by:
    
    write in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Specified by:
    
    write in interface FluentList<E extends FluentWebElement>
    
    Parameters:
    
    with - one or many text to send.
    
    Returns:
    
    this object reference to chain methods calls.
    
    See Also:
    
    WebElement.sendKeys(CharSequence...)
  - clearAll
```
public FluentList<E> clearAll()
```
    Description copied from interface: FluentList
    
    Clear all elements on the list
    Only the visible elements are cleared.
    
    Specified by:
    
    clearAll in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    extended by FluentWebElement object
  - clearList
```
public void clearList()
```
    Description copied from interface: FluentList
    
    Calls List.clear() from underlying List implementation.
    
    Specified by:
    
    clearList in interface FluentList<E extends FluentWebElement>
    
    See Also:
    
    List.clear()
  - each
```
public FluentListConditions each()
```
    Description copied from interface: FluentList
    
    Build a condition object on this element list that will match if each underlying element match.
    
    Specified by:
    
    each in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    a condition object
  - one
```
public FluentListConditions one()
```
    Description copied from interface: FluentList
    
    Build a condition object on this element list that will match if one or more underlying element match.
    
    Specified by:
    
    one in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    a condition object
  - awaitUntilEach
```
public FluentListConditions awaitUntilEach()
```
    Description copied from interface: FluentList
    
    Build a condition object on this element list that will match if each underlying element match, automatically waiting for condition to be verified.
    
    Specified by:
    
    awaitUntilEach in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    a condition object
  - awaitUntilOne
```
public FluentListConditions awaitUntilOne()
```
    Description copied from interface: FluentList
    
    Build a condition object on this element list that will match if one or more underlying element match, automatically waiting for condition to be verified.
    
    Specified by:
    
    awaitUntilOne in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    a condition object
  - submit
```
public FluentList<E> submit()
```
    Description copied from interface: FluentList
    
    submit on all elements on the list Only the visible elements are submitted
    
    Specified by:
    
    submit in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Specified by:
    
    submit in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    this object reference to chain methods calls.
    
    See Also:
    
    WebElement.submit()
  - values
```
public java.util.List<java.lang.String> values()
```
    Description copied from interface: FluentList
    
    Return the value of elements on the list
    
    Specified by:
    
    values in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of string values
  - ids
```
public java.util.List<java.lang.String> ids()
```
    Description copied from interface: FluentList
    
    Return the id of elements on the list
    
    Specified by:
    
    ids in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of string values
  - attributes
```
public java.util.List<java.lang.String> attributes(java.lang.String attribute)
```
    Description copied from interface: FluentList
    
    Return a custom attribute of elements on the list
    
    Specified by:
    
    attributes in interface FluentList<E extends FluentWebElement>
    
    Parameters:
    
    attribute - attribute name
    
    Returns:
    
    list of string valuess
  - names
```
public java.util.List<java.lang.String> names()
```
    Description copied from interface: FluentList
    
    Return the name of elements on the list
    
    Specified by:
    
    names in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of string values
  - tagNames
```
public java.util.List<java.lang.String> tagNames()
```
    Description copied from interface: FluentList
    
    Return the tag name of elements on the list
    
    Specified by:
    
    tagNames in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of string values
  - textContents
```
public java.util.List<java.lang.String> textContents()
```
    Description copied from interface: FluentList
    
    Return the text contents of list elements
    
    Specified by:
    
    textContents in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of string values
  - texts
```
public java.util.List<java.lang.String> texts()
```
    Description copied from interface: FluentList
    
    Return the texts of list elements
    
    Specified by:
    
    texts in interface FluentList<E extends FluentWebElement>
    
    Returns:
    
    list of string values
  - $
```
public FluentList<E> $(java.lang.String selector,
                       SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find list of elements with CSS selector and filters.
    
    Specified by:
    
    $ in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    selector - CSS selector
    
    filters - set of filters
    
    Returns:
    
    list of element
  - el
```
public E el(java.lang.String selector,
            SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find first element with CSS selector and filters.
    
    Specified by:
    
    el in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    selector - CSS selector
    
    filters - set of filters
    
    Returns:
    
    element
  - $
```
public FluentList<E> $(SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find list of elements with filters.
    
    Specified by:
    
    $ in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    filters - set of filters in the current context
    
    Returns:
    
    list of elements
  - el
```
public E el(SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find first element with filters.
    
    Specified by:
    
    el in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    filters - set of filters in the current context
    
    Returns:
    
    element
  - $
```
public FluentList<E> $(org.openqa.selenium.By locator,
                       SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find list of elements with Selenium locator and filters.
    
    Specified by:
    
    $ in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    locator - elements locator
    
    filters - filters set
    
    Returns:
    
    list of elements
  - el
```
public E el(org.openqa.selenium.By locator,
            SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find first element with Selenium locator and filters.
    
    Specified by:
    
    el in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    locator - elements locator
    
    filters - filters set
    
    Returns:
    
    element
  - find
```
public FluentList<E> find(java.util.List<org.openqa.selenium.WebElement> rawElements)
```
    Description copied from interface: SearchControl
    
    Wrap raw selenium elements into a list of elements.
    
    Specified by:
    
    find in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    rawElements - raw selenium elements
    
    Returns:
    
    list of element
  - $
```
public FluentList<E> $(java.util.List<org.openqa.selenium.WebElement> rawElements)
```
    Description copied from interface: SearchControl
    
    Wrap raw selenium elements into a list of elements.
    
    Specified by:
    
    $ in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    rawElements - raw selenium elements
    
    Returns:
    
    list of element
  - el
```
public E el(org.openqa.selenium.WebElement rawElement)
```
    Description copied from interface: SearchControl
    
    Wrap existing raw selenium element into an element.
    
    Specified by:
    
    el in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    rawElement - raw selenium element
    
    Returns:
    
    element
  - find
```
public FluentList<E> find(java.lang.String selector,
                          SearchFilter... filters)
```
    Description copied from interface: FluentList
    
    find elements into the children with the corresponding filters
    
    Specified by:
    
    find in interface FluentList<E extends FluentWebElement>
    
    Specified by:
    
    find in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    selector - element name
    
    filters - set of filters
    
    Returns:
    
    extended by FluentWebElement objects list
  - find
```
public FluentList<E> find(org.openqa.selenium.By locator,
                          SearchFilter... filters)
```
    Description copied from interface: SearchControl
    
    Find list of elements with Selenium locator and filters.
    
    Specified by:
    
    find in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    locator - elements locator
    
    filters - filters set
    
    Returns:
    
    list of elements
  - find
```
public FluentList<E> find(SearchFilter... filters)
```
    Description copied from interface: FluentList
    
    find elements in the children with the corresponding filters
    
    Specified by:
    
    find in interface FluentList<E extends FluentWebElement>
    
    Specified by:
    
    find in interface SearchControl<E extends FluentWebElement>
    
    Parameters:
    
    filters - set of filters
    
    Returns:
    
    extended by FluentWebElement objects list
  - fill
```
public Fill fill()
```
    Description copied from interface: FluentActions
    
    Construct a Fill Builder in order to allow easy fill of visible input fields.
    
    Specified by:
    
    fill in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Returns:
    
    Fill builder
  - fillSelect
```
public FillSelect fillSelect()
```
    Description copied from interface: FluentActions
    
    Construct a Fill Select Builder in order to allow easy fill of visible input fields.
    
    Specified by:
    
    fillSelect in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Returns:
    
    Fill select builder
  - frame
```
public FluentList<E> frame()
```
    Description copied from interface: FluentActions
    
    Select a frame using this element.
    
    Specified by:
    
    frame in interface FluentActions<FluentList<E extends FluentWebElement>,E extends FluentWebElement>
    
    Returns:
    
    this object reference to chain methods calls.
  - optional
```
public java.util.Optional<FluentList<E>> optional()
```
    Description copied from interface: FluentProxyState
    
    Builds an optional. If underlying element is lazy, search will be perfomed when invoking this method.
    
    Specified by:
    
    optional in interface FluentProxyState<FluentList<E extends FluentWebElement>>
    
    Returns:
    
    An optional wrapping this.
    
    See Also:
    
    FluentProxyState.present(), FluentProxyState.now()
  - as
```
public <T extends FluentWebElement> FluentList<T> as(java.lang.Class<T> componentClass)
```
    Description copied from interface: FluentList
    
    Wrap all underlying elements in a componen..
    
    Specified by:
    
    as in interface FluentList<E extends FluentWebElement>
    
    Type Parameters:
    
    T - type of component
    
    Parameters:
    
    componentClass - component class
    
    Returns:
    
    fluent list of elements as components.
  - clear
```
public void clear()
```
    Description copied from interface: FluentList
    
    Clear visible elements on the list
    
    Specified by:
    
    clear in interface java.util.Collection<E extends FluentWebElement>
    
    Specified by:
    
    clear in interface java.util.List<E extends FluentWebElement>
    
    Specified by:
    
    clear in interface FluentList<E extends FluentWebElement>
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class FluentListImpl<E extends FluentWebElement>

Field Summary

Fields inherited from class org.fluentlenium.core.domain.ComponentList

Fields inherited from class org.fluentlenium.core.domain.DelegatingList

Constructor Summary

Method Summary

Methods inherited from class org.fluentlenium.core.domain.ComponentList

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.List

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Methods inherited from interface org.fluentlenium.core.action.FluentJavascriptActions

Methods inherited from interface org.fluentlenium.core.hook.HookControl

Methods inherited from interface org.fluentlenium.core.label.FluentLabel

Methods inherited from interface org.fluentlenium.core.components.LazyComponents

Constructor Detail

FluentListImpl

Method Detail

toElements

await

first

single

last

index

count

present

now

now

reset

loaded

click

doubleClick

contextClick

write

clearAll

clearList

each

one

awaitUntilEach

awaitUntilOne

submit

values

ids

attributes

names

tagNames

textContents

texts

$

el

$

el

$

el

find

$

el

find

find

find

fill

fillSelect

frame

optional

as

clear

toString