AndroidWebDriver

java.lang.Object
- org.openqa.selenium.android.library.AndroidWebDriver

All Implemented Interfaces:: android.location.LocationListener, HasTouchScreen, ApplicationCache, BrowserConnection, LocationContext, WebStorage, JavascriptExecutor, Rotatable, SearchContext, TakesScreenshot, WebDriver

public class AndroidWebDriver
extends java.lang.Object
implements WebDriver, SearchContext, JavascriptExecutor, TakesScreenshot, Rotatable, BrowserConnection, HasTouchScreen, WebStorage, LocationContext, android.location.LocationListener, ApplicationCache

Nested Class Summary
- 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
`AndroidWebDriver(android.app.Activity activity)` Use this contructor to use WebDriver with a WebView that has the same settings as the Android browser.
`AndroidWebDriver(android.app.Activity activity, ViewFactory viewFactory, ViewClientWrapper viewClient, ChromeClientWrapper chromeClient)` Use this constructor to use WebDriver with a custom view.
`AndroidWebDriver(android.app.Activity activity, ViewFactory viewFactory, ViewClientWrapper viewClient, ChromeClientWrapper chromeClient, android.view.View.OnFocusChangeListener focusListener)` Use this constructor to use WebDriver with a custom view and a custom View.OnFocusChangeListener for that view..

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`close()` Close the current window, quitting the browser if it's the last window currently open.
`java.lang.Object`	`executeAsyncScript(java.lang.String script, java.lang.Object... args)` Execute an asynchronous piece of JavaScript in the context of the currently selected frame or window.
`java.lang.Object`	`executeScript(java.lang.String script, java.lang.Object... args)` Executes JavaScript in the context of the currently selected frame or window.
`WebElement`	`findElement(By by)` Find the first `WebElement` using the given method.
`java.util.List<WebElement>`	`findElements(By by)` Find all elements within the current page using the given mechanism.
`void`	`get(java.lang.String url)` Load a new web page in the current browser window.
`boolean`	`getAcceptSslCerts()`
`android.app.Activity`	`getActivity()`
`java.lang.String`	`getCurrentUrl()` Get a string representing the current URL that the browser is looking at.
`LocalStorage`	`getLocalStorage()`
`ScreenOrientation`	`getOrientation()`
`java.lang.String`	`getPageSource()` Get the source of the last loaded page.
`<X> X`	`getScreenshotAs(OutputType<X> target)` Capture the screenshot and store it in the specified location.
`SessionStorage`	`getSessionStorage()`
`AppCacheStatus`	`getStatus()` The current state of the application cache.
`java.lang.String`	`getTitle()` The title of the current page.
`TouchScreen`	`getTouch()`
`java.lang.Object`	`getView()`
`android.webkit.WebView`	`getWebView()`
`java.lang.String`	`getWindowHandle()` Return an opaque handle to this window that uniquely identifies it within this driver instance.
`java.util.Set<java.lang.String>`	`getWindowHandles()` Return a set of window handles which can be used to iterate over all open windows of this webdriver instance by passing them to `#switchTo().window(String)`
`boolean`	`isJavascriptEnabled()`
`boolean`	`isOnline()`
`Location`	`location()` Gets the physical location of the browser.
`WebDriver.Options`	`manage()` Gets the Option interface
`WebDriver.Navigation`	`navigate()` An abstraction allowing the driver to access the browser's history and to navigate to a given URL.
`void`	`onLocationChanged(android.location.Location location)`
`void`	`onProviderDisabled(java.lang.String s)`
`void`	`onProviderEnabled(java.lang.String s)`
`void`	`onStatusChanged(java.lang.String s, int i, android.os.Bundle bundle)`
`protected java.lang.Object`	`processJsonObject(java.lang.Object res)`
`void`	`quit()` Quits this driver, closing every associated window.
`void`	`rotate(ScreenOrientation orientation)` Changes the orientation of the browser window.
`void`	`setAcceptSslCerts(boolean accept)`
`void`	`setLocation(Location loc)` Sets the physical location.
`void`	`setOnline(boolean online)` Changes the application online state.
`void`	`setProxy(java.lang.String host, int port)`
`WebDriver.TargetLocator`	`switchTo()` Send future commands to a different frame or window.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AndroidWebDriver
```
public AndroidWebDriver(android.app.Activity activity)
```
    Use this contructor to use WebDriver with a WebView that has the same settings as the Android browser.
    
    Parameters:
    activity - the activity context where the WebView will be created.
  - AndroidWebDriver
