# ViewMatchers
Summary:[Nested Classes](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#nestedclasses)\|[Methods](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#)
# ViewMatchers
| This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).
`
public
final
class
ViewMatchers
`
`
extends `[Object](https://developer.android.com/reference/java/lang/Object.html)`
``
`
|---|----------------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||
| ↳ | android.support.test.espresso.matcher.ViewMatchers |
*** ** * ** ***
A collection of hamcrest matchers that match[View](https://developer.android.com/reference/android/view/View.html)s.
## Summary
| ### Nested classes ||
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` enum` | [ViewMatchers.Visibility](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers.Visibility) Enumerates the possible list of values for[getVisibility()](https://developer.android.com/reference/android/view/View.html#getVisibility()). |
| ### Public methods ||
|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` static void` | ` `[assertThat](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#assertThat(java.lang.String, T, org.hamcrest.Matcher))`(`[String](https://developer.android.com/reference/java/lang/String.html)` message, T actual, Matcher matcher) ` A replacement for MatcherAssert.assertThat that renders View objects nicely. |
| ` static void` | ` `[assertThat](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#assertThat(T, org.hamcrest.Matcher))`(T actual, Matcher matcher) ` A replacement for MatcherAssert.assertThat that renders View objects nicely. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasBackground](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasBackground(int))`(int drawableId) ` Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)based on background resource. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasChildCount](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasChildCount(int))`(int childCount) ` Matches a[ViewGroup](https://developer.android.com/reference/android/view/ViewGroup.html)if it has exactly the specified number of children. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasContentDescription](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasContentDescription())`() ` Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)with any content description. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasDescendant](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasDescendant(org.hamcrest.Matcher))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> descendantMatcher) ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)based on the presence of a descendant in its view hierarchy. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasErrorText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasErrorText(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` expectedError) ` Returns a matcher that matches[EditText](https://developer.android.com/reference/android/widget/EditText.html)based on edit text error string value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasErrorText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasErrorText(org.hamcrest.Matcher))`(Matcher<`[String](https://developer.android.com/reference/java/lang/String.html)`> stringMatcher) ` Returns a matcher that matches[EditText](https://developer.android.com/reference/android/widget/EditText.html)based on edit text error string value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasFocus](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasFocus())`() ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)currently have focus. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasImeAction](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasImeAction(int))`(int imeAction) ` Returns a matcher that matches views that support input methods (e.g. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasImeAction](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasImeAction(org.hamcrest.Matcher))`(Matcher<`[Integer](https://developer.android.com/reference/java/lang/Integer.html)`> imeActionMatcher) ` Returns a matcher that matches views that support input methods (e.g. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasLinks](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasLinks())`() ` Returns a matcher that matches[TextViews](https://developer.android.com/reference/android/widget/TextView.html)that have links. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasMinimumChildCount](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasMinimumChildCount(int))`(int minChildCount) ` Matches a[ViewGroup](https://developer.android.com/reference/android/view/ViewGroup.html)if it has at least the specified number of children. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasSibling](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasSibling(org.hamcrest.Matcher))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> siblingMatcher) ` Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on their siblings. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[hasTextColor](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#hasTextColor(int))`(int colorResId) ` Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)based on it's color. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isAssignableFrom](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isAssignableFrom(java.lang.Class))`(`[Class](https://developer.android.com/reference/java/lang/Class.html)` clazz) ` Matches[Views](https://developer.android.com/reference/android/view/View.html)based on instance or subclass of the provided class. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isChecked](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isChecked())`() ` Returns a matcher that accepts if and only if the view is a CompoundButton (or subtype of) and is in checked state. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isClickable](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isClickable())`() ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are clickable. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isCompletelyDisplayed](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isCompletelyDisplayed())`() ` Returns a matcher which only accepts a view whose height and width fit perfectly within the currently displayed region of this view. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isDescendantOfA](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isDescendantOfA(org.hamcrest.Matcher))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> ancestorMatcher) ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)based on the given ancestor type. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isDisplayed](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isDisplayed())`() ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are currently displayed on the screen to the user. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isDisplayingAtLeast](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isDisplayingAtLeast(int))`(int areaPercentage) ` Returns a matcher which accepts a view so long as a given percentage of that view's area is not obscured by any parent view and is thus visible to the user. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isEnabled](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isEnabled())`() ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are enabled. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isFocusable](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isFocusable())`() ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are focusable. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isJavascriptEnabled](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isJavascriptEnabled())`() ` Returns a matcher that matches[WebView](https://developer.android.com/reference/android/webkit/WebView.html)if they are evaluating`JavaScript`. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isNotChecked](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isNotChecked())`() ` Returns a matcher that accepts if and only if the view is a CompoundButton (or subtype of) and is not in checked state. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isRoot](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isRoot())`() ` Returns a matcher that matches root[View](https://developer.android.com/reference/android/view/View.html). |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[isSelected](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isSelected())`() ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are selected. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[supportsInputMethods](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#supportsInputMethods())`() ` Returns a matcher that matches views that support input methods. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withAlpha](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withAlpha(float))`(float alpha) ` Matches[Views](https://developer.android.com/reference/android/view/View.html)with the specified alpha value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withChild](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withChild(org.hamcrest.Matcher))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> childMatcher) ` Returns`true`only if the view's child is accepted by the provided matcher. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withClassName](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withClassName(org.hamcrest.Matcher))`(Matcher<`[String](https://developer.android.com/reference/java/lang/String.html)`> classNameMatcher) ` Returns a matcher that matches Views with class name matching the given matcher. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withContentDescription](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withContentDescription(int))`(int resourceId) ` Returns a[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on content description property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withContentDescription](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withContentDescription(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` text) ` Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on content description property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withContentDescription](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withContentDescription(org.hamcrest.Matcher))`(Matcher charSequenceMatcher) ` Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on content description property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withEffectiveVisibility](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withEffectiveVisibility(android.support.test.espresso.matcher.ViewMatchers.Visibility))`(`[ViewMatchers.Visibility](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers.Visibility)` visibility) ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that have "effective" visibility set to the given value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withHint](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withHint(org.hamcrest.Matcher))`(Matcher<`[String](https://developer.android.com/reference/java/lang/String.html)`> stringMatcher) ` Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)s based on hint property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withHint](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withHint(int))`(int resourceId) ` Returns a matcher that matches a descendant of[TextView](https://developer.android.com/reference/android/widget/TextView.html)that is displaying the hint associated with the given resource id. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withHint](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withHint(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` hintText) ` Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)based on it's hint property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withId](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withId(org.hamcrest.Matcher))`(Matcher<`[Integer](https://developer.android.com/reference/java/lang/Integer.html)`> integerMatcher) ` Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on resource ids. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withId](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withId(int))`(int id) ` A matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on its resource id. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withInputType](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withInputType(int))`(int inputType) ` Returns a matcher that matches[InputType](https://developer.android.com/reference/android/text/InputType.html). |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withParent](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withParent(org.hamcrest.Matcher))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> parentMatcher) ` A matcher that accepts a view if and only if the view's parent is accepted by the provided matcher. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withParentIndex](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withParentIndex(int))`(int index) ` Returns a matcher that matches the child index inside the[ViewParent](https://developer.android.com/reference/android/view/ViewParent.html). |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withResourceName](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withResourceName(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` name) ` Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on resource id names, (for instance, channel_avatar). |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withResourceName](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withResourceName(org.hamcrest.Matcher))`(Matcher<`[String](https://developer.android.com/reference/java/lang/String.html)`> stringMatcher) ` Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on resource id names, (for instance, channel_avatar). |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withSpinnerText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withSpinnerText(int))`(int resourceId) ` Returns a matcher that matches a descendant of[Spinner](https://developer.android.com/reference/android/widget/Spinner.html)that is displaying the string of the selected item associated with the given resource id. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withSpinnerText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withSpinnerText(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` text) ` Returns a matcher that matches[Spinner](https://developer.android.com/reference/android/widget/Spinner.html)based on it's selected item's`toString`value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withSpinnerText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withSpinnerText(org.hamcrest.Matcher))`(Matcher<`[String](https://developer.android.com/reference/java/lang/String.html)`> stringMatcher) ` Returns a matcher that matches[Spinner's](https://developer.android.com/reference/android/widget/Spinner.html)based on`toString`value of the selected item. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withSubstring](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withSubstring(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` substring) ` Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)that contains the specific substring. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withTagKey](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withTagKey(int))`(int key) ` Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)based on tag keys. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withTagKey](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withTagKey(int, org.hamcrest.Matcher))`(int key, Matcher<`[Object](https://developer.android.com/reference/java/lang/Object.html)`> objectMatcher) ` Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on tag keys. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withTagValue](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withTagValue(org.hamcrest.Matcher))`(Matcher<`[Object](https://developer.android.com/reference/java/lang/Object.html)`> tagValueMatcher) ` Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)based on tag property values. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withText(org.hamcrest.Matcher))`(Matcher<`[String](https://developer.android.com/reference/java/lang/String.html)`> stringMatcher) ` Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)s based on text property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withText(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String.html)` text) ` Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)based on its text property value. |
| ` static Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[withText](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#withText(int))`(int resourceId) ` Returns a matcher that matches a descendant of[TextView](https://developer.android.com/reference/android/widget/TextView.html)that is displaying the string associated with the given resource id. |
| ### Inherited methods |
|-----------------------|---|
| [](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#)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
### assertThat
```
void assertThat (String message,
T actual,
Matcher matcher)
```
A replacement for MatcherAssert.assertThat that renders View objects nicely.
| Parameters ||
|-----------|-------------------------------------------------------------|
| `message` | `String`: the message to display. |
| `actual` | `T`: the actual value. |
| `matcher` | `Matcher`: a matcher that accepts or rejects actual. |
### assertThat
```
void assertThat (T actual,
Matcher matcher)
```
A replacement for MatcherAssert.assertThat that renders View objects nicely.
| Parameters ||
|-----------|-------------------------------------------------------------|
| `actual` | `T`: the actual value. |
| `matcher` | `Matcher`: a matcher that accepts or rejects actual. |
### hasBackground
```
Matcher hasBackground (int drawableId)
```
Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)based on background resource.
Note: This method compares images at a pixel level and might have significant performance implications for larger bitmaps.
**This API is currently in beta.**
| Parameters ||
|--------------|--------------|
| `drawableId` | `int` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasChildCount
```
Matcher hasChildCount (int childCount)
```
Matches a[ViewGroup](https://developer.android.com/reference/android/view/ViewGroup.html)if it has exactly the specified number of children.
| Parameters ||
|--------------|--------------|
| `childCount` | `int` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasContentDescription
```
Matcher hasContentDescription ()
```
Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)with any content description.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasDescendant
```
Matcher hasDescendant (Matcher descendantMatcher)
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)based on the presence of a descendant in its view hierarchy.
| Parameters ||
|---------------------|----------------------------------------------------------|
| `descendantMatcher` | `Matcher`: the type of the descendant to match on |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasErrorText
```
Matcher hasErrorText (String expectedError)
```
Returns a matcher that matches[EditText](https://developer.android.com/reference/android/widget/EditText.html)based on edit text error string value.
Note: Sugar for`hasErrorText(is("string"))`.
| Parameters ||
|-----------------|-----------------|
| `expectedError` | `String` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasErrorText
```
Matcher hasErrorText (Matcher stringMatcher)
```
Returns a matcher that matches[EditText](https://developer.android.com/reference/android/widget/EditText.html)based on edit text error string value.
**Note:** View's error property can be`null`, to match against it use`
hasErrorText(nullValue(String.class)`
| Parameters ||
|-----------------|------------------|
| `stringMatcher` | `Matcher` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasFocus
```
Matcher hasFocus ()
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)currently have focus.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasImeAction
```
Matcher hasImeAction (int imeAction)
```
Returns a matcher that matches views that support input methods (e.g. EditText) and have the specified IME action set in its[EditorInfo](https://developer.android.com/reference/android/view/inputmethod/EditorInfo.html).
| Parameters ||
|-------------|---------------------------------------|
| `imeAction` | `int`: the IME action to match |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasImeAction
```
Matcher hasImeAction (Matcher imeActionMatcher)
```
Returns a matcher that matches views that support input methods (e.g. EditText) and have the specified IME action set in its[EditorInfo](https://developer.android.com/reference/android/view/inputmethod/EditorInfo.html).
| Parameters ||
|--------------------|------------------------------------------------|
| `imeActionMatcher` | `Matcher`: a matcher for the IME action |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasLinks
```
Matcher hasLinks ()
```
Returns a matcher that matches[TextViews](https://developer.android.com/reference/android/widget/TextView.html)that have links.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasMinimumChildCount
```
Matcher hasMinimumChildCount (int minChildCount)
```
Matches a[ViewGroup](https://developer.android.com/reference/android/view/ViewGroup.html)if it has at least the specified number of children.
| Parameters ||
|-----------------|--------------|
| `minChildCount` | `int` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasSibling
```
Matcher hasSibling (Matcher siblingMatcher)
```
Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on their siblings.
This may be particularly useful when a view cannot be uniquely selected on properties such as text or`R.id`. For example: a call button is repeated several times in a contacts layout and the only way to differentiate the call button view is by what appears next to it (e.g. the unique name of the contact).
| Parameters ||
|------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| `siblingMatcher` | `Matcher`: a[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)for the sibling of the view. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### hasTextColor
```
Matcher hasTextColor (int colorResId)
```
Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)based on it's color.
**This API is currently in beta.**
| Parameters ||
|--------------|--------------|
| `colorResId` | `int` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isAssignableFrom
```
Matcher isAssignableFrom (Class clazz)
```
Matches[Views](https://developer.android.com/reference/android/view/View.html)based on instance or subclass of the provided class.
Some versions of Hamcrest make the generic typing of this a nightmare, so we have a special case for our users.
| Parameters ||
|---------|----------------|
| `clazz` | `Class` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isChecked
```
Matcher isChecked ()
```
Returns a matcher that accepts if and only if the view is a CompoundButton (or subtype of) and is in checked state.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isClickable
```
Matcher isClickable ()
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are clickable.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isCompletelyDisplayed
```
Matcher isCompletelyDisplayed ()
```
Returns a matcher which only accepts a view whose height and width fit perfectly within the currently displayed region of this view.
There exist views (such as ScrollViews) whose height and width are larger then the physical device screen by design. Such views will**never**be completely displayed.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isDescendantOfA
```
Matcher isDescendantOfA (Matcher ancestorMatcher)
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)based on the given ancestor type.
| Parameters ||
|-------------------|--------------------------------------------------------|
| `ancestorMatcher` | `Matcher`: the type of the ancestor to match on |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isDisplayed
```
Matcher isDisplayed ()
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are currently displayed on the screen to the user.
**Note:** isDisplayed will select views that are partially displayed (eg: the full height/width of the view is greater than the height/width of the visible rectangle). If you wish to ensure the entire rectangle this view draws is displayed to the user use[isCompletelyDisplayed()](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isCompletelyDisplayed()).
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isDisplayingAtLeast
```
Matcher isDisplayingAtLeast (int areaPercentage)
```
Returns a matcher which accepts a view so long as a given percentage of that view's area is not obscured by any parent view and is thus visible to the user.
| Parameters ||
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| `areaPercentage` | `int`: an integer ranging from (0, 100\] indicating how much percent of the surface area of the view must be shown to the user to be accepted. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isEnabled
```
Matcher isEnabled ()
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are enabled.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isFocusable
```
Matcher isFocusable ()
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are focusable.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isJavascriptEnabled
```
Matcher isJavascriptEnabled ()
```
Returns a matcher that matches[WebView](https://developer.android.com/reference/android/webkit/WebView.html)if they are evaluating`JavaScript`.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isNotChecked
```
Matcher isNotChecked ()
```
Returns a matcher that accepts if and only if the view is a CompoundButton (or subtype of) and is not in checked state.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isRoot
```
Matcher isRoot ()
```
Returns a matcher that matches root[View](https://developer.android.com/reference/android/view/View.html).
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### isSelected
```
Matcher isSelected ()
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that are selected.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### supportsInputMethods
```
Matcher supportsInputMethods ()
```
Returns a matcher that matches views that support input methods.
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withAlpha
```
Matcher withAlpha (float alpha)
```
Matches[Views](https://developer.android.com/reference/android/view/View.html)with the specified alpha value.
| Parameters ||
|---------|----------------|
| `alpha` | `float` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withChild
```
Matcher withChild (Matcher childMatcher)
```
Returns`true`only if the view's child is accepted by the provided matcher.
| Parameters ||
|----------------|------------------------------------------------------------|
| `childMatcher` | `Matcher`: the matcher to apply on the child views. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withClassName
```
Matcher withClassName (Matcher classNameMatcher)
```
Returns a matcher that matches Views with class name matching the given matcher.
| Parameters ||
|--------------------|------------------|
| `classNameMatcher` | `Matcher` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withContentDescription
```
Matcher withContentDescription (int resourceId)
```
Returns a[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on content description property value.
| Parameters ||
|--------------|-----------------------------------------------------------------------|
| `resourceId` | `int`: the resource id of the content description to match on. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withContentDescription
```
Matcher withContentDescription (String text)
```
Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on content description property value. Sugar for`withContentDescription(is("string"))`.
| Parameters ||
|--------|----------------------------------------|
| `text` | `String`: the text to match on. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withContentDescription
```
Matcher withContentDescription (Matcher charSequenceMatcher)
```
Returns an[`Matcher`](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches[Views](https://developer.android.com/reference/android/view/View.html)based on content description property value.
| Parameters ||
|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `charSequenceMatcher` | `Matcher`: a[CharSequence](https://developer.android.com/reference/java/lang/CharSequence.html)[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)for the content description |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withEffectiveVisibility
```
Matcher withEffectiveVisibility (ViewMatchers.Visibility visibility)
```
Returns a matcher that matches[Views](https://developer.android.com/reference/android/view/View.html)that have "effective" visibility set to the given value.
Effective visibility takes into account not only the view's visibility value, but also that of its ancestors. In case of[ERROR(/View.VISIBLE)](https://developer.android.com/), this means that the view and all of its ancestors have`visibility=VISIBLE`. In case of GONE and INVISIBLE, it's the opposite - any GONE or INVISIBLE parent will make all of its children have their effective visibility.
**Note:** Contrary to what the name may imply, view visibility does not directly translate into whether the view is displayed on screen (use[isDisplayed()](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isDisplayed())for that). For example, the view and all of its ancestors can have`visibility=VISIBLE`, but the view may need to be scrolled to in order to be actually visible to the user. Unless you're specifically targeting the visibility value with your test, use[isDisplayed()](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers#isDisplayed()).
| Parameters ||
|--------------|----------------------------------|
| `visibility` | `ViewMatchers.Visibility` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withHint
```
Matcher withHint (Matcher stringMatcher)
```
Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)s based on hint property value.
**Note:** View's hint property can be`null`, to match against it use`
withHint(nullValue(String.class)`
| Parameters ||
|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `stringMatcher` | `Matcher`:[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)of[String](https://developer.android.com/reference/java/lang/String.html)with text to match |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withHint
```
Matcher withHint (int resourceId)
```
Returns a matcher that matches a descendant of[TextView](https://developer.android.com/reference/android/widget/TextView.html)that is displaying the hint associated with the given resource id.
| Parameters ||
|--------------|--------------------------------------------------------------------------------|
| `resourceId` | `int`: the string resource the text view is expected to have as a hint. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withHint
```
Matcher withHint (String hintText)
```
Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)based on it's hint property value.
**Note:** View's sugar for`withHint(is("string"))`.
| Parameters ||
|------------|--------------------------------------------------------------------------------------------------------------------|
| `hintText` | `String`:[String](https://developer.android.com/reference/java/lang/String.html)with the hint text to match |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withId
```
Matcher withId (Matcher integerMatcher)
```
Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on resource ids. Note: Android resource ids are not guaranteed to be unique. You may have to pair this matcher with another one to guarantee a unique view selection.
| Parameters ||
|------------------|----------------------------------------------|
| `integerMatcher` | `Matcher`: a Matcher for resource ids |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withId
```
Matcher withId (int id)
```
A matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on its resource id.
Same as`withId(is(int))`but attempts to look up resource name of the given id and use a`R.id.myView`style description with describeTo. If resource lookup is unavailable, at the time describeTo is invoked, this will print out a simple "with id: %d". If the lookup for a given id fails, "with id: %d (resource name not found)" will be returned as the description.
**Note:**Android resource ids are not guaranteed to be unique. You may have to pair this matcher with another one to guarantee a unique view selection.
| Parameters ||
|------|--------------------------------|
| `id` | `int`: the resource id. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withInputType
```
Matcher withInputType (int inputType)
```
Returns a matcher that matches[InputType](https://developer.android.com/reference/android/text/InputType.html).
| Parameters ||
|-------------|--------------|
| `inputType` | `int` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withParent
```
Matcher withParent (Matcher parentMatcher)
```
A matcher that accepts a view if and only if the view's parent is accepted by the provided matcher.
| Parameters ||
|-----------------|------------------------------------------------------|
| `parentMatcher` | `Matcher`: the matcher to apply on getParent. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withParentIndex
```
Matcher withParentIndex (int index)
```
Returns a matcher that matches the child index inside the[ViewParent](https://developer.android.com/reference/android/view/ViewParent.html).
| Parameters ||
|---------|--------------|
| `index` | `int` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withResourceName
```
Matcher withResourceName (String name)
```
Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on resource id names, (for instance, channel_avatar).
| Parameters ||
|--------|---------------------------------------|
| `name` | `String`: the resource id name |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withResourceName
```
Matcher withResourceName (Matcher stringMatcher)
```
Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)s based on resource id names, (for instance, channel_avatar).
| Parameters ||
|-----------------|---------------------------------------------------|
| `stringMatcher` | `Matcher`: a Matcher for resource id names |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withSpinnerText
```
Matcher withSpinnerText (int resourceId)
```
Returns a matcher that matches a descendant of[Spinner](https://developer.android.com/reference/android/widget/Spinner.html)that is displaying the string of the selected item associated with the given resource id.
| Parameters ||
|--------------|-----------------------------------------------------------------------------------------|
| `resourceId` | `int`: the resource id of the string resource the text view is expected to hold. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withSpinnerText
```
Matcher withSpinnerText (String text)
```
Returns a matcher that matches[Spinner](https://developer.android.com/reference/android/widget/Spinner.html)based on it's selected item's`toString`value.
Note: Sugar for`withSpinnerText(is("string"))`.
| Parameters ||
|--------|-----------------|
| `text` | `String` |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withSpinnerText
```
Matcher withSpinnerText (Matcher stringMatcher)
```
Returns a matcher that matches[Spinner's](https://developer.android.com/reference/android/widget/Spinner.html)based on`toString`value of the selected item.
| Parameters ||
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `stringMatcher` | `Matcher`:[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)of[String](https://developer.android.com/reference/java/lang/String.html)with text to match. |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withSubstring
```
Matcher withSubstring (String substring)
```
Returns a matcher that matches[TextView](https://developer.android.com/reference/android/widget/TextView.html)that contains the specific substring.
**Note:** View's sugar for`withText(containsString("string"))`.
| Parameters ||
|-------------|-------------------------------------------------------------------------------------------------------------------------|
| `substring` | `String`:[String](https://developer.android.com/reference/java/lang/String.html)that is expected to be contained |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withTagKey
```
Matcher withTagKey (int key)
```
Returns a matcher that matches[View](https://developer.android.com/reference/android/view/View.html)based on tag keys.
| Parameters ||
|-------|------------------------|
| `key` | `int`: to match |
| Returns ||
|-------------------------------------------------------------------------------------|--------|
| `Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | |
### withTagKey
```
Matcher withTagKey (int key,
Matcher