{% setvar book_path %}/reference/kotlin/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}

RecyclerViewActions.PositionableRecyclerViewAction

interface RecyclerViewActions.PositionableRecyclerViewAction : ViewAction

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 functions
`RecyclerViewActions.PositionableRecyclerViewAction!`	`atPosition(position: Int)` Returns a new ViewAction which will cause the ViewAction to operate upon the position-th element which the matcher has selected.

Inherited functions

From class androidx.test.espresso.ViewAction

`Matcher<View!>!`	`getConstraints()`
`String!`	`getDescription()`
`Unit`	`perform(uiController: UiController!, view: View!)`

Public functions

atPosition

fun atPosition(position: Int): RecyclerViewActions.PositionableRecyclerViewAction!

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

Parameters
`position: Int`	a 0-based index into the list of matching elements within the RecyclerView.

Returns
`RecyclerViewActions.PositionableRecyclerViewAction!`	PositionableRecyclerViewAction a new ViewAction focused on a particular position.

Throws
`java.lang.IllegalArgumentException: java.lang.IllegalArgumentException`	if position <0.