io.appium.java_client.android

Class AndroidElement

java.lang.Object

org.openqa.selenium.remote.RemoteWebElement

io.appium.java_client.MobileElement

io.appium.java_client.android.AndroidElement

All Implemented Interfaces:

FindsByAccessibilityId<MobileElement>, FindsByAndroidUIAutomator<MobileElement>, TouchableElement<MobileElement>, FindsByClassName, FindsByCssSelector, FindsById, FindsByLinkText, FindsByName, FindsByTagName, FindsByXPath, org.openqa.selenium.internal.HasIdentity, org.openqa.selenium.internal.Locatable, org.openqa.selenium.internal.WrapsDriver, SearchContext, org.openqa.selenium.TakesScreenshot, WebElement

public class AndroidElement
extends MobileElement
implements FindsByAndroidUIAutomator<MobileElement>

Field Summary

Fields inherited from class io.appium.java_client.MobileElement

fileDetector

Fields inherited from class org.openqa.selenium.remote.RemoteWebElement

id, mouse, parent

Constructor Summary

Constructors

Constructor and Description
AndroidElement()

Method Summary

Methods

Modifier and Type	Method and Description
org.openqa.selenium.remote.Response	execute(String driverCommand, Map<String,?> parameters)
T	findElement(org.openqa.selenium.By by) Find the first WebElement using the given method.
T	findElement(String by, String using)
T	findElementByAccessibilityId(String using)
MobileElement	findElementByAndroidUIAutomator(String using)
T	findElementByClassName(String using)
T	findElementByCssSelector(String using)
T	findElementById(String id)
T	findElementByLinkText(String using)
T	findElementByName(String using)
T	findElementByPartialLinkText(String using)
T	findElementByTagName(String using)
T	findElementByXPath(String using)
List<MobileElement>	findElementsByAndroidUIAutomator(String using)
String	getCssValue(String propertyName) Get the value of a given CSS property.
void	replaceValue(String value) This method replace current text value.
void	submit() If this current element is a form, or an element within a form, then this will be submitted to the remote server.

Methods inherited from class io.appium.java_client.MobileElement

findElements, findElements, findElementsByAccessibilityId, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByName, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, getCenter, pinch, setValue, swipe, swipe, tap, zoom

Methods inherited from class org.openqa.selenium.remote.RemoteWebElement

clear, click, equals, getAttribute, getCoordinates, getId, getLocation, getRect, getScreenshotAs, getSize, getTagName, getText, getWrappedDriver, hashCode, isDisplayed, isEnabled, isSelected, sendKeys, setFileDetector, setFoundBy, setId, setParent, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openqa.selenium.WebElement

clear, click, getAttribute, getLocation, getRect, getSize, getTagName, getText, isDisplayed, isEnabled, isSelected, sendKeys

Methods inherited from interface org.openqa.selenium.TakesScreenshot

getScreenshotAs

Constructor Detail

AndroidElement

public AndroidElement()

Method Detail

findElementByAndroidUIAutomator

public MobileElement findElementByAndroidUIAutomator(String using)
                                              throws org.openqa.selenium.WebDriverException

Specified by:

findElementByAndroidUIAutomator in interface FindsByAndroidUIAutomator<MobileElement>

Throws:

org.openqa.selenium.WebDriverException - This method is not applicable with browser/webview UI.

findElementsByAndroidUIAutomator

public List<MobileElement> findElementsByAndroidUIAutomator(String using)
                                                     throws org.openqa.selenium.WebDriverException

Specified by:

findElementsByAndroidUIAutomator in interface FindsByAndroidUIAutomator<MobileElement>

Throws:

org.openqa.selenium.WebDriverException - This method is not applicable with browser/webview UI.

replaceValue

public void replaceValue(String value)

This method replace current text value.

Parameters:

value - a new value

execute

public org.openqa.selenium.remote.Response execute(String driverCommand,
                                          Map<String,?> parameters)

Overrides:

execute in class org.openqa.selenium.remote.RemoteWebElement

findElement

public T findElement(org.openqa.selenium.By by)

Description copied from interface: WebElement

Find the first WebElement using the given method. See the note in WebElement.findElements(By) about finding via XPath. This method is affected by the 'implicit wait' times in force at the time of execution. The findElement(..) invocation will return a matching row, or try again repeatedly until the configured timeout is reached.

findElement should not be used to look for non-present elements, use WebElement.findElements(By) and assert zero length response instead.

Specified by:

findElement in interface TouchableElement<T extends WebElement>

Specified by:

findElement in interface SearchContext

Specified by:

findElement in interface WebElement

Overrides:

