Package com.codeborne.selenide.appium

Class SelenideAppiumCollection

java.lang.Object

com.codeborne.selenide.BaseElementsCollection<SelenideElement,ElementsCollection>

com.codeborne.selenide.ElementsCollection

com.codeborne.selenide.appium.SelenideAppiumCollection

All Implemented Interfaces:

Iterable<SelenideElement>

public class SelenideAppiumCollection
extends ElementsCollection

Nested Class Summary

Nested classes/interfaces inherited from class com.codeborne.selenide.BaseElementsCollection

BaseElementsCollection.SelenideElementIterable<T extends SelenideElement>

Constructor Summary

Constructors

Constructor	Description
SelenideAppiumCollection(WebElementSource parent, org.openqa.selenium.By selector)

Method Summary

Modifier and Type	Method	Description
SelenideAppiumCollection	as(String alias)	Give this collection a human-readable name
protected SelenideAppiumCollection	create(CollectionSource source)
SelenideAppiumCollection	exclude(WebElementCondition condition)	Filters elements excluding those which met the given condition (lazy evaluation)
SelenideAppiumCollection	excludeWith(WebElementCondition condition)	Filters elements excluding those which met the given condition (lazy evaluation)
SelenideAppiumCollection	filter(WebElementCondition condition)	Filters collection elements based on the given condition (lazy evaluation)
SelenideAppiumCollection	filterBy(WebElementCondition condition)	Filters collection elements based on the given condition (lazy evaluation)
SelenideAppiumElement	find(WebElementCondition condition)	Find the first element which met the given condition (lazy evaluation)
SelenideAppiumElement	findBy(WebElementCondition condition)	Find the first element which met the given condition (lazy evaluation)
SelenideAppiumElement	first()	returns the first element of the collection (lazy evaluation)
SelenideAppiumCollection	first(int elements)	returns the first n elements of the collection (lazy evaluation)
SelenideAppiumElement	get(int index)	Gets the n-th element of collection (lazy evaluation)
SelenideAppiumElement	last()	returns the last element of the collection (lazy evaluation)
SelenideAppiumCollection	last(int elements)	returns the last n elements of the collection (lazy evaluation)
SelenideAppiumCollection	should(WebElementsCondition... conditions)	Check if a collection matches given condition(s).
SelenideAppiumCollection	should(WebElementsCondition condition, Duration timeout)	Check if a collection matches a given condition within the given time period.
SelenideAppiumCollection	shouldBe(WebElementsCondition... conditions)	For example: $$(".error").shouldBe(empty)
SelenideAppiumCollection	shouldBe(WebElementsCondition condition, Duration timeout)
SelenideAppiumCollection	shouldHave(WebElementsCondition... conditions)	For example: $$(".error").shouldHave(size(3)) $$(".error").shouldHave(texts("Error1", "Error2"))
SelenideAppiumCollection	shouldHave(WebElementsCondition condition, Duration timeout)	Check if a collection matches given condition within given period
SelenideAppiumCollection	snapshot()	Takes the snapshot of current state of this collection.

Methods inherited from class com.codeborne.selenide.BaseElementsCollection

asDynamicIterable, asFixedIterable, attributes, describe, isEmpty, iterator, should, size, stream, texts, toString, waitUntil

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

SelenideAppiumCollection

public SelenideAppiumCollection(WebElementSource parent,
 org.openqa.selenium.By selector)

Method Details

create

protected SelenideAppiumCollection create(CollectionSource source)

Overrides:

create in class ElementsCollection

should

@CanIgnoreReturnValue
public SelenideAppiumCollection should(WebElementsCondition... conditions)

Description copied from class: BaseElementsCollection

Check if a collection matches given condition(s).

For example:

 
 $$(".text_list").should(containExactTextsCaseSensitive("text1", "text2"));
 $$(".cat_list").should(allMatch("value==cat", el -> el.getAttribute("value").equals("cat")));
 
 

Overrides:

should in class BaseElementsCollection<SelenideElement,ElementsCollection>

should

@CanIgnoreReturnValue
public SelenideAppiumCollection should(WebElementsCondition condition,
 Duration timeout)

Description copied from class: BaseElementsCollection

Check if a collection matches a given condition within the given time period.

Overrides:

should in class BaseElementsCollection<SelenideElement,ElementsCollection>

timeout - maximum waiting time

shouldBe

@CanIgnoreReturnValue
public SelenideAppiumCollection shouldBe(WebElementsCondition... conditions)

Description copied from class: BaseElementsCollection

For example: $$(".error").shouldBe(empty)

Overrides:

shouldBe in class BaseElementsCollection<SelenideElement,ElementsCollection>

shouldBe

@CanIgnoreReturnValue
public SelenideAppiumCollection shouldBe(WebElementsCondition condition,
 Duration timeout)

Overrides:

shouldBe in class BaseElementsCollection<SelenideElement,ElementsCollection>

shouldHave

