org.senchalabs.gwt.gwtdriver.by

Class ByNearestWidget

java.lang.Object

org.openqa.selenium.By

org.senchalabs.gwt.gwtdriver.by.ByNearestWidget

public class ByNearestWidget
extends By

GWT-specific By implementation that looks at the current search context and above for the nearest containing Widget object, and returns the root element of that widget. Always returns one item, even if multiple items are requested by SearchContext.findElements(org.openqa.selenium.By).

To check if the current element is a widget, use ByWidget instead. If searching for a descendent element that is a widget, use another By to find those elements along with a ByWidget to confirm it is a widget.

Nested Class Summary

Nested classes/interfaces inherited from class org.openqa.selenium.By

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

Constructor Summary

Constructors

Constructor and Description
ByNearestWidget(WebDriver driver) Finds the nearest containing widget of any type - anything that extends Widget will be found.
ByNearestWidget(WebDriver driver, Class<? extends com.google.gwt.user.client.ui.Widget> type) Finds the nearest containing widget of the given type.

Method Summary

Methods

Modifier and Type	Method and Description
WebElement	findElement(SearchContext context)
List<WebElement>	findElements(SearchContext context)
String	toString()

Methods inherited from class org.openqa.selenium.By

className, cssSelector, equals, hashCode, id, linkText, name, partialLinkText, tagName, xpath

Methods inherited from class java.lang.Object

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

Constructor Detail

ByNearestWidget

public ByNearestWidget(WebDriver driver)

Finds the nearest containing widget of any type - anything that extends Widget will be found.

Parameters:

driver - The driver to use to communicate with the browser.

ByNearestWidget

public ByNearestWidget(WebDriver driver,
               Class<? extends com.google.gwt.user.client.ui.Widget> type)

Finds the nearest containing widget of the given type. This will find any subtype of that widget, allowing you to pass in ValueBoxBase and find any TextBox, TextArea, IntegerBox, etc, as these are all subclasses of ValueBoxBase. Note that interfaces cannot be used, only base classes, and those classes *must* extend Widget.

Parameters:

driver - the driver to use to communicate with the browser

type - the type of widget to find

Method Detail

findElements

public List<WebElement> findElements(SearchContext context)

Specified by:

findElements in class By

findElement

public WebElement findElement(SearchContext context)

Overrides:

findElement in class By

toString

public String toString()

Overrides:

toString in class By