```
public AndroidWebDriver(android.app.Activity activity,
                ViewFactory viewFactory,
                ViewClientWrapper viewClient,
                ChromeClientWrapper chromeClient)
```
    Use this constructor to use WebDriver with a custom view.
    
    Parameters:
    activity - the activity context where the view will be displayed.
    viewFactory - a implementation of the ViewFactory interface. WebDriver will use this creation mechanism to create views when needed (e.g. when clicking on a link that opens a new window).
    viewClient - the ViewClientWrapper used by the custom WebView.
    chromeClient - the ChromeClientWrapper used by the custom WebView.
  - AndroidWebDriver
```
public AndroidWebDriver(android.app.Activity activity,
                ViewFactory viewFactory,
                ViewClientWrapper viewClient,
                ChromeClientWrapper chromeClient,
                android.view.View.OnFocusChangeListener focusListener)
```
    Use this constructor to use WebDriver with a custom view and a custom View.OnFocusChangeListener for that view..
    
    Parameters:
    activity - the activity context where the view will be displayed.
    viewFactory - a implementation of the ViewFactory interface. WebDriver will use this creation mechanism to create views when needed (e.g. when clicking on a link that opens a new window).
    viewClient - the ViewClientWrapper used by the custom WebView.
    chromeClient - the ChromeClientWrapper used by the custom WebView.
    focusListener - the listener used by the view that will be created by the viewFactory.
- Method Detail
  - setAcceptSslCerts
```
public void setAcceptSslCerts(boolean accept)
```
  - getAcceptSslCerts
```
public boolean getAcceptSslCerts()
```
  - getWebView
```
public android.webkit.WebView getWebView()
```
  - getView
```
public java.lang.Object getView()
```
  - getActivity
```
public android.app.Activity getActivity()
```
  - getCurrentUrl
```
public java.lang.String getCurrentUrl()
```
    Description copied from interface: WebDriver
    
    Get a string representing the current URL that the browser is looking at.
    
    Specified by:
    
    getCurrentUrl in interface WebDriver
    
    Returns:
    The URL of the page currently loaded in the browser
  - getTitle
```
public java.lang.String getTitle()
```
    Description copied from interface: WebDriver
    
    The title of the current page.
    
    Specified by:
    
    getTitle in interface WebDriver
    
    Returns:
    The title of the current page, with leading and trailing whitespace stripped, or null if one is not already set
  - get
```
public void get(java.lang.String url)
```
    Description copied from interface: WebDriver
    
    Load a new web page in the current browser window. This is done using an HTTP GET operation, and the method will block until the load is complete. This will follow redirects issued either by the server or as a meta-redirect from within the returned HTML. Should a meta-redirect "rest" for any duration of time, it is best to wait until this timeout is over, since should the underlying page change whilst your test is executing the results of future calls against this interface will be against the freshly loaded page. Synonym for WebDriver.Navigation.to(String).
    
    Specified by:
    
    get in interface WebDriver
    
    Parameters:
    url - The URL to load. It is best to use a fully qualified URL
  - getPageSource
```
public java.lang.String getPageSource()
```
    Description copied from interface: WebDriver
    
    Get the source of the last loaded page. If the page has been modified after loading (for example, by Javascript) there is no guarantee that the returned text is that of the modified page. Please consult the documentation of the particular driver being used to determine whether the returned text reflects the current state of the page or the text last sent by the web server. The page source returned is a representation of the underlying DOM: do not expect it to be formatted or escaped in the same way as the response sent from the web server. Think of it as an artist's impression.
    
    Specified by:
    
    getPageSource in interface WebDriver
    
    Returns:
    The source of the current page
  - close
```
public void close()
```
    Description copied from interface: WebDriver
    
    Close the current window, quitting the browser if it's the last window currently open.
    
    Specified by:
    
    close in interface WebDriver
  - quit
```
public void quit()
```
    Description copied from interface: WebDriver
    
    Quits this driver, closing every associated window.
    
    Specified by:
    
    quit in interface WebDriver
  - findElement
