Kotlin
@BeforeEach
Learn fixtures with @BeforeEach and @AfterEach.
@BeforeEach / @AfterEach
The @BeforeEach annotation marks a method that runs before each test method. @AfterEach runs after each test. They are used to do the common setup and teardown for tests; so each test starts from a clean state.
class CalculatorTest {
lateinit var c: Calculator
@BeforeEach
fun setup() { c = Calculator() }
@AfterEach
fun cleanup() { /* clean up */ }
}
Here a fresh Calculator instance is created before each test; after the test cleanup runs. This prevents tests from affecting each other. lateinit var is handy for variables assigned in setup; accessing it before assignment throws an exception.
The setup and teardown pattern
Common setup ensures each test starts from the same state. For example a database connection, file or list is prepared before each test; after the test it is closed or cleaned. This keeps tests independent and repeatable.
@BeforeEach
fun setup() {
counter = 0
}
@Test
fun test1() {
counter++
assertEquals(1, counter)
}
Here counter is reset before each test; so test1 and test2 do not affect each other. The setup method is usually called setup, the teardown method cleanup or teardown. For heavy resources (database, network) it is important to consider setup cost.
Exercise Apply the beforeEach pattern
Define class Calculator; inside it add var total: Int = 0 and fun add(n: Int) { total += n }. Then define a helper fun beforeEach(c: Calculator) whose body does c.total = 0. In main create val c = Calculator(); call beforeEach(c); c.add(5); check(c.total == 5); call beforeEach(c); c.add(3); check(c.total == 3); print println("all passed").
Show example solution
fun beforeEach(c: Calculator) { c.total = 0 }
fun main() {
val c = Calculator()
beforeEach(c)
c.add(5)
check(c.total == 5)
beforeEach(c)
c.add(3)
check(c.total == 3)
println("all passed")
}
Test yourself
-
When does @BeforeEach run?
- Once before all tests
- Once after all tests
- After each test
- Before each test
Show answer
Before each test — @BeforeEach runs before each test method.
-
Match the setup/teardown concepts
- @BeforeEach
- Before each test
- @AfterEach
- After each test
- setup()
- Setup method
- cleanup()
- Teardown method
-
The setup annotation
____
fun setup() { c = Calculator() }
Show answer
@BeforeEach
fun setup() { c = Calculator() }
Next lesson: MockK