@CanIgnoreReturnValue
public SelenideAppiumCollection shouldHave(WebElementsCondition... conditions)

Description copied from class: BaseElementsCollection

For example: $$(".error").shouldHave(size(3)) $$(".error").shouldHave(texts("Error1", "Error2"))

Overrides:

shouldHave in class BaseElementsCollection<SelenideElement,ElementsCollection>

shouldHave

@CanIgnoreReturnValue
public SelenideAppiumCollection shouldHave(WebElementsCondition condition,
 Duration timeout)

Description copied from class: BaseElementsCollection

Check if a collection matches given condition within given period

Overrides:

shouldHave in class BaseElementsCollection<SelenideElement,ElementsCollection>

timeout - maximum waiting time

filter

public SelenideAppiumCollection filter(WebElementCondition condition)

Description copied from class: BaseElementsCollection

Filters collection elements based on the given condition (lazy evaluation)

Overrides:

filter in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

condition - condition

Returns:

ElementsCollection

See Also:

• Lazy loading

filterBy

public SelenideAppiumCollection filterBy(WebElementCondition condition)

Description copied from class: BaseElementsCollection

Filters collection elements based on the given condition (lazy evaluation)

Overrides:

filterBy in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

condition - condition

Returns:

ElementsCollection

See Also:

• BaseElementsCollection.filter(WebElementCondition)
• Lazy loading

exclude

public SelenideAppiumCollection exclude(WebElementCondition condition)

Description copied from class: BaseElementsCollection

Filters elements excluding those which met the given condition (lazy evaluation)

Overrides:

exclude in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

condition - condition

Returns:

ElementsCollection

See Also:

• Lazy loading

excludeWith

public SelenideAppiumCollection excludeWith(WebElementCondition condition)

Description copied from class: BaseElementsCollection

Filters elements excluding those which met the given condition (lazy evaluation)

Overrides:

excludeWith in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

condition - condition

Returns:

ElementsCollection

See Also:

• BaseElementsCollection.exclude(WebElementCondition)
• Lazy loading

first

public SelenideAppiumCollection first(int elements)

Description copied from class: BaseElementsCollection

returns the first n elements of the collection (lazy evaluation)

Overrides:

first in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

elements - number of elements 1…N

See Also:

• Lazy loading

last

public SelenideAppiumCollection last(int elements)

Description copied from class: BaseElementsCollection

returns the last n elements of the collection (lazy evaluation)

Overrides:

last in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

elements - number of elements 1…N

See Also:

• Lazy loading

snapshot

public SelenideAppiumCollection snapshot()

Description copied from class: BaseElementsCollection

Takes the snapshot of current state of this collection. Succeeding calls to this object WILL NOT RELOAD collection element from browser.

Use it to speed up your tests - but only if you know that collection will not be changed during the test.

Overrides:

snapshot in class BaseElementsCollection<SelenideElement,ElementsCollection>

Returns:

current state of this collection

See Also:

• BaseElementsCollection.asFixedIterable()

as

@CanIgnoreReturnValue
public SelenideAppiumCollection as(String alias)

Description copied from class: BaseElementsCollection

Give this collection a human-readable name

Caution: you probably don't need this method. It's always a good idea to have the actual selector instead of "nice" description (which might be misleading or even lying).

Overrides:

as in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

alias - a human-readable name of this collection (null or empty string not allowed)

Returns:

this collection

get

public SelenideAppiumElement get(int index)

Description copied from class: BaseElementsCollection

Gets the n-th element of collection (lazy evaluation)

Overrides:

get in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

index - 0..N

Returns:

the n-th element of collection

See Also:

• Lazy loading

first

public SelenideAppiumElement first()

Description copied from class: BaseElementsCollection

returns the first element of the collection (lazy evaluation)

NOTICE: Instead of $$(css).first(), prefer $(css) as it's faster and returns the same result

Overrides:

first in class BaseElementsCollection<SelenideElement,ElementsCollection>

Returns:

the first element of the collection

See Also:

• Lazy loading

last

public SelenideAppiumElement last()

Description copied from class: BaseElementsCollection

returns the last element of the collection (lazy evaluation)

Overrides:

last in class BaseElementsCollection<SelenideElement,ElementsCollection>

Returns:

the last element of the collection

See Also:

• Lazy loading

find

public SelenideAppiumElement find(WebElementCondition condition)

Description copied from class: BaseElementsCollection

Find the first element which met the given condition (lazy evaluation)

Overrides:

find in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

condition - condition

Returns:

SelenideElement

See Also:

• Lazy loading

findBy

public SelenideAppiumElement findBy(WebElementCondition condition)

Description copied from class: BaseElementsCollection

Find the first element which met the given condition (lazy evaluation)

Overrides:

findBy in class BaseElementsCollection<SelenideElement,ElementsCollection>

Parameters:

condition - condition

Returns:

SelenideElement

See Also:

• BaseElementsCollection.find(WebElementCondition)
• Lazy loading