Kotlin Academy · Lezione

Scrittura di test con JUnit5

Strutturi i test

Scrittura di test con JUnit5 è una lezione Kotlin Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Kotlin Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Kotlin Academy include 4 lezioni in totale.

Che cos'è JUnit5?

JUnit5 (JUnit Jupiter) è il framework di test standard per la JVM e Kotlin. Fornisce annotazioni per contrassegnare e strutturare il codice dei test.

I test si trovano in src/test/kotlin
Ogni test è una funzione
Il runner li esegue e comunica i risultati

Aggiunta della dipendenza

Aggiunga JUnit Jupiter alla configurazione dei test e abiliti la piattaforma JUnit.

dependencies {
    testImplementation("org.junit.jupiter:junit-jupiter:5.10.2")
}

tasks.test {
    useJUnitPlatform()
}

Il primo test

Annoti una funzione con @Test. Un test verifica una proprietà del codice.

import org.junit.jupiter.api.Test
import org.junit.jupiter.api.Assertions.assertEquals

class MathTest {
    @Test
    fun addsTwoNumbers() {
        assertEquals(4, 2 + 2)
    }
}

Nomi descrittivi dei test

Usi @DisplayName per ottenere report di test leggibili senza dover usare nomi di funzione lunghi.

import org.junit.jupiter.api.Test
import org.junit.jupiter.api.DisplayName

class OrderTest {
    @Test
    @DisplayName("total includes tax")
    fun totalWithTax() {
        // ...
    }
}

Configurazione con @BeforeEach

@BeforeEach viene eseguito prima di ogni test, ed è ideale per creare fixture nuove. @AfterEach viene eseguito dopo ogni test per le operazioni di pulizia.

import org.junit.jupiter.api.BeforeEach

class CartTest {
    private lateinit var cart: MutableList<String>
    @BeforeEach
    fun setUp() {
        cart = mutableListOf()
    }
}

Configurazione a livello di classe

@BeforeAll e @AfterAll vengono eseguiti una volta per l'intera classe. In Kotlin richiedono un companion object con @JvmStatic (oppure un ciclo di vita per classe).

import org.junit.jupiter.api.BeforeAll

class DbTest {
    companion object {
        @BeforeAll
        @JvmStatic
        fun connect() {
            // open shared connection
        }
    }
}

Arrange-Act-Assert

Strutturi ogni test in tre fasi chiare:

Arrange — prepari gli input e lo stato
Act — invochi il codice sottoposto al test
Assert — verifichi il risultato

In questo modo i test rimangono leggibili e focalizzati.

Test annidati

@Nested raggruppa i test correlati, producendo un report strutturato ad albero che documenta il comportamento.

import org.junit.jupiter.api.Nested
import org.junit.jupiter.api.Test

class StackTest {
    @Nested
    inner class WhenEmpty {
        @Test fun isEmpty() { /* ... */ }
    }
}

Test parametrizzati

Esegua lo stesso test con più input usando @ParameterizedTest e una sorgente di valori.

import org.junit.jupiter.params.ParameterizedTest
import org.junit.jupiter.params.provider.ValueSource
import org.junit.jupiter.api.Assertions.assertTrue

class NumberTest {
    @ParameterizedTest
    @ValueSource(ints = [2, 4, 6])
    fun isEven(n: Int) {
        assertTrue(n % 2 == 0)
    }
}

Disattivazione e assegnazione di tag

Salti temporaneamente un test con @Disabled e raggruppi i test con @Tag, così da poterli includere o escludere nelle esecuzioni CI.

import org.junit.jupiter.api.Disabled
import org.junit.jupiter.api.Tag
import org.junit.jupiter.api.Test

class FlakyTest {
    @Test
    @Disabled("fix later")
    @Tag("slow")
    fun pending() { }
}

Un esempio autonomo

Ecco una semplice funzione pure-Kotlin e l'idea alla base del suo test (il test viene eseguito da JUnit).

fun add(a: Int, b: Int): Int = a + b

fun main() {
    val result = add(2, 3)
    println(if (result == 5) "PASS" else "FAIL")
}

Verifica rapida

Prima di ogni singolo metodo di test è necessario disporre di un elenco vuoto e nuovo. Quale annotazione è adatta?

Riepilogo

È in grado di strutturare i test JUnit5:

@Test contrassegna i test, mentre @DisplayName assegna loro un nome
@BeforeEach / @BeforeAll gestiscono la configurazione iniziale
Arrange-Act-Assert mantiene chiari i test
@Nested e @ParameterizedTest organizzano e scalano i test

Prossimo argomento: le asserzioni.

Domande Frequenti

La lezione «Scrittura di test con JUnit5» è gratuita?

Sì — il testo completo di «Scrittura di test con JUnit5» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Kotlin Academy, passa a CoddyKit PRO. Il corso Kotlin Academy include 4 lezioni in totale.

Cosa imparerò in «Scrittura di test con JUnit5»?

Strutturi i test Eserciti Kotlin Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Kotlin Academy?

Non è richiesta alcuna esperienza precedente. Kotlin Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Scrittura di test con JUnit5»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Kotlin Academy?

Sì. Ogni lezione Kotlin Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Kotlin Academy