Android Unit Testing with Coroutines

Adalberto Plaza
Jan 26 · 3 min read

If you are here, I assume you are already familiar with Unit Testing on Android, but you are wondering why your tests fail when running coroutines. If you need more info about Unit Testing, pelase refer to my testing series:

When comes to testing functions which are using coroutines, the main problem is that they are handling thread switching, asynchronous calls and/or using different dispatchers. However, our test functions are run without being aware of the concurrency because they run over a single thread. Furthermore, there are a specific dispatcher (MainDispatcher) using the Android UI Thread, which is not available in unit tests.

Fortunately, fixing these issues with coroutines is pretty simple since they actually provides some easy mechanisms developed for testing purposes.


We need a couple of extra dependencies for testing:

The first one will provide a rule to be able to instantly run tasks in a synchronous executor while the second one provides the different tools we are about to use to run coroutines in tests.


Here is the rule we are talking about. It just specify to the test class to use the instant task executor instead of waiting for background jobs in Architecture Components.
The second rule is used to replace the Main dispatcher by a testing one. So we can test classes which are using it without having to do anything else. For example ViewModels.
Notice that, MainCoroutineScopeRule is a customised TestWatcher, so we can replace the MainDispatcher there.

Testing ViewModels

Let’s see a complete example, following my previous MVVM and coroutines post.

So the test should look like

As you can see the test is pretty much the same than a regular tests with no coroutines. We have just added the special rules to replace the Dispatcher.Main that viewModelScope is using, so it’s run on the test one.
The code is self-explicative, but we have just prepared the mock data we need and checked the UIStates are empty. After that, we have called the main function on the ViewModel and checked the correct UIStates again.

Testing suspend functions

If you haven’t “cheated” with my code (as I did) probably you observed an error in compile time. This is because actually was a suspend function and we are not calling it from a CoroutineScope in the test.

How can we solve that? pretty easy!

Do yu remember that we have a MainCoroutineScopeRule right? Let’s use that scope to call suspend functions in tests! (See Bonus example)


Probably in suspend functions you are specifying the dispatcher in which you want to run the code. Well, if you do that, then the code inside it is not testable because we are replacing the Main dispatcher but no the other ones. Instead of that, is better if you follow a better pattern and inject the dispatchers to make them replaceable in tests. (And also to follow better practises). Let’s see an example of how to properly call suspend functions in tests.

Here is the DispatcherProvider to inject the dispathcer in our classes.

And this is how we could use it in a repository which is using the context of the io scope. So instead of using withContext(Dispatchers.IO) { ... } we use the provider.

And finally, this is how the test will look. Notice that:

  • The test is run in mainCoroutineScopeRule.runBlockingTestto be able to call suspend funtions. Besides it blocks the thread until the test has finished.
  • We are injecting a testing dispatcher provider which ALWAYS returns the testDispatcher


Testing coroutines could seem like a complex task to do, but after you succeed with your first test, you can see the configuration and the development of tests is pretty similar to how it it with regular calls!

News and stories from the team at Degoo.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store