kotlin-test/kotlin.test/assertFails

assertFails

@JvmName(name = "assertFailsInline")
inline fun assertFails(block: () -> Unit): Throwable(source)

Asserts that given function block fails by throwing an exception.

Since Kotlin

1.0

Return

An exception that was expected to be thrown and was successfully caught. The returned exception can be inspected further, for example by asserting its property values.

@JvmName(name = "assertFailsInline")
inline fun assertFails(message: String?, block: () -> Unit): Throwable(source)

Asserts that given function block fails by throwing an exception.

If the assertion fails, the specified message is used unless it is null as a prefix for the failure message.

Since Kotlin

1.1

Return

An exception that was expected to be thrown and was successfully caught. The returned exception can be inspected further, for example by asserting its property values.