1. Tutorials
  2. Android

Android Unit Test Handle Expected Exception (Kotlin)

March 7, 2019

Solution 1: expected

Great for simple cases.

@Test(expected = IndexOutOfBoundsException::class)
fun testException() {
    val items = listOf(1, 2, 3)
    val value = items[10]
}

Solution 2: ExpectedException Rule

Sometimes detecting an exception class is not sufficient, where I need to

  • Detect the exception which cause this exception
  • Check the message of the exception
@Rule
@JvmField
val expectedException = ExpectedException.none()    

fun expectFirestorePermissionDenied() {
    expectedException.expect(ExecutionException::class.java)
    expectedException.expectCause(isA(FirebaseFirestoreException::class.java))
    expectedException.expectMessage(StringContains("PERMISSION_DENIED"))
}

@Test
fun createUserByPublic() {
    val task = db.collection("users")
        .document("test_create_user_public")
        .set(mapOf("roles" to listOf("user")))

    expectFirestorePermissionDenied()
    Tasks.await(task, 10, TimeUnit.SECONDS)
}

Solution 3: Try Catch

@Test
fun testExceptionWithTryCatch() {
    try {
        val items = listOf(1, 2, 3)
        val value = items[10]
        fail("IndexOutOfBoundsException expected")
    } catch (e: IndexOutOfBoundsException) {
        assertThat(e.message, StringContains("Invalid index"))
    }
}

References:

❤️ Is this article helpful?
Buy me a coffee☕ or support my work to keep this space 🖖 and ad-free.
If you can't, do send some 💖 to @d_luaz or help to share this article.
👶 Apps I built
Pixtory App (Alpha) - easily organize photos on your phone into a blog.
COVID-19 - data, chart, information & news.
暖心芽 (WIP) 🌞❤️🌱 - reminder of hope, warmth, thoughts and feelings.
Travelopy - travel discovery and journal
LuaPass - offline password manager
WhatIDoNow - a public log of things I am working on now
By Desmond Lua
A dream boy who enjoys programming and travelling, maker of Travelopy. Follow me on @d_luaz.
This work is licensed under a
Creative Commons Attribution-NonCommercial 4.0 International License.