# By Summary:[Methods](https://developer.android.com/reference/android/support/test/uiautomator/By#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/test/uiautomator/By#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/test/uiautomator/By#) # By | 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 class By ` ` 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.uiautomator.By |
*** ** * ** ***
[By](https://developer.android.com/reference/android/support/test/uiautomator/By)is a utility class which enables the creation of[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)s in a concise manner. Its primary function is to provide static factory methods for constructing[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)s using a shortened syntax. For example, you would use`findObject(By.text("foo"))`rather than`findObject(new BySelector().text("foo"))`to select UI elements with the text value "foo".
## Summary | ### Public methods || |-------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[checkable](https://developer.android.com/reference/android/support/test/uiautomator/By#checkable(boolean))`(boolean isCheckable) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the checkable criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[checked](https://developer.android.com/reference/android/support/test/uiautomator/By#checked(boolean))`(boolean isChecked) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the checked criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[clazz](https://developer.android.com/reference/android/support/test/uiautomator/By#clazz(java.lang.String, java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` packageName, `[String](https://developer.android.com/reference/java/lang/String.html)` className) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[clazz](https://developer.android.com/reference/android/support/test/uiautomator/By#clazz(java.lang.Class))`(`[Class](https://developer.android.com/reference/java/lang/Class.html)` clazz) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[clazz](https://developer.android.com/reference/android/support/test/uiautomator/By#clazz(java.util.regex.Pattern))`(`[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)` className) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[clazz](https://developer.android.com/reference/android/support/test/uiautomator/By#clazz(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` className) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[clickable](https://developer.android.com/reference/android/support/test/uiautomator/By#clickable(boolean))`(boolean isClickable) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the clickable criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[copy](https://developer.android.com/reference/android/support/test/uiautomator/By#copy(android.support.test.uiautomator.BySelector))`(`[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)` original) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and copies the criteria from`original`. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[depth](https://developer.android.com/reference/android/support/test/uiautomator/By#depth(int))`(int depth) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the depth criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[desc](https://developer.android.com/reference/android/support/test/uiautomator/By#desc(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` contentDescription) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[desc](https://developer.android.com/reference/android/support/test/uiautomator/By#desc(java.util.regex.Pattern))`(`[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)` contentDescription) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[descContains](https://developer.android.com/reference/android/support/test/uiautomator/By#descContains(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[descEndsWith](https://developer.android.com/reference/android/support/test/uiautomator/By#descEndsWith(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[descStartsWith](https://developer.android.com/reference/android/support/test/uiautomator/By#descStartsWith(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[enabled](https://developer.android.com/reference/android/support/test/uiautomator/By#enabled(boolean))`(boolean isEnabled) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the enabled criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[focusable](https://developer.android.com/reference/android/support/test/uiautomator/By#focusable(boolean))`(boolean isFocusable) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the focusable criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[focused](https://developer.android.com/reference/android/support/test/uiautomator/By#focused(boolean))`(boolean isFocused) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the focused criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[hasChild](https://developer.android.com/reference/android/support/test/uiautomator/By#hasChild(android.support.test.uiautomator.BySelector))`(`[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)` childSelector) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and adds a child selector criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[hasDescendant](https://developer.android.com/reference/android/support/test/uiautomator/By#hasDescendant(android.support.test.uiautomator.BySelector))`(`[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)` descendantSelector) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and adds a descendant selector criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[hasDescendant](https://developer.android.com/reference/android/support/test/uiautomator/By#hasDescendant(android.support.test.uiautomator.BySelector, int))`(`[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)` descendantSelector, int maxDepth) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and adds a descendant selector criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[longClickable](https://developer.android.com/reference/android/support/test/uiautomator/By#longClickable(boolean))`(boolean isLongClickable) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the long clickable criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[pkg](https://developer.android.com/reference/android/support/test/uiautomator/By#pkg(java.util.regex.Pattern))`(`[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)` applicationPackage) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the application package name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[pkg](https://developer.android.com/reference/android/support/test/uiautomator/By#pkg(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` applicationPackage) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the application package name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[res](https://developer.android.com/reference/android/support/test/uiautomator/By#res(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` resourceName) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the resource name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[res](https://developer.android.com/reference/android/support/test/uiautomator/By#res(java.lang.String, java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` resourcePackage, `[String](https://developer.android.com/reference/java/lang/String.html)` resourceId) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the resource name criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[res](https://developer.android.com/reference/android/support/test/uiautomator/By#res(java.util.regex.Pattern))`(`[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)` resourceName) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the resource id criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[scrollable](https://developer.android.com/reference/android/support/test/uiautomator/By#scrollable(boolean))`(boolean isScrollable) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the scrollable criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[selected](https://developer.android.com/reference/android/support/test/uiautomator/By#selected(boolean))`(boolean isSelected) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the selected criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[text](https://developer.android.com/reference/android/support/test/uiautomator/By#text(java.util.regex.Pattern))`(`[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)` regex) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[text](https://developer.android.com/reference/android/support/test/uiautomator/By#text(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` text) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[textContains](https://developer.android.com/reference/android/support/test/uiautomator/By#textContains(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[textEndsWith](https://developer.android.com/reference/android/support/test/uiautomator/By#textEndsWith(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria. | | ` static `[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) | ` `[textStartsWith](https://developer.android.com/reference/android/support/test/uiautomator/By#textStartsWith(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria. | | ### Inherited methods | |-----------------------|---| | [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/test/uiautomator/By#)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 ### checkable ``` BySelector checkable (boolean isCheckable) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the checkable criteria.
| Parameters || |---------------|------------------| | `isCheckable` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [checkable(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#checkable(boolean)) ### checked ``` BySelector checked (boolean isChecked) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the checked criteria.
| Parameters || |-------------|------------------| | `isChecked` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [checked(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#checked(boolean)) ### clazz ``` BySelector clazz (String packageName, String className) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria.
| Parameters || |---------------|-----------------| | `packageName` | `String`
| | `className` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [clazz(String, String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#clazz(java.lang.String, java.lang.String)) ### clazz ``` BySelector clazz (Class clazz) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria.
| Parameters || |---------|----------------| | `clazz` | `Class`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [clazz(Class)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#clazz(java.lang.Class)) ### clazz ``` BySelector clazz (Pattern className) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria.
| Parameters || |-------------|------------------| | `className` | `Pattern`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [clazz(Pattern)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#clazz(java.util.regex.Pattern)) ### clazz ``` BySelector clazz (String className) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the class name criteria.
| Parameters || |-------------|-----------------| | `className` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [clazz(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#clazz(java.lang.String)) ### clickable ``` BySelector clickable (boolean isClickable) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the clickable criteria.
| Parameters || |---------------|------------------| | `isClickable` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [clickable(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#clickable(boolean)) ### copy ``` BySelector copy (BySelector original) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and copies the criteria from`original`.
| Parameters || |------------|---------------------| | `original` | `BySelector`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| ### depth ``` BySelector depth (int depth) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the depth criteria.
| Parameters || |---------|--------------| | `depth` | `int`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| ### desc ``` BySelector desc (String contentDescription) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria.
| Parameters || |----------------------|-----------------| | `contentDescription` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [desc(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#desc(java.lang.String)) ### desc ``` BySelector desc (Pattern contentDescription) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria.
| Parameters || |----------------------|------------------| | `contentDescription` | `Pattern`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [desc(Pattern)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#desc(java.util.regex.Pattern)) ### descContains ``` BySelector descContains (String substring) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria.
| Parameters || |-------------|-----------------| | `substring` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [descContains(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#descContains(java.lang.String)) ### descEndsWith ``` BySelector descEndsWith (String substring) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria.
| Parameters || |-------------|-----------------| | `substring` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [descEndsWith(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#descEndsWith(java.lang.String)) ### descStartsWith ``` BySelector descStartsWith (String substring) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the content description criteria.
| Parameters || |-------------|-----------------| | `substring` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [descStartsWith(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#descStartsWith(java.lang.String)) ### enabled ``` BySelector enabled (boolean isEnabled) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the enabled criteria.
| Parameters || |-------------|------------------| | `isEnabled` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [enabled(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#enabled(boolean)) ### focusable ``` BySelector focusable (boolean isFocusable) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the focusable criteria.
| Parameters || |---------------|------------------| | `isFocusable` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [focusable(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#focusable(boolean)) ### focused ``` BySelector focused (boolean isFocused) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the focused criteria.
| Parameters || |-------------|------------------| | `isFocused` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [focused(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#focused(boolean)) ### hasChild ``` BySelector hasChild (BySelector childSelector) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and adds a child selector criteria.
| Parameters || |-----------------|---------------------| | `childSelector` | `BySelector`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [hasChild(BySelector)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#hasChild(android.support.test.uiautomator.BySelector)) ### hasDescendant ``` BySelector hasDescendant (BySelector descendantSelector) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and adds a descendant selector criteria.
| Parameters || |----------------------|---------------------| | `descendantSelector` | `BySelector`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [hasDescendant(BySelector)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#hasDescendant(android.support.test.uiautomator.BySelector)) ### hasDescendant ``` BySelector hasDescendant (BySelector descendantSelector, int maxDepth) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and adds a descendant selector criteria.
| Parameters || |----------------------|---------------------| | `descendantSelector` | `BySelector`
| | `maxDepth` | `int`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [hasDescendant(BySelector, int)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#hasDescendant(android.support.test.uiautomator.BySelector, int)) ### longClickable ``` BySelector longClickable (boolean isLongClickable) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the long clickable criteria.
| Parameters || |-------------------|------------------| | `isLongClickable` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [longClickable(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#longClickable(boolean)) ### pkg ``` BySelector pkg (Pattern applicationPackage) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the application package name criteria.
| Parameters || |----------------------|------------------| | `applicationPackage` | `Pattern`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [pkg(Pattern)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#pkg(java.util.regex.Pattern)) ### pkg ``` BySelector pkg (String applicationPackage) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the application package name criteria.
| Parameters || |----------------------|-----------------| | `applicationPackage` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [pkg(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#pkg(java.lang.String)) ### res ``` BySelector res (String resourceName) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the resource name criteria.
| Parameters || |----------------|-----------------| | `resourceName` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [res(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#res(java.lang.String)) ### res ``` BySelector res (String resourcePackage, String resourceId) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the resource name criteria.
| Parameters || |-------------------|-----------------| | `resourcePackage` | `String`
| | `resourceId` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [res(String, String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#res(java.lang.String, java.lang.String)) ### res ``` BySelector res (Pattern resourceName) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the resource id criteria.
| Parameters || |----------------|------------------| | `resourceName` | `Pattern`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [res(Pattern)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#res(java.util.regex.Pattern)) ### scrollable ``` BySelector scrollable (boolean isScrollable) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the scrollable criteria.
| Parameters || |----------------|------------------| | `isScrollable` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [scrollable(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#scrollable(boolean)) ### selected ``` BySelector selected (boolean isSelected) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the selected criteria.
| Parameters || |--------------|------------------| | `isSelected` | `boolean`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [selected(boolean)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#selected(boolean)) ### text ``` BySelector text (Pattern regex) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria.
| Parameters || |---------|------------------| | `regex` | `Pattern`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [text(Pattern)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#text(java.util.regex.Pattern)) ### text ``` BySelector text (String text) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria.
| Parameters || |--------|-----------------| | `text` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [text(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#text(java.lang.String)) ### textContains ``` BySelector textContains (String substring) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria.
| Parameters || |-------------|-----------------| | `substring` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [textContains(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#textContains(java.lang.String)) ### textEndsWith ``` BySelector textEndsWith (String substring) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria.
| Parameters || |-------------|-----------------| | `substring` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [textEndsWith(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#textEndsWith(java.lang.String)) ### textStartsWith ``` BySelector textStartsWith (String substring) ``` Constructs a new[BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector)and sets the text value criteria.
| Parameters || |-------------|-----------------| | `substring` | `String`
| | Returns || |---------------------------------------------------------------------------------------------------|--------| | [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) |
| **See also:** - [textStartsWith(String)](https://developer.android.com/reference/android/support/test/uiautomator/BySelector#textStartsWith(java.lang.String)) - ## Interfaces - [IAutomationSupport](https://developer.android.com/reference/android/support/test/uiautomator/IAutomationSupport) - [UiWatcher](https://developer.android.com/reference/android/support/test/uiautomator/UiWatcher) - ## Classes - [By](https://developer.android.com/reference/android/support/test/uiautomator/By) - [BySelector](https://developer.android.com/reference/android/support/test/uiautomator/BySelector) - [Configurator](https://developer.android.com/reference/android/support/test/uiautomator/Configurator) - [EventCondition](https://developer.android.com/reference/android/support/test/uiautomator/EventCondition) - [SearchCondition](https://developer.android.com/reference/android/support/test/uiautomator/SearchCondition) - [UiAutomatorInstrumentationTestRunner](https://developer.android.com/reference/android/support/test/uiautomator/UiAutomatorInstrumentationTestRunner) - [UiAutomatorTestCase](https://developer.android.com/reference/android/support/test/uiautomator/UiAutomatorTestCase) - [UiCollection](https://developer.android.com/reference/android/support/test/uiautomator/UiCollection) - [UiDevice](https://developer.android.com/reference/android/support/test/uiautomator/UiDevice) - [UiObject](https://developer.android.com/reference/android/support/test/uiautomator/UiObject) - [UiObject2](https://developer.android.com/reference/android/support/test/uiautomator/UiObject2) - [UiObject2Condition](https://developer.android.com/reference/android/support/test/uiautomator/UiObject2Condition) - [UiScrollable](https://developer.android.com/reference/android/support/test/uiautomator/UiScrollable) - [UiSelector](https://developer.android.com/reference/android/support/test/uiautomator/UiSelector) - [Until](https://developer.android.com/reference/android/support/test/uiautomator/Until) - ## Enums - [Direction](https://developer.android.com/reference/android/support/test/uiautomator/Direction) - ## Exceptions - [StaleObjectException](https://developer.android.com/reference/android/support/test/uiautomator/StaleObjectException) - [UiObjectNotFoundException](https://developer.android.com/reference/android/support/test/uiautomator/UiObjectNotFoundException)