io.appium.droiddriver.finders

Class ChainFinder

java.lang.Object

io.appium.droiddriver.finders.ChainFinder

All Implemented Interfaces:

Finder

public class ChainFinder
extends java.lang.Object
implements Finder

Finds UiElement by applying Finders in turn: using the UiElement returned by first Finder as context for the second Finder. It is conceptually similar to Function composition. The returned UiElement can be thought of as the result of second(first(context)).

Note typically first Finder finds the ancestor, then second Finder finds the target UiElement, which is a descendant. ChainFinder can be chained with additional Finders to make a "chain".

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ChainFinder(Finder first, Finder second)

Method Summary

Modifier and Type	Method and Description
UiElement	find(UiElement context) Returns the matching UiElement.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ChainFinder

protected ChainFinder(Finder first,
                      Finder second)

Method Detail

toString

public java.lang.String toString()

Description copied from interface: Finder

It is recommended that this method return the description of the finder, for example, "{text=OK}".

Specified by:

toString in interface Finder

Overrides:

toString in class java.lang.Object

find

public UiElement find(UiElement context)

Description copied from interface: Finder

Returns the matching UiElement. The implementing finder should not poll.

Invisible UiElements are skipped.

Specified by:

find in interface Finder

Parameters:

context - The starting UiElement, used as search context

Returns:

The first matching element on the current context