# RecyclerViewActions Summary:[Nested Classes](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#nestedclasses)\|[Methods](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#) # RecyclerViewActions | 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 RecyclerViewActions ` ` 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.contrib.RecyclerViewActions |
*** ** * ** *** [ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)s to interact[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView). RecyclerView works differently than[AdapterView](https://developer.android.com/reference/android/widget/AdapterView.html). In fact, RecyclerView is not an AdapterView anymore, hence it can't be used in combination with[onData(Matcher)](https://developer.android.com/reference/android/support/test/espresso/Espresso#onData(org.hamcrest.Matcher)). To use[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)s in this class use[onView(Matcher)](https://developer.android.com/reference/android/support/test/espresso/Espresso#onView(org.hamcrest.Matcher))with a[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches your[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView), then perform a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)from this class. ## Summary | ### Nested classes || |--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` interface` | [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) Most RecyclerViewActions are given a matcher to select a particular view / viewholder within the RecyclerView. | | ### Public methods || |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` static `[RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) | ` `[actionOnHolderItem](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#actionOnHolderItem(org.hamcrest.Matcher, android.support.test.espresso.ViewAction))`(Matcher viewHolderMatcher, `[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)` viewAction) ` Performs a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)on a view matched by viewHolderMatcher. | | ` static `[RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) | ` `[actionOnItem](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#actionOnItem(org.hamcrest.Matcher, android.support.test.espresso.ViewAction))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> itemViewMatcher, `[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)` viewAction) ` Performs a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)on a view matched by viewHolderMatcher. | | ` static `[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction) | ` `[actionOnItemAtPosition](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#actionOnItemAtPosition(int, android.support.test.espresso.ViewAction))`(int position, `[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)` viewAction) ` Performs a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)on a view at position. | | ` static `[RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) | ` `[scrollTo](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#scrollTo(org.hamcrest.Matcher))`(Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`> itemViewMatcher) ` Returns a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)which scrolls[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)to the view matched by itemViewMatcher. | | ` static `[RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) | ` `[scrollToHolder](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#scrollToHolder(org.hamcrest.Matcher))`(Matcher viewHolderMatcher) ` Returns a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)which scrolls[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)to the view matched by viewHolderMatcher. | | ` static `[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction) | ` `[scrollToPosition](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#scrollToPosition(int))`(int position) ` Returns a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)which scrolls[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)to a position. | | ### Inherited methods | |-----------------------|---| | [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions#)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 ### actionOnHolderItem ``` RecyclerViewActions.PositionableRecyclerViewAction actionOnHolderItem (Matcher viewHolderMatcher, ViewAction viewAction) ``` Performs a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)on a view matched by viewHolderMatcher. 1. Scroll Recycler View to the view matched by itemViewMatcher 2. Perform an action on the matched view Note: actionOnItem method is not overloaded, method overloading with generic parameters is not possible.

| Parameters || |---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `viewHolderMatcher` | `Matcher`: a[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches an item view holder in[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)
| | `viewAction` | `ViewAction`: the action that is performed on the view matched by viewHolderMatcher
| | Returns || |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) |
| | Throws || |------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| | [PerformException](https://developer.android.com/reference/android/support/test/espresso/PerformException) | if there are more than one items matching given viewHolderMatcher. | ### actionOnItem ``` RecyclerViewActions.PositionableRecyclerViewAction actionOnItem (Matcher itemViewMatcher, ViewAction viewAction) ``` Performs a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)on a view matched by viewHolderMatcher. 1. Scroll Recycler View to the view matched by itemViewMatcher 2. Perform an action on the matched view

| Parameters || |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `itemViewMatcher` | `Matcher`: a[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches an item view in[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)
| | `viewAction` | `ViewAction`: the action that is performed on the view matched by itemViewMatcher
| | Returns || |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) |
| | Throws || |------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| | [PerformException](https://developer.android.com/reference/android/support/test/espresso/PerformException) | if there are more than one items matching given viewHolderMatcher. | ### actionOnItemAtPosition ``` ViewAction actionOnItemAtPosition (int position, ViewAction viewAction) ``` Performs a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)on a view at position. 1. Scroll Recycler View to position 2. Perform an action on the view at position

| Parameters || |--------------|-----------------------------------------------------------------------------------------------------------------------------------| | `position` | `int`: position of a view in[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)
| | `viewAction` | `ViewAction`: the action that is performed on the view matched by itemViewMatcher
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction) |
| ### scrollTo ``` RecyclerViewActions.PositionableRecyclerViewAction scrollTo (Matcher itemViewMatcher) ``` Returns a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)which scrolls[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)to the view matched by itemViewMatcher. This approach uses[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)s to find the target view. It will create one ViewHolder per item type and bind adapter data to the ViewHolder. If the itemViewMatcher matches a ViewHolder the current position of the View is used to perform a[scrollToPosition(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView#scrollToPosition(int)).
| Parameters || |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `itemViewMatcher` | `Matcher`: a[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches an item view in[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)
| | Returns || |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) |
| | Throws || |------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| | [PerformException](https://developer.android.com/reference/android/support/test/espresso/PerformException) | if there are more than one items matching given viewHolderMatcher. | ### scrollToHolder ``` RecyclerViewActions.PositionableRecyclerViewAction scrollToHolder (Matcher viewHolderMatcher) ``` Returns a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)which scrolls[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)to the view matched by viewHolderMatcher. This approach uses[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)s to find the target view. It will create one ViewHolder per item type and bind adapter data to the ViewHolder. If the itemViewMatcher matches a ViewHolder the current position of the View is used to perform a[scrollToPosition(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView#scrollToPosition(int)). Note: scrollTo method is not overloaded, method overloading with generic parameters is not possible.
| Parameters || |---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `viewHolderMatcher` | `Matcher`: a[`Matcher `](http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matcher.html)that matches an item view holder in[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)
| | Returns || |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) |
| | Throws || |------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| | [PerformException](https://developer.android.com/reference/android/support/test/espresso/PerformException) | if there are more than one items matching given viewHolderMatcher. | ### scrollToPosition ``` ViewAction scrollToPosition (int position) ``` Returns a[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)which scrolls[RecyclerView](https://developer.android.com/reference/android/support/v7/widget/RecyclerView)to a position.
| Parameters || |------------|-----------------------------------------------------| | `position` | `int`: the position of the view to scroll to
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction) |
| - ## Interfaces - [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) - ## Classes - [AccessibilityChecks](https://developer.android.com/reference/android/support/test/espresso/contrib/AccessibilityChecks) - [ActivityResultMatchers](https://developer.android.com/reference/android/support/test/espresso/contrib/ActivityResultMatchers) - [DrawerActions](https://developer.android.com/reference/android/support/test/espresso/contrib/DrawerActions) - [DrawerMatchers](https://developer.android.com/reference/android/support/test/espresso/contrib/DrawerMatchers) - [NavigationViewActions](https://developer.android.com/reference/android/support/test/espresso/contrib/NavigationViewActions) - [PickerActions](https://developer.android.com/reference/android/support/test/espresso/contrib/PickerActions) - [RecyclerViewActions](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions) - [ViewPagerActions](https://developer.android.com/reference/android/support/test/espresso/contrib/ViewPagerActions)