io.selendroid.server.model
Class By

java.lang.Object
  io.selendroid.server.model.By

Direct Known Subclasses:

By.ByClass, By.ByCssSelector, By.ById, By.ByLinkText, By.ByName, By.ByPartialLinkText, By.ByTagName, By.ByXPath

public abstract class By
extends Object

Mechanism used to locate elements within a document. In order to create your own locating mechanisms, it is possible to subclass this class and override the protected methods as required, though it is expected that that all subclasses rely on the basic finding mechanisms provided through static methods of this class: public WebElement findElement(WebDriver driver) { WebElement element = driver.findElement(By.id(getSelector())); if (element == null) element = driver.findElement(By.name(getSelector()); return element; }

Nested Class Summary

static class	By.ByClass
static class	By.ByCssSelector
static class	By.ById
static class	By.ByLinkText
static class	By.ByName
static class	By.ByPartialLinkText
static class	By.ByTagName
static class	By.ByXPath

Constructor Summary

By()

Method Summary

static By	className(String className)
static By	cssSelector(String css)
boolean	equals(Object o)
abstract AndroidElement	findElement(SearchContext context) Find a single element.
abstract List<AndroidElement>	findElements(SearchContext context) Find many elements.
abstract String	getElementLocator()
int	hashCode()
static By	id(String id)
static By	linkText(String text)
static By	name(String name)
static By	partialLinkText(String text)
static By	tagName(String tagName)
String	toString()
static By	xpath(String xpathExpression)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

By

public By()

Method Detail

cssSelector

public static By cssSelector(String css)

id

public static By id(String id)

Parameters:

id - The value of the "id" attribute to search for

Returns:

a By which locates elements by the value of the "id" attribute.

tagName

public static By tagName(String tagName)

linkText

public static By linkText(String text)

partialLinkText

public static By partialLinkText(String text)

name

public static By name(String name)

xpath

public static By xpath(String xpathExpression)

className

public static By className(String className)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

findElement

public abstract AndroidElement findElement(SearchContext context)

Find a single element. Override this method if necessary.

Parameters:

context - A context to use to find the element

Returns:

The AndroidElement that matches the selector

findElements

public abstract List<AndroidElement> findElements(SearchContext context)

Find many elements.

Parameters:

context - A context to use to find the element

Returns:

A list of AndroidElement matching the selector

getElementLocator

public abstract String getElementLocator()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object