findElement in class org.openqa.selenium.remote.RemoteWebElement

Parameters:

by - The locating mechanism

Returns:

The first matching element on the current context.

See Also:

By, WebDriver.Timeouts

findElement

public T findElement(String by,
            String using)

Overrides:

findElement in class org.openqa.selenium.remote.RemoteWebElement

findElementById

public T findElementById(String id)

Specified by:

findElementById in interface TouchableElement<T extends WebElement>

Specified by:

findElementById in interface FindsById

Overrides:

findElementById in class org.openqa.selenium.remote.RemoteWebElement

findElementByLinkText

public T findElementByLinkText(String using)
                                           throws org.openqa.selenium.WebDriverException

Specified by:

findElementByLinkText in interface TouchableElement<T extends WebElement>

Specified by:

findElementByLinkText in interface FindsByLinkText

Overrides:

findElementByLinkText in class org.openqa.selenium.remote.RemoteWebElement

Throws:

org.openqa.selenium.WebDriverException - his method doesn't work against native app UI.

findElementByPartialLinkText

public T findElementByPartialLinkText(String using)
                                                  throws org.openqa.selenium.WebDriverException

Specified by:

findElementByPartialLinkText in interface TouchableElement<T extends WebElement>

Specified by:

findElementByPartialLinkText in interface FindsByLinkText

Overrides:

findElementByPartialLinkText in class org.openqa.selenium.remote.RemoteWebElement

Throws:

org.openqa.selenium.WebDriverException - his method doesn't work against native app UI.

findElementByTagName

public T findElementByTagName(String using)

Specified by:

findElementByTagName in interface TouchableElement<T extends WebElement>

Specified by:

findElementByTagName in interface FindsByTagName

Overrides:

findElementByTagName in class org.openqa.selenium.remote.RemoteWebElement

findElementByName

public T findElementByName(String using)

Specified by:

findElementByName in interface TouchableElement<T extends WebElement>

Specified by:

findElementByName in interface FindsByName

Overrides:

findElementByName in class org.openqa.selenium.remote.RemoteWebElement

findElementByClassName

public T findElementByClassName(String using)

Specified by:

findElementByClassName in interface TouchableElement<T extends WebElement>

Specified by:

findElementByClassName in interface FindsByClassName

Overrides:

findElementByClassName in class org.openqa.selenium.remote.RemoteWebElement

findElementByCssSelector

public T findElementByCssSelector(String using)
                                              throws org.openqa.selenium.WebDriverException

Specified by:

findElementByCssSelector in interface TouchableElement<T extends WebElement>

Specified by:

findElementByCssSelector in interface FindsByCssSelector

Overrides:

findElementByCssSelector in class org.openqa.selenium.remote.RemoteWebElement

Throws:

org.openqa.selenium.WebDriverException - his method doesn't work against native app UI.

findElementByXPath

public T findElementByXPath(String using)

Specified by:

findElementByXPath in interface TouchableElement<T extends WebElement>

Specified by:

findElementByXPath in interface FindsByXPath

Overrides:

findElementByXPath in class org.openqa.selenium.remote.RemoteWebElement

findElementByAccessibilityId

public T findElementByAccessibilityId(String using)

Specified by:

findElementByAccessibilityId in interface FindsByAccessibilityId<T extends WebElement>

submit

public void submit()
            throws org.openqa.selenium.WebDriverException

Description copied from interface: WebElement

If this current element is a form, or an element within a form, then this will be submitted to the remote server. If this causes the current page to change, then this method will block until the new page is loaded.

Specified by:

submit in interface WebElement

Overrides:

submit in class org.openqa.selenium.remote.RemoteWebElement

Throws:

org.openqa.selenium.WebDriverException - because it may not work against native app UI.

getCssValue

public String getCssValue(String propertyName)
                   throws org.openqa.selenium.WebDriverException

Description copied from interface: WebElement

Get the value of a given CSS property. Color values should be returned as rgba strings, so, for example if the "background-color" property is set as "green" in the HTML source, the returned value will be "rgba(0, 255, 0, 1)".

Note that shorthand CSS properties (e.g. background, font, border, border-top, margin, margin-top, padding, padding-top, list-style, outline, pause, cue) are not returned, in accordance with the DOM CSS2 specification - you should directly access the longhand properties (e.g. background-color) to access the desired values.

Specified by:

getCssValue in interface WebElement

Overrides:

getCssValue in class org.openqa.selenium.remote.RemoteWebElement

Parameters:

propertyName - the css property name of the element

Returns:

The current, computed value of the property.

Throws:

org.openqa.selenium.WebDriverException - because it may not work against native app UI.