Specifies the elements in the layout hierarchy for tests to target, filtered
by properties such as text value, content-description, class name, and state
information. You can also target an element by its location in a layout
hierarchy.
Set the search criteria to match widgets that are checkable.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match widgets that
are currently checked (usually for checkboxes).
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match widgets that are clickable.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match the content-description
property for a widget.
The content-description is typically used
by the Android Accessibility framework to
provide an audio prompt for the widget when
the widget is selected. The content-description
for the widget must match exactly
with the string in your input argument.
Matching is case-sensitive.
Set the search criteria to match the content-description
property for a widget.
The content-description is typically used
by the Android Accessibility framework to
provide an audio prompt for the widget when
the widget is selected. The content-description
for the widget must contain
the string in your input argument.
Matching is case-insensitive.
Set the search criteria to match the content-description
property for a widget.
The content-description is typically used
by the Android Accessibility framework to
provide an audio prompt for the widget when
the widget is selected. The content-description
for the widget must match exactly
with the string in your input argument.
Set the search criteria to match the content-description
property for a widget.
The content-description is typically used
by the Android Accessibility framework to
provide an audio prompt for the widget when
the widget is selected. The content-description
for the widget must start
with the string in your input argument.
Matching is case-insensitive.
Set the search criteria to match widgets that are enabled.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match widgets that are focusable.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match widgets that have focus.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Adds a child UiSelector criteria to this selector which is used to
start search from the parent widget.
Use this selector to narrow the search scope to
sibling widgets as well all child widgets under a parent.
Set the search criteria to match the widget by its node
index in the layout hierarchy.
The index value must be 0 or greater.
Using the index can be unreliable and should only
be used as a last resort for matching. Instead,
consider using the instance(int) method.
Set the search criteria to match the
widget by its instance number.
The instance value must be 0 or greater, where
the first instance is 0.
For example, to simulate a user click on
the third image that is enabled in a UI screen, you
could specify a a search criteria where the instance is
2, the className(String) matches the image
widget class, and enabled(boolean) is true.
The code would look like this:
new UiSelector().className("android.widget.ImageView")
.enabled(true).instance(2);
Set the search criteria to match widgets that are long-clickable.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match widgets that are scrollable.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match widgets that
are currently selected.
Typically, using this search criteria alone is not useful.
You should also include additional criteria, such as text,
content-description, or the class name for a widget.
If no other search criteria is specified, and there is more
than one matching widget, the first widget in the tree
is selected.
Set the search criteria to match the visible text displayed
in a widget (for example, the text label to launch an app).
The text for the element must match exactly with the string in your input
argument. Matching is case-sensitive.
Set the search criteria to match the visible text in a widget
where the visible text must contain the string in your input argument.
The matching is case-sensitive.
Set the search criteria to match the visible text displayed in a layout
element, using a regular expression.
The text in the widget must match exactly with the string in your
input argument.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-04-11 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{"lastModified": "Last updated 2024-04-11 UTC."}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-04-11 UTC."]]