# By
# By
Artifact:[androidx.test.uiautomator:uiautomator](https://developer.android.com/jetpack/androidx/releases/test-uiautomator)
[View Source](https://cs.android.com/search?q=file:androidx/test/uiautomator/By.java+class:androidx.test.uiautomator.By)
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
*** ** * ** ***
Kotlin\|[Java](https://developer.android.com/reference/androidx/test/uiautomator/By "View this page in Java")
```
class By
```
*** ** * ** ***
[By](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By)is a utility class which enables the creation of[BySelector](https://developer.android.com/reference/kotlin/androidx/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/kotlin/androidx/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
| ### Nested types |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `class `[By.Window](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By.Window) This nested class is used to create a[ByWindowSelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/ByWindowSelector)that matches a window. |
| ### Public functions |
|-----------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [checkable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#checkable(boolean))`(isCheckable: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the checkable criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [checked](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#checked(boolean))`(isChecked: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the checked criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#clazz(java.util.regex.Pattern))`(className: `[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#clazz(java.lang.String))`(className: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#clazz(java.lang.Class))`(clazz: `[Class](https://developer.android.com/reference/java/lang/Class.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#clazz(java.lang.String,java.lang.String))`(packageName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`, className: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [clickable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#clickable(boolean))`(isClickable: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the clickable criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [copy](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#copy(androidx.test.uiautomator.BySelector))`(original: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and copies the criteria from`original`. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [depth](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#depth(int))`(depth: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the depth criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [desc](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#desc(java.util.regex.Pattern))`(contentDescription: `[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [desc](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#desc(java.lang.String))`(contentDescription: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [descContains](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#descContains(java.lang.String))`(substring: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [descEndsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#descEndsWith(java.lang.String))`(suffix: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [descStartsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#descStartsWith(java.lang.String))`(prefix: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | `@`[RequiresApi](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi)`(value = 30)` [displayId](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#displayId(int))`(displayId: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the display ID criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [enabled](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#enabled(boolean))`(isEnabled: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the enabled criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [focusable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#focusable(boolean))`(isFocusable: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the focusable criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [focused](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#focused(boolean))`(isFocused: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the focused criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [hasAncestor](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hasAncestor(androidx.test.uiautomator.BySelector))`(ancestorSelector: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds an ancestor selector criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [hasAncestor](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hasAncestor(androidx.test.uiautomator.BySelector,int))`(` ` ancestorSelector: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`,` ` maxAncestorDistance: @`[IntRange](https://developer.android.com/reference/kotlin/androidx/annotation/IntRange)`(from = 1) `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds an ancestor selector criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [hasChild](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hasChild(androidx.test.uiautomator.BySelector))`(childSelector: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a child selector criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [hasDescendant](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hasDescendant(androidx.test.uiautomator.BySelector))`(descendantSelector: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a descendant selector criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [hasDescendant](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hasDescendant(androidx.test.uiautomator.BySelector,int))`(descendantSelector: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`, maxDepth: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a descendant selector criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [hasParent](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hasParent(androidx.test.uiautomator.BySelector))`(parentSelector: `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a parent selector criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | `@`[RequiresApi](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi)`(value = 26)` [hint](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hint(java.lang.String))`(hint: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | `@`[RequiresApi](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi)`(value = 26)` [hint](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hint(java.util.regex.Pattern))`(regex: `[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | `@`[RequiresApi](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi)`(value = 26)` [hintContains](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hintContains(java.lang.String))`(substring: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | `@`[RequiresApi](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi)`(value = 26)` [hintEndsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hintEndsWith(java.lang.String))`(suffix: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | `@`[RequiresApi](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi)`(value = 26)` [hintStartsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#hintStartsWith(java.lang.String))`(prefix: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [longClickable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#longClickable(boolean))`(isLongClickable: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the long clickable criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [pkg](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#pkg(java.util.regex.Pattern))`(applicationPackage: `[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the application package name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [pkg](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#pkg(java.lang.String))`(applicationPackage: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the application package name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [res](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#res(java.util.regex.Pattern))`(resourceName: `[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the resource id criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [res](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#res(java.lang.String))`(resourceName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the resource name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [res](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#res(java.lang.String,java.lang.String))`(resourcePackage: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`, resourceId: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the resource name criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [scrollable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#scrollable(boolean))`(isScrollable: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the scrollable criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [selected](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#selected(boolean))`(isSelected: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the selected criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [text](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#text(java.util.regex.Pattern))`(regex: `[Pattern](https://developer.android.com/reference/java/util/regex/Pattern.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [text](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#text(java.lang.String))`(text: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [textContains](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#textContains(java.lang.String))`(substring: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [textEndsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#textEndsWith(java.lang.String))`(suffix: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria. |
| `java-static `[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector) | [textStartsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/By#textStartsWith(java.lang.String))`(prefix: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria. |
## Public functions
### checkable
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun checkable(isCheckable: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the checkable criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------|-------------------------------|
| [checkable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#checkable(boolean)) | BySelector.checkable(boolean) |
### checked
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun checked(isChecked: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the checked criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [checked](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#checked(boolean)) | BySelector.checked(boolean) |
### clazz
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun clazz(className: Pattern): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------------------|---------------------------|
| [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#clazz(java.util.regex.Pattern)) | BySelector.clazz(Pattern) |
### clazz
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun clazz(className: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria.
| See also |
|----------------------------------------------------------------------------------------------------------------------|--------------------------|
| [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#clazz(java.lang.String)) | BySelector.clazz(String) |
### clazz
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun clazz(clazz: Class): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------|-------------------------|
| [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#clazz(java.lang.Class)) | BySelector.clazz(Class) |
### clazz
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun clazz(packageName: String, className: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the class name criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------------------------|----------------------------------|
| [clazz](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#clazz(java.lang.String,java.lang.String)) | BySelector.clazz(String, String) |
### clickable
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun clickable(isClickable: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the clickable criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------|-------------------------------|
| [clickable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#clickable(boolean)) | BySelector.clickable(boolean) |
### copy
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun copy(original: BySelector): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and copies the criteria from`original`.
### depth
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun depth(depth: Int): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the depth criteria.
### desc
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun desc(contentDescription: Pattern): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------------|--------------------------|
| [desc](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#desc(java.util.regex.Pattern)) | BySelector.desc(Pattern) |
### desc
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun desc(contentDescription: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria.
| See also |
|--------------------------------------------------------------------------------------------------------------------|-------------------------|
| [desc](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#desc(java.lang.String)) | BySelector.desc(String) |
### descContains
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun descContains(substring: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [descContains](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#descContains(java.lang.String)) | BySelector.descContains(String) |
### descEndsWith
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun descEndsWith(suffix: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [descEndsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#descEndsWith(java.lang.String)) | BySelector.descEndsWith(String) |
### descStartsWith
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun descStartsWith(prefix: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the content description criteria.
| See also |
|----------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|
| [descStartsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#descStartsWith(java.lang.String)) | BySelector.descStartsWith(String) |
### displayId
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
@RequiresApi(value = 30)
java-static fun displayId(displayId: Int): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the display ID criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------|---------------------------|
| [displayId](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#displayId(int)) | BySelector.displayId(int) |
### enabled
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun enabled(isEnabled: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the enabled criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [enabled](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#enabled(boolean)) | BySelector.enabled(boolean) |
### focusable
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun focusable(isFocusable: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the focusable criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------|-------------------------------|
| [focusable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#focusable(boolean)) | BySelector.focusable(boolean) |
### focused
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun focused(isFocused: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the focused criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [focused](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#focused(boolean)) | BySelector.focused(boolean) |
### hasAncestor
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
java-static fun hasAncestor(ancestorSelector: BySelector): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds an ancestor selector criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [hasAncestor](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hasAncestor(androidx.test.uiautomator.BySelector)) | BySelector.hasAncestor(BySelector) |
### hasAncestor
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
java-static fun hasAncestor(
ancestorSelector: BySelector,
maxAncestorDistance: @IntRange(from = 1) Int
): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds an ancestor selector criteria.
| See also |
|----------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------|
| [hasAncestor](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hasAncestor(androidx.test.uiautomator.BySelector,int)) | BySelector.hasAncestor(BySelector, int) |
### hasChild
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun hasChild(childSelector: BySelector): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a child selector criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [hasChild](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hasChild(androidx.test.uiautomator.BySelector)) | BySelector.hasChild(BySelector) |
### hasDescendant
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun hasDescendant(descendantSelector: BySelector): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a descendant selector criteria.
| See also |
|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| [hasDescendant](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hasDescendant(androidx.test.uiautomator.BySelector)) | BySelector.hasDescendant(BySelector) |
### hasDescendant
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun hasDescendant(descendantSelector: BySelector, maxDepth: Int): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a descendant selector criteria.
| See also |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|
| [hasDescendant](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hasDescendant(androidx.test.uiautomator.BySelector,int)) | BySelector.hasDescendant(BySelector, int) |
### hasParent
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
java-static fun hasParent(parentSelector: BySelector): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and adds a parent selector criteria.
| See also |
|--------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------|
| [hasParent](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hasParent(androidx.test.uiautomator.BySelector)) | BySelector.hasParent(BySelector) |
### hint
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
@RequiresApi(value = 26)
java-static fun hint(hint: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria.
| See also |
|--------------------------------------------------------------------------------------------------------------------|-------------------------|
| [hint](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hint(java.lang.String)) | BySelector.hint(String) |
### hint
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
@RequiresApi(value = 26)
java-static fun hint(regex: Pattern): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------------|--------------------------|
| [hint](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hint(java.util.regex.Pattern)) | BySelector.hint(Pattern) |
### hintContains
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
@RequiresApi(value = 26)
java-static fun hintContains(substring: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [hintContains](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hintContains(java.lang.String)) | BySelector.hintContains(String) |
### hintEndsWith
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
@RequiresApi(value = 26)
java-static fun hintEndsWith(suffix: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [hintEndsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hintEndsWith(java.lang.String)) | BySelector.hintEndsWith(String) |
### hintStartsWith
Added in[2.3.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.3.0)
```
@RequiresApi(value = 26)
java-static fun hintStartsWith(prefix: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the hint value criteria.
| See also |
|----------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|
| [hintStartsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#hintStartsWith(java.lang.String)) | BySelector.hintStartsWith(String) |
### longClickable
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun longClickable(isLongClickable: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the long clickable criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------------------|-----------------------------------|
| [longClickable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#longClickable(boolean)) | BySelector.longClickable(boolean) |
### pkg
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun pkg(applicationPackage: Pattern): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the application package name criteria.
| See also |
|-------------------------------------------------------------------------------------------------------------------------|-------------------------|
| [pkg](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#pkg(java.util.regex.Pattern)) | BySelector.pkg(Pattern) |
### pkg
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun pkg(applicationPackage: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the application package name criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------|------------------------|
| [pkg](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#pkg(java.lang.String)) | BySelector.pkg(String) |
### res
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun res(resourceName: Pattern): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the resource id criteria.
| See also |
|-------------------------------------------------------------------------------------------------------------------------|-------------------------|
| [res](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#res(java.util.regex.Pattern)) | BySelector.res(Pattern) |
### res
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun res(resourceName: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the resource name criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------|------------------------|
| [res](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#res(java.lang.String)) | BySelector.res(String) |
### res
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun res(resourcePackage: String, resourceId: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the resource name criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------------------------|--------------------------------|
| [res](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#res(java.lang.String,java.lang.String)) | BySelector.res(String, String) |
### scrollable
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun scrollable(isScrollable: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the scrollable criteria.
| See also |
|-----------------------------------------------------------------------------------------------------------------------|--------------------------------|
| [scrollable](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#scrollable(boolean)) | BySelector.scrollable(boolean) |
### selected
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun selected(isSelected: Boolean): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the selected criteria.
| See also |
|-------------------------------------------------------------------------------------------------------------------|------------------------------|
| [selected](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#selected(boolean)) | BySelector.selected(boolean) |
### text
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun text(regex: Pattern): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria.
| See also |
|---------------------------------------------------------------------------------------------------------------------------|--------------------------|
| [text](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#text(java.util.regex.Pattern)) | BySelector.text(Pattern) |
### text
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun text(text: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria.
| See also |
|--------------------------------------------------------------------------------------------------------------------|-------------------------|
| [text](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#text(java.lang.String)) | BySelector.text(String) |
### textContains
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun textContains(substring: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [textContains](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#textContains(java.lang.String)) | BySelector.textContains(String) |
### textEndsWith
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun textEndsWith(suffix: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria.
| See also |
|------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [textEndsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#textEndsWith(java.lang.String)) | BySelector.textEndsWith(String) |
### textStartsWith
Added in[2.2.0](https://developer.android.com/jetpack/androidx/releases/test-uiautomator#2.2.0)
```
java-static fun textStartsWith(prefix: String): BySelector
```
Constructs a new[BySelector](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector)and sets the text value criteria.
| See also |
|----------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|
| [textStartsWith](https://developer.android.com/reference/kotlin/androidx/test/uiautomator/BySelector#textStartsWith(java.lang.String)) | BySelector.textStartsWith(String) |