Why Kotlin test assertions? - Purpose & Use Cases

The Big Idea

What if your code could tell you instantly when it breaks, without you lifting a finger?

The Scenario

Imagine you write a program and want to check if it works correctly. You try to remember all the results and check them by hand every time you change your code.

This is like grading your own homework without a checklist -- easy to miss mistakes!

The Problem

Manually checking results is slow and tiring. You might forget to check some cases or make mistakes yourself.

When your program grows, it becomes impossible to keep track of all checks without errors.

The Solution

Kotlin test assertions let you write small checks in your code that automatically confirm if things are right.

They tell you immediately if something breaks, saving time and catching errors early.

Before vs After

✗ Before

if (result == expected) {
    println("Test passed")
} else {
    println("Test failed")
}

✓ After

assertEquals(expected, result)

What It Enables

With Kotlin test assertions, you can quickly and reliably verify your code works as expected every time you change it.

Real Life Example

When building a calculator app, assertions check if adding or subtracting numbers gives the right answer automatically, so you don't have to test each button press yourself.

Key Takeaways

Manual checks are slow and error-prone.

Assertions automate correctness checks.

They help catch bugs early and save time.

Practice

1. Which Kotlin test assertion checks if two values are equal?

easy

A. assertEquals(expected, actual)

B. assertTrue(condition)

C. assertNull(value)

D. assertFails { block }

Solution

1. Step 1: Understand assertion types

   assertEquals is used to check if two values are equal.

2. Step 2: Match assertion to purpose

   assertTrue checks if a condition is true, assertNull checks for null, and assertFails checks for exceptions.

3. Final Answer:

   assertEquals(expected, actual) -> Option A

4. Quick Check:

   Equality check = assertEquals [OK]

Hint: Use assertEquals to compare expected and actual values [OK]

Common Mistakes:

• Confusing assertTrue with assertEquals
• Using assertNull for equality checks
• Using assertFails to check values

2. Which of the following is the correct syntax to assert a condition is true in Kotlin tests?

easy

A. assertTrue { condition }

B. assertTrue condition

C. assertTrue(condition)

D. assertTrue: condition

Solution

1. Step 1: Recall Kotlin assertion syntax

   assertTrue takes a Boolean condition as a parameter inside parentheses.

2. Step 2: Identify correct syntax

   Only assertTrue(condition) is valid Kotlin syntax; others are incorrect.

3. Final Answer:

   assertTrue(condition) -> Option C

4. Quick Check:

   assertTrue uses parentheses for condition [OK]

Hint: Remember assertions use parentheses for arguments [OK]

Common Mistakes:

• Using curly braces instead of parentheses
• Omitting parentheses
• Using colon instead of parentheses

3. What will be the result of this Kotlin test assertion?

val result = 5
assertEquals(5, result)

medium

A. Test passes without error

B. Test fails with AssertionError

C. Compilation error

D. Runtime exception other than AssertionError

Solution

1. Step 1: Check values compared

   The expected value is 5 and actual value stored in result is also 5.

2. Step 2: Understand assertEquals behavior

   Since both values are equal, assertEquals passes without throwing an error.

3. Final Answer:

   Test passes without error -> Option A

4. Quick Check:

   Equal values = test passes [OK]

Hint: Equal expected and actual means test passes [OK]

Common Mistakes:

• Assuming assertEquals throws error on equal values
• Confusing expected and actual order
• Thinking assertEquals returns a value

4. Identify the error in this Kotlin test assertion code:

assertEquals(10, 5 + 3)

medium

A. Runtime exception due to invalid operation

B. No error, test passes

C. Syntax error due to missing parentheses

D. Test fails because expected and actual differ

Solution

1. Step 1: Calculate actual value

   The expression 5 + 3 equals 8.

2. Step 2: Compare expected and actual

   Expected is 10 but actual is 8, so assertEquals fails and throws AssertionError.

3. Final Answer:

   Test fails because expected and actual differ -> Option D

4. Quick Check:

   Different values = test fails [OK]

Hint: Check actual calculation matches expected value [OK]

Common Mistakes:

• Assuming test passes despite value mismatch
• Thinking syntax error occurs
• Confusing runtime exceptions with assertion failures

5. You want to test that a function throws an exception when given invalid input. Which Kotlin assertion should you use?

hard

A. assertNull(function(invalidInput))

B. assertFails { function(invalidInput) }

C. assertEquals(exception, function(invalidInput))

D. assertTrue(function(invalidInput))

Solution

1. Step 1: Understand exception testing

   To check if a function throws an exception, use assertFails with a lambda calling the function.

2. Step 2: Evaluate other options

   assertEquals compares values, not exceptions; assertNull checks for null; assertTrue checks a Boolean condition.

3. Final Answer:

   assertFails { function(invalidInput) } -> Option B

4. Quick Check:

   Exception test = assertFails [OK]

Hint: Use assertFails with lambda to test exceptions [OK]

Common Mistakes:

• Using assertEquals to check exceptions
• Using assertNull expecting exception
• Using assertTrue for exception testing