# RecyclerViewActions.PositionableRecyclerViewAction

Summary:[Methods](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction#)  

# RecyclerViewActions.PositionableRecyclerViewAction

| 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
static


interface
RecyclerViewActions.PositionableRecyclerViewAction
`  
`


implements

`[ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)`


`

|------------------------------------------------------------------------------------------|
| android.support.test.espresso.contrib.RecyclerViewActions.PositionableRecyclerViewAction |

<br />

*** ** * ** ***

Most RecyclerViewActions are given a matcher to select a particular view / viewholder within the RecyclerView. In this case the default behaviour is to expect that the matcher matches 1 and only one item within the RecyclerView.

This interface gives users the ability to override that type of behaviour and explicitly select an item in the RecyclerView at a given position. This is similar to on the onData(...).atPosition() api for AdapterViews.

## Summary

|                                                                                                                                                                                                                                                   ### Public methods                                                                                                                                                                                                                                                    ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` abstract `[RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) | ` `[atPosition](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction#atPosition(int))`(int position) ` Returns a new ViewAction which will cause the ViewAction to operate upon the position-th element which the matcher has selected. |

| ### Inherited methods |
|-----------------------|---|
| [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction#)From interface` `[android.support.test.espresso.ViewAction](https://developer.android.com/reference/android/support/test/espresso/ViewAction)` ` |-----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract Matcher<`[View](https://developer.android.com/reference/android/view/View.html)`>` | ` `[getConstraints](https://developer.android.com/reference/android/support/test/espresso/ViewAction#getConstraints())`() ` A mechanism for ViewActions to specify what type of views they can operate on.                                                                                                                                                                                                         | | ` abstract `[String](https://developer.android.com/reference/java/lang/String.html)           | ` `[getDescription](https://developer.android.com/reference/android/support/test/espresso/ViewAction#getDescription())`() ` Returns a description of the view action.                                                                                                                                                                                                                                              | | ` abstract void`                                                                              | ` `[perform](https://developer.android.com/reference/android/support/test/espresso/ViewAction#perform(android.support.test.espresso.UiController, android.view.View))`(`[UiController](https://developer.android.com/reference/android/support/test/espresso/UiController)` uiController, `[View](https://developer.android.com/reference/android/view/View.html)` view) ` Performs this action on the given view. | ||

## Public methods

### atPosition

```
RecyclerViewActions.PositionableRecyclerViewAction atPosition (int position)
```

Returns a new ViewAction which will cause the ViewAction to operate upon the position-th element which the matcher has selected.

<br />

|                                              Parameters                                               ||
|------------|-------------------------------------------------------------------------------------------|
| `position` | `int`: a 0-based index into the list of matching elements within the RecyclerView. <br /> |

|                                                                                                                                     Returns                                                                                                                                      ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------|
| [RecyclerViewActions.PositionableRecyclerViewAction](https://developer.android.com/reference/android/support/test/espresso/contrib/RecyclerViewActions.PositionableRecyclerViewAction) | PositionableRecyclerViewAction a new ViewAction focused on a particular position. <br /> |

|                                                             Throws                                                             ||
|-------------------------------------------------------------------------------------------------------------|-------------------|
| [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException.html) | if position \< 0. |

-

  ## 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)