io.appium.java_client

Class AppiumDriver<T extends WebElement>

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

io.appium.java_client.AppiumDriver<T>

Type Parameters:

T - the required type of class which implement WebElement. Instances of the defined type will be returned via findElement* and findElements* Warning (!!!). Allowed types: WebElement TouchableElement RemoteWebElement MobileElement and its subclasses that designed specifically for each target mobile OS (still Android and iOS)

All Implemented Interfaces:

DeviceActionShortcuts, FindsByAccessibilityId<T>, HasAppStrings, InteractsWithApps, InteractsWithFiles, MobileDriver<T>, PerformsTouchActions, TouchShortcuts, org.openqa.selenium.ContextAware, org.openqa.selenium.HasCapabilities, org.openqa.selenium.html5.LocationContext, org.openqa.selenium.interactions.HasInputDevices, FindsByClassName, FindsByCssSelector, FindsById, FindsByLinkText, FindsByName, FindsByTagName, FindsByXPath, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.Rotatable, SearchContext, org.openqa.selenium.TakesScreenshot, WebDriver

Direct Known Subclasses:

AndroidDriver, IOSDriver, YouiEngineDriver

public abstract class AppiumDriver<T extends WebElement>
extends org.openqa.selenium.remote.RemoteWebDriver

Nested Class Summary

Nested classes/interfaces inherited from class org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.remote.RemoteWebDriver.RemoteTargetLocator, org.openqa.selenium.remote.RemoteWebDriver.RemoteWebDriverOptions, org.openqa.selenium.remote.RemoteWebDriver.When

Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver

WebDriver.ImeHandler, WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts, WebDriver.Window

Constructor Summary

Constructors

