io.appium.java_client.ios

Class IOSDriver<T extends WebElement>

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

io.appium.java_client.AppiumDriver<T>

io.appium.java_client.ios.IOSDriver<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 IOSElement

All Implemented Interfaces:

DeviceActionShortcuts, FindsByAccessibilityId<T>, FindsByIosUIAutomation<T>, HasAppStrings, InteractsWithApps, InteractsWithFiles, IOSDeviceActionShortcuts, 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

public class IOSDriver<T extends WebElement>
extends AppiumDriver<T>
implements IOSDeviceActionShortcuts, FindsByIosUIAutomation<T>

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

Constructor and Description
IOSDriver(AppiumDriverLocalService service, org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(AppiumDriverLocalService service, org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(AppiumServiceBuilder builder, org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(AppiumServiceBuilder builder, org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(org.openqa.selenium.remote.HttpCommandExecutor executor, org.openqa.selenium.Capabilities capabilities)
IOSDriver(URL remoteAddress, org.openqa.selenium.Capabilities desiredCapabilities)
IOSDriver(URL remoteAddress, org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory, org.openqa.selenium.Capabilities desiredCapabilities)

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)
T	findElementByClassName(String using)
T	findElementByCssSelector(String using)
T	findElementById(String id)
T	findElementByIosUIAutomation(String using)
T	findElementByLinkText(String using)
T	findElementByName(String using)
T	findElementByPartialLinkText(String using)
T	findElementByTagName(String using)
T	findElementByXPath(String using)
List<T>	findElementsByIosUIAutomation(String using)
org.openqa.selenium.interactions.Mouse	getMouse() Deprecated.
void	hideKeyboard(String keyName) Hides the keyboard by pressing the button specified by keyName if it is showing.
void	hideKeyboard(String strategy, String keyName) Hides the keyboard if it is showing.
void	lockDevice(int seconds) Lock the device (bring it to the lock screen) for a given number of seconds.
void	shake() Simulate shaking the device.
void	swipe(int startx, int starty, int endx, int endy, int duration) Convenience method for swiping across the screen.

Methods inherited from class io.appium.java_client.AppiumDriver

closeApp, context, doSwipe, execute, findElements, findElements, findElementsByAccessibilityId, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByName, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, getAppStringMap, getAppStringMap, getAppStringMap, getContext, getContextHandles, getDeviceTime, getExecuteMethod, getOrientation, getRemoteAddress, getSessionDetails, getSettings, hideKeyboard, installApp, isAppInstalled, launchApp, location, performMultiTouchAction, performTouchAction, pinch, pinch, pullFile, pullFolder, removeApp, resetApp, rotate, runAppInBackground, setLocation, setSetting, substituteMobilePlatform, tap, tap, zoom, zoom

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 io.appium.java_client.DeviceActionShortcuts

getDeviceTime, hideKeyboard

Methods inherited from interface org.openqa.selenium.WebDriver

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

Constructor Detail

IOSDriver

public IOSDriver(org.openqa.selenium.remote.HttpCommandExecutor executor,
         org.openqa.selenium.Capabilities capabilities)

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

IOSDriver

public IOSDriver(URL remoteAddress,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

remoteAddress - is the address of remotely/locally started Appium server

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(URL remoteAddress,
         org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

remoteAddress - is the address of remotely/locally started Appium server

httpClientFactory - take a look at HttpClient.Factory

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(AppiumDriverLocalService service,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

service - take a look at AppiumDriverLocalService

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(AppiumDriverLocalService service,
         org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

service - take a look at AppiumDriverLocalService

httpClientFactory - take a look at HttpClient.Factory

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(AppiumServiceBuilder builder,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

builder - take a look at AppiumServiceBuilder

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(AppiumServiceBuilder builder,
         org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

builder - take a look at AppiumServiceBuilder

httpClientFactory - take a look at HttpClient.Factory

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(org.openqa.selenium.remote.http.HttpClient.Factory httpClientFactory,
         org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

httpClientFactory - take a look at HttpClient.Factory

desiredCapabilities - take a look at Capabilities

IOSDriver

public IOSDriver(org.openqa.selenium.Capabilities desiredCapabilities)

Parameters:

desiredCapabilities - take a look at Capabilities

Method Detail

swipe

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

Description copied from interface: TouchShortcuts

Convenience method for swiping across the screen.

Specified by:

swipe in interface TouchShortcuts

Specified by:

swipe in class AppiumDriver<T extends WebElement>

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).

hideKeyboard

public void hideKeyboard(String strategy,
                String keyName)

Description copied from interface: IOSDeviceActionShortcuts

Hides the keyboard if it is showing. Available strategies are PRESS_KEY and TAP_OUTSIDE. One taps outside the keyboard, the other presses a key of your choosing (probably the 'Done' key). Hiding the keyboard often depends on the way an app is implemented, no single strategy always works.

Specified by:

hideKeyboard in interface IOSDeviceActionShortcuts

Parameters:

strategy - HideKeyboardStrategy.

keyName - a String, representing the text displayed on the button of the keyboard you want to press. For example: "Done".

See Also:

IOSDeviceActionShortcuts.hideKeyboard(String, String).

hideKeyboard

public void hideKeyboard(String keyName)

Description copied from interface: IOSDeviceActionShortcuts

Hides the keyboard by pressing the button specified by keyName if it is showing.

Specified by:

hideKeyboard in interface IOSDeviceActionShortcuts

Parameters:

keyName - The button pressed by the mobile driver to attempt hiding the keyboard.

See Also:

IOSDeviceActionShortcuts.hideKeyboard(String).

shake

public void shake()

Description copied from interface: IOSDeviceActionShortcuts

Simulate shaking the device.

Specified by:

shake in interface IOSDeviceActionShortcuts

See Also:

IOSDeviceActionShortcuts.shake().

findElementByIosUIAutomation

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

Specified by:

findElementByIosUIAutomation in interface FindsByIosUIAutomation<T extends WebElement>

Throws:

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

findElementsByIosUIAutomation

public List<T> findElementsByIosUIAutomation(String using)
                                                         throws org.openqa.selenium.WebDriverException

Specified by:

findElementsByIosUIAutomation in interface FindsByIosUIAutomation<T extends WebElement>

Throws:

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

lockDevice

public void lockDevice(int seconds)

Lock the device (bring it to the lock screen) for a given number of seconds.

Parameters:

seconds - number of seconds to lock the screen for

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