Discovering Espresso for Android: implementing CountingIdlingResource
This post shows how to use Espresso IdlingResource that keeps a counter to determine application under test idleness. Such IdlingResource is called CountingIdlingResource and is used to controll test access to the application UI. When the counter is 0 – it is considered to be idle, when it is non-zero it is not idle. This is very similar to the way a
The counter may be incremented or decremented from any thread. If it reaches an illogical state (like counter less than zero) it will throw an
IllegalStateException. This class can then be used to wrap up operations that while in progress should block tests from accessing the UI.
At second, why do I need it? Espresso developers claim that using their test framework you can “Leave your waits, syncs, sleeps, and polls behind and let Espresso gracefully manipulate and assert on the application UI when it is at rest.” This is true, BUT if you are using
AsyncTask while performing the network calls.
If your application under test doesn’t use for some reason
AsyncTask and uses
ThreadPoolExecutor for network calls. Then this is your case.
It is really pretty easy to register CountingIdlingResource for this thread pool in your test package having getter and setter for the
ThreadPoolExecutor instance in main app. The only requirement is to make this instance static to be able to set it from your test package. Below is an example how getter and setter look like in mine code:
Then in your test package you can do the following :
- Create your custom
CountingIdlingResourceclass which extends
ThreadPoolExecutorand increase the thread counter every time you hit it.
afterExecute(…)method to be able to decrease the thread counter when call finished and notify the Espresso when the thread counter is equal to zero that you are
- What I also find useful is to have method in this class that registers
CountingIdlingResourcefor Espresso –
After you made all these steps then registering of
CountingIdlingResource looks really easy. Register it in your
setUp() method like that:
And here is small but useful tip – I use the static boolean flag variable to check if I’ve already register the same CountingIdlingResource for my test suite. If yes then I simply skip it the next time.
As you may know, Espresso can ignore
registerIdlingResources() with the same names but in mine setup I don’t want to create once again instances of
MyCustomPoolRequestHelper which is different from that one which was registered at first step and can cause test failure.