Modifier	Constructor and Description
	AppiumDriver(AppiumDriverLocalService service, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(AppiumDriverLocalService service, org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(AppiumServiceBuilder builder, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(AppiumServiceBuilder builder, org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
protected	AppiumDriver(org.openqa.selenium.remote.HttpCommandExecutor executor, org.openqa.selenium.Capabilities capabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(URL remoteAddress, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)
	AppiumDriver(URL remoteAddress, org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities, Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

Method Summary

Methods

Modifier and Type	Method and Description
void	closeApp() Close the app which was provided in the capabilities at session creation.
WebDriver	context(String name)
protected void	doSwipe(int startx, int starty, int endx, int endy, int duration)
protected org.openqa.selenium.remote.Response	execute(String command)
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)
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<T>	findElements(org.openqa.selenium.By by) Find all elements within the current page using the given mechanism.
List<T>	findElements(String by, String using)
List<T>	findElementsByAccessibilityId(String using)
List<T>	findElementsByClassName(String using)
List<T>	findElementsByCssSelector(String using)
List<T>	findElementsById(String id)
List<T>	findElementsByLinkText(String using)
List<T>	findElementsByName(String using)
List<T>	findElementsByPartialLinkText(String using)
List<T>	findElementsByTagName(String using)
List<T>	findElementsByXPath(String using)
Map<String,String>	getAppStringMap() Get all defined Strings from an app for the default language.
Map<String,String>	getAppStringMap(String language) Get all defined Strings from an app for the specified language.
Map<String,String>	getAppStringMap(String language, String stringFile) Get all defined Strings from an app for the specified language and strings filename.
String	getContext()
Set<String>	getContextHandles()
String	getDeviceTime()
org.openqa.selenium.remote.ExecuteMethod	getExecuteMethod()
org.openqa.selenium.interactions.Mouse	getMouse() Deprecated.
org.openqa.selenium.ScreenOrientation	getOrientation()
URL	getRemoteAddress()
Map<String,Object>	getSessionDetails()
com.google.gson.JsonObject	getSettings() Get settings stored for this test session It's probably better to use a convenience function, rather than use this function directly.
void	hideKeyboard() Hides the keyboard if it is showing.
void	installApp(String appPath) Install an app on the mobile device.
boolean	isAppInstalled(String bundleId) Checks if an app is installed on the device.
void	launchApp() Launch the app which was provided in the capabilities at session creation.
org.openqa.selenium.html5.Location	location()
void	performMultiTouchAction(MultiTouchAction multiAction) Performs multiple TouchAction gestures at the same time, to simulate multiple fingers/touch inputs.
TouchAction	performTouchAction(TouchAction touchAction) Performs a chain of touch actions, which together can be considered an entire gesture.
void	pinch(int x, int y) Convenience method for pinching an element on the screen.
void	pinch(WebElement el) Convenience method for pinching an element on the screen.
byte[]	pullFile(String remotePath)
byte[]	pullFolder(String remotePath) Pull a folder from the simulator/device.
void	removeApp(String bundleId) Remove the specified app from the device (uninstall).
void	resetApp() Reset the currently running app for this session.
void	rotate(org.openqa.selenium.ScreenOrientation orientation)
void	runAppInBackground(int seconds) Runs the current app as a background app for the number of seconds requested.
void	setLocation(org.openqa.selenium.html5.Location location)
protected void	setSetting(AppiumSetting setting, Object value) Set a setting for this test session It's probably better to use a convenience function, rather than use this function directly.
protected static org.openqa.selenium.Capabilities	substituteMobilePlatform(org.openqa.selenium.Capabilities originalCapabilities, String newPlatform)
abstract void	swipe(int startx, int starty, int endx, int endy, int duration) Convenience method for swiping across the screen.
void	tap(int fingers, int x, int y, int duration) Convenience method for tapping a position on the screen.
void	tap(int fingers, WebElement element, int duration) Convenience method for tapping the center of an element on the screen.
void	zoom(int x, int y) Convenience method for "zooming in" on an element on the screen.
void	zoom(WebElement el) Convenience method for "zooming in" on an element on the screen.

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

close, executeAsyncScript, executeScript, get, getCapabilities, getCommandExecutor, getCurrentUrl, getElementConverter, getErrorHandler, getFileDetector, getKeyboard, getPageSource, getScreenshotAs, getSessionId, getTitle, getW3CStandardComplianceLevel, getWindowHandle, getWindowHandles, log, manage, navigate, quit, setCommandExecutor, setElementConverter, setErrorHandler, setFileDetector, setFoundBy, setLogLevel, setSessionId, startClient, startSession, startSession, stopClient, switchTo, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openqa.selenium.WebDriver

close, get, getCurrentUrl, getPageSource, getTitle, getWindowHandle, getWindowHandles, manage, navigate, quit, switchTo

Constructor Detail

AppiumDriver

protected AppiumDriver(org.openqa.selenium.remote.HttpCommandExecutor executor,
            org.openqa.selenium.Capabilities capabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

Parameters:

executor - is an instance of HttpCommandExecutor or class that extends it. Default commands or another vendor-specific commands may be specified there.

capabilities - take a look at Capabilities

converterClazz - is an instance of a class that extends JsonToWebElementConverter. It converts JSON response to an instance of WebElement

AppiumDriver

public AppiumDriver(URL remoteAddress,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(URL remoteAddress,
            org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(AppiumDriverLocalService service,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(AppiumDriverLocalService service,
            org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(AppiumServiceBuilder builder,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(AppiumServiceBuilder builder,
            org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
            org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

AppiumDriver

public AppiumDriver(org.openqa.selenium.Capabilities desiredCapabilities,
            Class<? extends org.openqa.selenium.remote.internal.JsonToWebElementConverter> converterClazz)

Method Detail

substituteMobilePlatform

protected static org.openqa.selenium.Capabilities substituteMobilePlatform(org.openqa.selenium.Capabilities originalCapabilities,
                                                        String newPlatform)

Parameters:

originalCapabilities - the given Capabilities.

newPlatform - a MobileCapabilityType.PLATFORM_NAME value which has to be set up

Returns:

Capabilities with changed mobile platform value

findElements

public List<T> findElements(org.openqa.selenium.By by)

Description copied from interface: WebDriver

Find all elements within the current page using the given mechanism. This method is affected by the 'implicit wait' times in force at the time of execution. When implicitly waiting, this method will return as soon as there are more than 0 items in the found collection, or will return an empty list if the timeout is reached.

Specified by:

findElements in interface MobileDriver<T extends WebElement>

Specified by:

findElements in interface SearchContext

Specified by:

findElements in interface WebDriver

Parameters:

by - The locating mechanism to use

Returns:

A list of all WebElements, or an empty list if nothing matches

See Also:

By, WebDriver.Timeouts

findElements

public List<T> findElements(String by,
                   String using)

findElementsById

public List<T> findElementsById(String id)

Specified by:

findElementsById in interface MobileDriver<T extends WebElement>

Specified by:

findElementsById in interface FindsById

findElementsByLinkText

public List<T> findElementsByLinkText(String using)

Specified by:

findElementsByLinkText in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByLinkText in interface FindsByLinkText

findElementsByPartialLinkText

public List<T> findElementsByPartialLinkText(String using)

Specified by:

findElementsByPartialLinkText in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByPartialLinkText in interface FindsByLinkText

findElementsByTagName

public List<T> findElementsByTagName(String using)

Specified by:

findElementsByTagName in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByTagName in interface FindsByTagName

findElementsByName

public List<T> findElementsByName(String using)

Specified by:

findElementsByName in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByName in interface FindsByName

findElementsByClassName

public List<T> findElementsByClassName(String using)

Specified by:

findElementsByClassName in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByClassName in interface FindsByClassName

findElementsByCssSelector

public List<T> findElementsByCssSelector(String using)

Specified by:

findElementsByCssSelector in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByCssSelector in interface FindsByCssSelector

findElementsByXPath

public List<T> findElementsByXPath(String using)

Specified by:

findElementsByXPath in interface MobileDriver<T extends WebElement>

Specified by:

findElementsByXPath in interface FindsByXPath

findElementsByAccessibilityId

public List<T> findElementsByAccessibilityId(String using)

Specified by:

findElementsByAccessibilityId in interface FindsByAccessibilityId<T extends WebElement>

execute

protected org.openqa.selenium.remote.Response execute(String command)

Overrides:

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

getExecuteMethod

public org.openqa.selenium.remote.ExecuteMethod getExecuteMethod()

Overrides:

getExecuteMethod in class org.openqa.selenium.remote.RemoteWebDriver

resetApp

public void resetApp()

Description copied from interface: InteractsWithApps

Reset the currently running app for this session.

See Also:

InteractsWithApps.resetApp().

isAppInstalled

public boolean isAppInstalled(String bundleId)

Description copied from interface: InteractsWithApps

Checks if an app is installed on the device.

Parameters:

bundleId - bundleId of the app.

Returns:

True if app is installed, false otherwise.

See Also:

InteractsWithApps.isAppInstalled(String).

installApp

public void installApp(String appPath)

Description copied from interface: InteractsWithApps

Install an app on the mobile device.

Parameters:

appPath - path to app to install.

See Also:

InteractsWithApps.installApp(String).

removeApp

public void removeApp(String bundleId)

Description copied from interface: InteractsWithApps

Remove the specified app from the device (uninstall).

Parameters:

bundleId - the bunble identifier (or app id) of the app to remove.

See Also:

InteractsWithApps.removeApp(String).

launchApp

public void launchApp()

Description copied from interface: InteractsWithApps

Launch the app which was provided in the capabilities at session creation.

See Also:

InteractsWithApps.launchApp().

closeApp

public void closeApp()

Description copied from interface: InteractsWithApps

Close the app which was provided in the capabilities at session creation.

See Also:

InteractsWithApps.closeApp().

runAppInBackground

public void runAppInBackground(int seconds)

Description copied from interface: InteractsWithApps

Runs the current app as a background app for the number of seconds requested. This is a synchronous method, it returns after the back has been returned to the foreground.

Parameters:

seconds - Number of seconds to run App in background.

See Also:

InteractsWithApps.runAppInBackground(int).

getDeviceTime

public String getDeviceTime()

See Also:

DeviceActionShortcuts.getDeviceTime().

hideKeyboard

public void hideKeyboard()

Description copied from interface: DeviceActionShortcuts

Hides the keyboard if it is showing. On iOS, there are multiple strategies for hiding the keyboard. Defaults to the "tapOutside" strategy (taps outside the keyboard). Switch to using hideKeyboard(HideKeyboardStrategy.PRESS_KEY, "Done") if this doesn't work.

See Also:

DeviceActionShortcuts.hideKeyboard().

pullFile

public byte[] pullFile(String remotePath)

Parameters:

remotePath - On Android and iOS, this is either the path to the file (relative to the root of the app's file system). On iOS only, if path starts with /AppName.app, which will be replaced with the application's .app directory

Returns:

A byte array of Base64 encoded data.

See Also:

InteractsWithFiles.pullFile(String).

pullFolder

public byte[] pullFolder(String remotePath)

Description copied from interface: InteractsWithFiles

Pull a folder from the simulator/device. Does not work on iOS Real Devices, but works on simulators

Parameters:

remotePath - On Android and iOS, this is either the path to the file (relative to the root of the app's file system). On iOS only, if path starts with /AppName.app, which will be replaced with the application's .app directory

Returns:

A byte array of Base64 encoded data, representing a ZIP ARCHIVE of the contents of the requested folder.

See Also:

InteractsWithFiles.pullFolder(String).

performTouchAction

public TouchAction performTouchAction(TouchAction touchAction)

Description copied from interface: PerformsTouchActions

Performs a chain of touch actions, which together can be considered an entire gesture. See the Webriver 3 spec https://dvcs.w3.org/hg/webdriver/raw-file/default/webdriver-spec.html It's more convenient to call the perform() method of the TouchAction object itself.

Parameters:

touchAction - A TouchAction object, which contains a list of individual touch actions to perform

Returns:

the same touch action object

See Also:

PerformsTouchActions.performTouchAction(TouchAction).

performMultiTouchAction

public void performMultiTouchAction(MultiTouchAction multiAction)

Description copied from interface: PerformsTouchActions

Performs multiple TouchAction gestures at the same time, to simulate multiple fingers/touch inputs. See the Webriver 3 spec https://dvcs.w3.org/hg/webdriver/raw-file/default/webdriver-spec.html It's more convenient to call the perform() method of the MultiTouchAction object.

Parameters:

multiAction - the MultiTouchAction object to perform.

See Also:

PerformsTouchActions.performMultiTouchAction(MultiTouchAction).

tap

public void tap(int fingers,
       WebElement element,
       int duration)

Description copied from interface: TouchShortcuts

Convenience method for tapping the center of an element on the screen.

Parameters:

fingers - number of fingers/appendages to tap with.

element - element to tap.

duration - how long between pressing down, and lifting fingers/appendages.

See Also:

TouchShortcuts.tap(int, WebElement, int).

tap

public void tap(int fingers,
       int x,
       int y,
       int duration)

Description copied from interface: TouchShortcuts

Convenience method for tapping a position on the screen.

Parameters:

fingers - number of fingers/appendages to tap with.

x - x coordinate.

y - y coordinate.

duration - how long between pressing down, and lifting fingers/appendages.

See Also:

TouchShortcuts.tap(int, int, int, int).

doSwipe

protected void doSwipe(int startx,
           int starty,
           int endx,
           int endy,
           int duration)

swipe

public abstract void swipe(int startx,
         int starty,
         int endx,
         int endy,
         int duration)

Description copied from interface: TouchShortcuts

Convenience method for swiping across the screen.

Parameters:

startx - starting x coordinate.

starty - starting y coordinate.

endx - ending x coordinate.

endy - ending y coordinate.

duration - amount of time in milliseconds for the entire swipe action to take

See Also:

TouchShortcuts.swipe(int, int, int, int, int).

pinch

public void pinch(WebElement el)

Convenience method for pinching an element on the screen. "pinching" refers to the action of two appendages pressing the screen and sliding towards each other. NOTE: This convenience method places the initial touches around the element, if this would happen to place one of them off the screen, appium with return an outOfBounds error. In this case, revert to using the MultiTouchAction api instead of this method.

Parameters:

el - The element to pinch.

pinch

public void pinch(int x,
         int y)

Convenience method for pinching an element on the screen. "pinching" refers to the action of two appendages pressing the screen and sliding towards each other. NOTE: This convenience method places the initial touches around the element at a distance, if this would happen to place one of them off the screen, appium will return an outOfBounds error. In this case, revert to using the MultiTouchAction api instead of this method.

Parameters:

x - x coordinate to terminate the pinch on.

y - y coordinate to terminate the pinch on.

zoom

public void zoom(WebElement el)

Convenience method for "zooming in" on an element on the screen. "zooming in" refers to the action of two appendages pressing the screen and sliding away from each other. NOTE: This convenience method slides touches away from the element, if this would happen to place one of them off the screen, appium will return an outOfBounds error. In this case, revert to using the MultiTouchAction api instead of this method.

Parameters:

el - The element to pinch.

zoom

public void zoom(int x,
        int y)

Convenience method for "zooming in" on an element on the screen. "zooming in" refers to the action of two appendages pressing the screen and sliding away from each other. NOTE: This convenience method slides touches away from the element, if this would happen to place one of them off the screen, appium will return an outOfBounds error. In this case, revert to using the MultiTouchAction api instead of this method.

Parameters:

x - x coordinate to start zoom on.

y - y coordinate to start zoom on.

getSettings

public com.google.gson.JsonObject getSettings()

Get settings stored for this test session It's probably better to use a convenience function, rather than use this function directly. Try finding the method for the specific setting you want to read.

Returns:

JsonObject, a straight-up hash of settings.

setSetting

protected void setSetting(AppiumSetting setting,
              Object value)

Set a setting for this test session It's probably better to use a convenience function, rather than use this function directly. Try finding the method for the specific setting you want to change.

Parameters:

setting - AppiumSetting you wish to set.

value - value of the setting.

context

public WebDriver context(String name)

getContextHandles

public Set<String> getContextHandles()

getContext

public String getContext()

rotate

public void rotate(org.openqa.selenium.ScreenOrientation orientation)

getOrientation

public org.openqa.selenium.ScreenOrientation getOrientation()

location

public org.openqa.selenium.html5.Location location()

setLocation

public void setLocation(org.openqa.selenium.html5.Location location)

getAppStringMap

public Map<String,String> getAppStringMap()

Description copied from interface: HasAppStrings

Get all defined Strings from an app for the default language.

Returns:

a map with localized strings defined in the app.

See Also:

HasAppStrings.getAppStringMap().

getAppStringMap

public Map<String,String> getAppStringMap(String language)

Description copied from interface: HasAppStrings

Get all defined Strings from an app for the specified language.

Parameters:

language - strings language code.

Returns:

a map with localized strings defined in the app.

See Also:

HasAppStrings.getAppStringMap(String).

getAppStringMap

public Map<String,String> getAppStringMap(String language,
                                 String stringFile)

Description copied from interface: HasAppStrings

Get all defined Strings from an app for the specified language and strings filename.

Parameters:

language - strings language code.

stringFile - strings filename.

Returns:

a map with localized strings defined in the app.

See Also:

HasAppStrings.getAppStringMap(String, String).

getRemoteAddress

public URL getRemoteAddress()

getSessionDetails

public Map<String,Object> getSessionDetails()

Returns:

a map with values that hold session details.

execute

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

Specified by:

execute in interface MobileDriver<T extends WebElement>

Overrides:

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

findElement

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

Description copied from interface: WebDriver

Find the first WebElement using the given method. 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 WebDriver.findElements(By) and assert zero length response instead.

Specified by:

findElement in interface MobileDriver<T extends WebElement>

Specified by:

findElement in interface SearchContext

Specified by:

findElement in interface WebDriver

Overrides:

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

Parameters:

by - The locating mechanism

Returns:

The first matching element on the current page

See Also:

By, WebDriver.Timeouts

findElement

public T findElement(String by,
            String using)

Overrides:

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

findElementById

public T findElementById(String id)

Specified by:

findElementById in interface MobileDriver<T extends WebElement>

Specified by:

findElementById in interface FindsById

Overrides:

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

findElementByLinkText

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

Specified by:

findElementByLinkText in interface MobileDriver<T extends WebElement>

Specified by:

findElementByLinkText in interface FindsByLinkText

Overrides:

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

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 MobileDriver<T extends WebElement>

Specified by:

findElementByPartialLinkText in interface FindsByLinkText

Overrides:

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

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 MobileDriver<T extends WebElement>

Specified by:

findElementByTagName in interface FindsByTagName

Overrides:

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

findElementByName

public T findElementByName(String using)

Specified by:

findElementByName in interface MobileDriver<T extends WebElement>

Specified by:

findElementByName in interface FindsByName

Overrides:

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

findElementByClassName

public T findElementByClassName(String using)

Specified by:

findElementByClassName in interface MobileDriver<T extends WebElement>

Specified by:

findElementByClassName in interface FindsByClassName

Overrides:

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

findElementByCssSelector

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

Specified by:

findElementByCssSelector in interface MobileDriver<T extends WebElement>

Specified by:

findElementByCssSelector in interface FindsByCssSelector

Overrides:

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

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 MobileDriver<T extends WebElement>

Specified by:

findElementByXPath in interface FindsByXPath

Overrides:

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

findElementByAccessibilityId

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

Specified by:

findElementByAccessibilityId in interface FindsByAccessibilityId<T extends WebElement>

Throws:

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

getMouse

@Deprecated
public org.openqa.selenium.interactions.Mouse getMouse()

Deprecated.

Mouse doesn't work on mobile devices and emulators.

Specified by:

getMouse in interface org.openqa.selenium.interactions.HasInputDevices

Overrides:

getMouse in class org.openqa.selenium.remote.RemoteWebDriver