# DriverAtoms

Summary:[Methods](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#)  

# DriverAtoms

| This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).

`
public

final

class
DriverAtoms
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object.html)`


``


`

|---|---------------------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||
| ↳ | android.support.test.espresso.web.webdriver.DriverAtoms |

<br />

*** ** * ** ***

A collection of Javascript Atoms from the WebDriver project.

## Summary

|                                                                                                                                                                                                                                                                                                                                                                                                 ### Public methods                                                                                                                                                                                                                                                                                                                                                                                                 ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Evaluation](https://developer.android.com/reference/android/support/test/espresso/web/model/Evaluation)`>`                                                                                    | ` `[clearElement](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#clearElement())`() ` Clears content from an editable element.                                                                                                                                                                                                                                                                                                                           |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[ElementReference](https://developer.android.com/reference/android/support/test/espresso/web/model/ElementReference)`>`                                                                        | ` `[findElement](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#findElement(android.support.test.espresso.web.webdriver.Locator, java.lang.String))`(`[Locator](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/Locator)` locator, `[String](https://developer.android.com/reference/java/lang/String.html)` value) ` Finds an element using the provided locatorType strategy.                                      |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[List](https://developer.android.com/reference/java/util/List.html)`<`[ElementReference](https://developer.android.com/reference/android/support/test/espresso/web/model/ElementReference)`>>` | ` `[findMultipleElements](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#findMultipleElements(android.support.test.espresso.web.webdriver.Locator, java.lang.String))`(`[Locator](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/Locator)` locator, `[String](https://developer.android.com/reference/java/lang/String.html)` value) ` Finds multiple elements given a locator strategy.                            |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[String](https://developer.android.com/reference/java/lang/String.html)`>`                                                                                                                     | ` `[getText](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#getText())`() ` Returns the visible text beneath a given DOM element.                                                                                                                                                                                                                                                                                                                        |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[ElementReference](https://developer.android.com/reference/android/support/test/espresso/web/model/ElementReference)`>`                                                                        | ` `[selectActiveElement](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#selectActiveElement())`() ` Finds the currently active element in the document.                                                                                                                                                                                                                                                                                                  |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>`                                                                          | ` `[selectFrameByIdOrName](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#selectFrameByIdOrName(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` idOrName) ` Selects a subframe of the current window by it's name or id.                                                                                                                                                                                   |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>`                                                                          | ` `[selectFrameByIdOrName](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#selectFrameByIdOrName(java.lang.String, android.support.test.espresso.web.model.WindowReference))`(`[String](https://developer.android.com/reference/java/lang/String.html)` idOrName, `[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)` root) ` Selects a subframe of the given window by it's name or id. |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>`                                                                          | ` `[selectFrameByIndex](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#selectFrameByIndex(int))`(int index) ` Selects a subframe of the currently selected window by it's index.                                                                                                                                                                                                                                                                         |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>`                                                                          | ` `[selectFrameByIndex](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#selectFrameByIndex(int, android.support.test.espresso.web.model.WindowReference))`(int index, `[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)` root) ` Selects a subframe of the given window by it's index.                                                                                                  |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Evaluation](https://developer.android.com/reference/android/support/test/espresso/web/model/Evaluation)`>`                                                                                    | ` `[webClick](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#webClick())`() ` Simulates the javascript events to click on a particular element.                                                                                                                                                                                                                                                                                                          |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Evaluation](https://developer.android.com/reference/android/support/test/espresso/web/model/Evaluation)`>`                                                                                    | ` `[webKeys](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#webKeys(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` text) ` Simulates javascript key events sent to a certain element.                                                                                                                                                                                                                     |
| ` static `[Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Boolean](https://developer.android.com/reference/java/lang/Boolean.html)`>`                                                                                                                   | ` `[webScrollIntoView](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#webScrollIntoView())`() ` Returns`true`if the desired element is in view after scrolling.                                                                                                                                                                                                                                                                                          |

| ### Inherited methods |
|-----------------------|---|
| [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms#)From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object.html)` ` |-------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object.html)          | ` clone() `                                                                                | | ` boolean`                                                                          | ` equals(`[Object](https://developer.android.com/reference/java/lang/Object.html)` arg0) ` | | ` void`                                                                             | ` finalize() `                                                                             | | ` final `[Class](https://developer.android.com/reference/java/lang/Class.html)`<?>` | ` getClass() `                                                                             | | ` int`                                                                              | ` hashCode() `                                                                             | | ` final void`                                                                       | ` notify() `                                                                               | | ` final void`                                                                       | ` notifyAll() `                                                                            | | ` `[String](https://developer.android.com/reference/java/lang/String.html)          | ` toString() `                                                                             | | ` final void`                                                                       | ` wait(long arg0, int arg1) `                                                              | | ` final void`                                                                       | ` wait(long arg0) `                                                                        | | ` final void`                                                                       | ` wait() `                                                                                 | ||

## Public methods

### clearElement

```
Atom<Evaluation> clearElement ()
```

Clears content from an editable element.

<br />

|                                                                                                      Returns                                                                                                       ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Evaluation](https://developer.android.com/reference/android/support/test/espresso/web/model/Evaluation)`>` | <br /> |

### findElement

```
Atom<ElementReference> findElement (Locator locator, 
                String value)
```

Finds an element using the provided locatorType strategy.

<br />

|         Parameters          ||
|-----------|------------------|
| `locator` | `Locator` <br /> |
| `value`   | `String` <br />  |

|                                                                                                            Returns                                                                                                             ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[ElementReference](https://developer.android.com/reference/android/support/test/espresso/web/model/ElementReference)`>` | <br /> |

### findMultipleElements

```
Atom<List<ElementReference>> findMultipleElements (Locator locator, 
                String value)
```

Finds multiple elements given a locator strategy.

<br />

|         Parameters          ||
|-----------|------------------|
| `locator` | `Locator` <br /> |
| `value`   | `String` <br />  |

|                                                                                                                                                Returns                                                                                                                                                ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[List](https://developer.android.com/reference/java/util/List.html)`<`[ElementReference](https://developer.android.com/reference/android/support/test/espresso/web/model/ElementReference)`>>` | <br /> |

### getText

```
Atom<String> getText ()
```

Returns the visible text beneath a given DOM element.

<br />

|                                                                                      Returns                                                                                      ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[String](https://developer.android.com/reference/java/lang/String.html)`>` | <br /> |

### selectActiveElement

```
Atom<ElementReference> selectActiveElement ()
```

Finds the currently active element in the document.

<br />

|                                                                                                            Returns                                                                                                             ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[ElementReference](https://developer.android.com/reference/android/support/test/espresso/web/model/ElementReference)`>` | <br /> |

### selectFrameByIdOrName

```
Atom<WindowReference> selectFrameByIdOrName (String idOrName)
```

Selects a subframe of the current window by it's name or id.

<br />

|         Parameters          ||
|------------|-----------------|
| `idOrName` | `String` <br /> |

|                                                                                                           Returns                                                                                                            ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>` | <br /> |

### selectFrameByIdOrName

```
Atom<WindowReference> selectFrameByIdOrName (String idOrName, 
                WindowReference root)
```

Selects a subframe of the given window by it's name or id.

<br />

|              Parameters              ||
|------------|--------------------------|
| `idOrName` | `String` <br />          |
| `root`     | `WindowReference` <br /> |

|                                                                                                           Returns                                                                                                            ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>` | <br /> |

### selectFrameByIndex

```
Atom<WindowReference> selectFrameByIndex (int index)
```

Selects a subframe of the currently selected window by it's index.

<br />

|      Parameters       ||
|---------|--------------|
| `index` | `int` <br /> |

|                                                                                                           Returns                                                                                                            ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>` | <br /> |

### selectFrameByIndex

```
Atom<WindowReference> selectFrameByIndex (int index, 
                WindowReference root)
```

Selects a subframe of the given window by it's index.

<br />

|            Parameters             ||
|---------|--------------------------|
| `index` | `int` <br />             |
| `root`  | `WindowReference` <br /> |

|                                                                                                           Returns                                                                                                            ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[WindowReference](https://developer.android.com/reference/android/support/test/espresso/web/model/WindowReference)`>` | <br /> |

### webClick

```
Atom<Evaluation> webClick ()
```

Simulates the javascript events to click on a particular element.

<br />

|                                                                                                      Returns                                                                                                       ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Evaluation](https://developer.android.com/reference/android/support/test/espresso/web/model/Evaluation)`>` | <br /> |

### webKeys

```
Atom<Evaluation> webKeys (String text)
```

Simulates javascript key events sent to a certain element.

<br />

|       Parameters        ||
|--------|-----------------|
| `text` | `String` <br /> |

|                                                                                                      Returns                                                                                                       ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Evaluation](https://developer.android.com/reference/android/support/test/espresso/web/model/Evaluation)`>` | <br /> |

### webScrollIntoView

```
Atom<Boolean> webScrollIntoView ()
```

Returns`true`if the desired element is in view after scrolling.

<br />

|                                                                                       Returns                                                                                       ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|
| [Atom](https://developer.android.com/reference/android/support/test/espresso/web/model/Atom)`<`[Boolean](https://developer.android.com/reference/java/lang/Boolean.html)`>` | <br /> |

-

  ## Classes

  - [DriverAtoms](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/DriverAtoms)
-

  ## Enums

  - [Locator](https://developer.android.com/reference/android/support/test/espresso/web/webdriver/Locator)