Guide to Interacting with ViewPager Items in Espresso

Guide to Interacting with ViewPager Items in Espresso

11 April 2024 Stephan Petzl Leave a comment Tech-Help

When testing an Android application with Espresso, developers often face the challenge of interacting with UI elements within a ViewPager. This guide will walk you through how to perform actions on a button within a ViewPager item, ensuring your UI tests are robust and reliable.

Understanding the ViewPager Structure

A ViewPager is a ViewGroup that allows the user to flip left and right through pages of data. Unlike an AdapterView, it doesn’t use an adapter for providing views, but rather manages a small number of child views directly. This distinction is crucial when attempting to interact with ViewPager elements in Espresso.

Interacting with ViewPager Items

To interact with the button in a ViewPager item, you must first understand that the onData() method is not suitable since ViewPager is not an AdapterView.

Solution 1: Using a Custom Matcher

The first solution involves creating a custom matcher to select the first child view of the ViewPager. By using hasDescendant() and isDescendantOfA(), you can target the specific view and perform an action on it. Here’s how you can achieve this:

    onView(allOf(withId(, isDescendantOfA(firstChildOf(withId(

Solution 2: Targeting the Displayed View

The second and more straightforward solution takes advantage of the ViewPager’s behavior of displaying one item at a time. By using the view ID and adding the isDisplayed() constraint, Espresso will match only the view that is currently visible to the user. Here’s the simple command to click the button on the current page:

    onView(allOf(withId(, isDisplayed())).perform(click());

Switching Between ViewPager Items

If you need to interact with a button on a different item of the ViewPager, you can perform a swipe action to change the currently displayed item:


Additional Notes

It is important to note that the isDisplayed() matcher will select views that are partially displayed. For scenarios where you need to ensure the entire view is visible, use isCompletelyDisplayed() instead.

This guide should help you confidently interact with elements within a ViewPager during your Espresso tests, enhancing the reliability of your automated UI testing process.

Like this article? there’s more where that came from!