```
public WebElement findElement(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 SearchContext
    
    Specified by:
    
    findElement in interface WebDriver
    
    Parameters:
    by - The locating mechanism
    
    Returns:
    The first matching element on the current page
    See Also:
    By, WebDriver.Timeouts
  - findElements
```
public java.util.List<WebElement> findElements(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 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
  - getStatus
```
public AppCacheStatus getStatus()
```
    Description copied from interface: ApplicationCache
    
    The current state of the application cache.
    
    Specified by:
    
    getStatus in interface ApplicationCache
    
    Returns:
    AppCacheStatus
  - getWindowHandles
```
public java.util.Set<java.lang.String> getWindowHandles()
```
    Description copied from interface: WebDriver
    
    Return a set of window handles which can be used to iterate over all open windows of this webdriver instance by passing them to #switchTo().window(String)
    
    Specified by:
    
    getWindowHandles in interface WebDriver
    
    Returns:
    A set of window handles which can be used to iterate over all open windows.
  - getWindowHandle
```
public java.lang.String getWindowHandle()
```
    Description copied from interface: WebDriver
    
    Return an opaque handle to this window that uniquely identifies it within this driver instance. This can be used to switch to this window at a later date
    
    Specified by:
    
    getWindowHandle in interface WebDriver
  - switchTo
```
public WebDriver.TargetLocator switchTo()
```
    Description copied from interface: WebDriver
    
    Send future commands to a different frame or window.
    
    Specified by:
    
    switchTo in interface WebDriver
    
    Returns:
    A TargetLocator which can be used to select a frame or window
    See Also:
    WebDriver.TargetLocator
  - getLocalStorage
```
public LocalStorage getLocalStorage()
```
    Specified by:
    
    getLocalStorage in interface WebStorage
  - getSessionStorage
```
public SessionStorage getSessionStorage()
```
    Specified by:
    
    getSessionStorage in interface WebStorage
  - navigate
```
public WebDriver.Navigation navigate()
```
    Description copied from interface: WebDriver
    
    An abstraction allowing the driver to access the browser's history and to navigate to a given URL.
    
    Specified by:
    
    navigate in interface WebDriver
    
    Returns:
    A WebDriver.Navigation that allows the selection of what to do next
  - isJavascriptEnabled
```
public boolean isJavascriptEnabled()
```
  - executeScript
```
public java.lang.Object executeScript(java.lang.String script,
                             java.lang.Object... args)
```
    Description copied from interface: JavascriptExecutor
    Executes JavaScript in the context of the currently selected frame or window. The script fragment provided will be executed as the body of an anonymous function.
    Within the script, use document to refer to the current document. Note that local variables will not be available once the script has finished executing, though global variables will persist.
    If the script has a return value (i.e. if the script contains a return statement), then the following steps will be taken:
    - For an HTML element, this method returns a WebElement
    - For a decimal, a Double is returned
    - For a non-decimal number, a Long is returned
    - For a boolean, a Boolean is returned
    - For all other cases, a String is returned.
    - For an array, return a List<Object> with each object following the rules above. We support nested lists.
    - Unless the value is null or there is no return value, in which null is returned
    Arguments must be a number, a boolean, a String, WebElement, or a List of any combination of the above. An exception will be thrown if the arguments do not meet these criteria. The arguments will be made available to the JavaScript via the "arguments" magic variable, as if the function were called via "Function.apply"
    Specified by:
    
    executeScript in interface JavascriptExecutor
    
    Parameters:
    script - The JavaScript to execute
    args - The arguments to the script. May be empty
    
    Returns:
    One of Boolean, Long, String, List or WebElement. Or null.
  - executeAsyncScript
```
public java.lang.Object executeAsyncScript(java.lang.String script,
                                  java.lang.Object... args)
```
    Description copied from interface: JavascriptExecutor
    Execute an asynchronous piece of JavaScript in the context of the currently selected frame or window. Unlike executing synchronous JavaScript, scripts executed with this method must explicitly signal they are finished by invoking the provided callback. This callback is always injected into the executed function as the last argument.
    The first argument passed to the callback function will be used as the script's result. This value will be handled as follows:
    - For an HTML element, this method returns a WebElement
    - For a number, a Long is returned
    - For a boolean, a Boolean is returned
    - For all other cases, a String is returned.
    - For an array, return a List<Object> with each object following the rules above. We support nested lists.
    - Unless the value is null or there is no return value, in which null is returned
    Example #1: Performing a sleep in the browser under test.
```
   long start = System.currentTimeMillis();
   ((JavascriptExecutor) driver).executeAsyncScript(
       "window.setTimeout(arguments[arguments.length - 1], 500);");
   System.out.println(
       "Elapsed time: " + System.currentTimeMillis() - start);
 
```
    Example #2: Synchronizing a test with an AJAX application:
```
   WebElement composeButton = driver.findElement(By.id("compose-button"));
   composeButton.click();
   ((JavascriptExecutor) driver).executeAsyncScript(
       "var callback = arguments[arguments.length - 1];" +
       "mailClient.getComposeWindowWidget().onload(callback);");
   driver.switchTo().frame("composeWidget");
   driver.findElement(By.id("to")).sendKeys("[email protected]");
 
```
    Example #3: Injecting a XMLHttpRequest and waiting for the result:
```
   Object response = ((JavascriptExecutor) driver).executeAsyncScript(
       "var callback = arguments[arguments.length - 1];" +
       "var xhr = new XMLHttpRequest();" +
       "xhr.open('GET', '/resource/data.json', true);" +
       "xhr.onreadystatechange = function() {" +
       "  if (xhr.readyState == 4) {" +
       "    callback(xhr.responseText);" +
       "  }" +
       "}" +
       "xhr.send();");
   JSONObject json = new JSONObject((String) response);
   assertEquals("cheese", json.getString("food"));
 
```
    Script arguments must be a number, a boolean, a String, WebElement, or a List of any combination of the above. An exception will be thrown if the arguments do not meet these criteria. The arguments will be made available to the JavaScript via the "arguments" variable.
    Specified by:
    
    executeAsyncScript in interface JavascriptExecutor
    
    Parameters:
    script - The JavaScript to execute.
    args - The arguments to the script. May be empty.
    
    Returns:
    One of Boolean, Long, String, List, WebElement, or null.
  - processJsonObject
```
protected java.lang.Object processJsonObject(java.lang.Object res)
                                      throws org.json.JSONException
```
    Throws:
    
    org.json.JSONException
  - setProxy
```
public void setProxy(java.lang.String host,
            int port)
```
  - manage
```
public WebDriver.Options manage()
```
    Description copied from interface: WebDriver
    
    Gets the Option interface
    
    Specified by:
    
    manage in interface WebDriver
    
    Returns:
    An option interface
    See Also:
    WebDriver.Options
  - location
```
public Location location()
```
    Description copied from interface: LocationContext
    
    Gets the physical location of the browser.
    
    Specified by:
    
    location in interface LocationContext
    
    Returns:
    A Location containing the location information. Returns null if the location is not available
  - setLocation
```
public void setLocation(Location loc)
```
    Description copied from interface: LocationContext
    
    Sets the physical location.
    
    Specified by:
    
    setLocation in interface LocationContext
    
    Parameters:
    loc - A Location containing the new location information
  - onLocationChanged
```
public void onLocationChanged(android.location.Location location)
```
    Specified by:
    
    onLocationChanged in interface android.location.LocationListener
  - onStatusChanged
```
public void onStatusChanged(java.lang.String s,
                   int i,
                   android.os.Bundle bundle)
```
    Specified by:
    
    onStatusChanged in interface android.location.LocationListener
  - onProviderEnabled
```
public void onProviderEnabled(java.lang.String s)
```
    Specified by:
    
    onProviderEnabled in interface android.location.LocationListener
  - onProviderDisabled
```
public void onProviderDisabled(java.lang.String s)
```
    Specified by:
    
    onProviderDisabled in interface android.location.LocationListener
  - getScreenshotAs
```
public <X> X getScreenshotAs(OutputType<X> target)
                  throws WebDriverException
```
    Description copied from interface: TakesScreenshot
    Capture the screenshot and store it in the specified location.
    For WebDriver extending TakesScreenshot, this makes a best effort depending on the browser to return the following in order of preference:
    - Entire page
    - Current window
    - Visible portion of the current frame
    - The screenshot of the entire display containing the browser
    For WebElement extending TakesScreenshot, this makes a best effort depending on the browser to return the following in order of preference: - The entire content of the HTML element - The visisble portion of the HTML element
    Specified by:
    
    getScreenshotAs in interface TakesScreenshot
    
    Type Parameters:
    X - Return type for getScreenshotAs.
    Parameters:
    target - target type, @see OutputType
    
    Returns:
    Object in which is stored information about the screenshot.
    
    Throws:
    
    WebDriverException - on failure.
  - getOrientation
```
public ScreenOrientation getOrientation()
```
    Specified by:
    
    getOrientation in interface Rotatable
    
    Returns:
    the current screen orientation of the browser
  - rotate
```
public void rotate(ScreenOrientation orientation)
```
    Description copied from interface: Rotatable
    
    Changes the orientation of the browser window.
    
    Specified by:
    
    rotate in interface Rotatable
    
    Parameters:
    orientation - the desired screen orientation
  - isOnline
```
public boolean isOnline()
```
    Specified by:
    
    isOnline in interface BrowserConnection
    
    Returns:
    true if the application is online, false otherwise
  - setOnline
```
public void setOnline(boolean online)
               throws WebDriverException
```
    Description copied from interface: BrowserConnection
    
    Changes the application online state.
    
    Specified by:
    
    setOnline in interface BrowserConnection
    
    Parameters:
    online - A boolean representing the state
    
    Throws:
    
    WebDriverException
  - getTouch
```
public TouchScreen getTouch()
```
    Specified by:
    
    getTouch in interface HasTouchScreen

Class AndroidWebDriver

Nested Class Summary

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AndroidWebDriver

AndroidWebDriver

AndroidWebDriver

Method Detail

setAcceptSslCerts

getAcceptSslCerts

getWebView

getView

getActivity

getCurrentUrl

getTitle

get

getPageSource

close

quit

findElement

findElements

getStatus

getWindowHandles

getWindowHandle

switchTo

getLocalStorage

getSessionStorage

navigate

isJavascriptEnabled

executeScript

executeAsyncScript

processJsonObject

setProxy

manage

location

setLocation

onLocationChanged

onStatusChanged

onProviderEnabled

onProviderDisabled

getScreenshotAs

getOrientation

rotate

isOnline

setOnline

getTouch