Formations — 1 037 leçons en français

Accueil › Java › Écrire ses premiers tests

Écrire ses premiers tests

Organisation et outilsdebutant

Un test unitaire vérifie automatiquement qu'un bout de code se comporte comme prévu, sans repasser à la main par l'application entière. JUnit Jupiter (ce qu'on appelle encore « JUnit 5 » par habitude, aujourd'hui distribué sous la version unifiée JUnit 6) est le moteur de test standard en Java :

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>6.1.3</version>
    <scope>test</scope>
</dependency>

Un test se structure en trois temps : Arrange (préparer), Act (appeler), Assert (vérifier) :

class CalculPrixTest {

    @Test
    @DisplayName("Une remise de 10% réduit bien le total")
    void appliquerRemise() {
        CalculPrix calcul = new CalculPrix();              // Arrange

        double resultat = calcul.appliquerRemise(100.0, 10); // Act

        Assertions.assertEquals(90.0, resultat);            // Assert
    }
}

@Test marque la méthode comme exécutable par le moteur de test. @DisplayName donne un nom lisible affiché dans les rapports. @BeforeEach/@AfterEach préparent ou nettoient un état commun avant/après chaque test. Pour vérifier qu'une exception est bien levée, on utilise assertThrows plutôt qu'un try/catch manuel, qui laisserait passer silencieusement l'absence d'exception.

Les termes à connaître

JUnit Jupiter

Le moteur de test le plus utilisé en Java (org.junit.jupiter.api), toujours désigné dans l'usage courant par son ancien nom de version, « JUnit 5 ». Depuis septembre 2025, il est distribué sous une version unifiée avec le reste du projet : JUnit 6 (actuellement 6.1.3, nécessite Java 17+).

@Test

Annotation qui marque une méthode comme un test exécutable. La méthode doit être publique ou package-private, sans paramètre, et ne rien renvoyer (void).

Assertion

Instruction qui vérifie qu'une valeur correspond à ce qui est attendu, et fait échouer le test sinon. Assertions.assertEquals(attendu, resultat) est la plus courante ; toute la classe Assertions s'importe statiquement en pratique.

Arrange / Act / Assert

Structure en trois temps d'un test : préparer les données et objets nécessaires, appeler le code testé, puis vérifier le résultat. Rend chaque test lisible même sans commentaire.

@BeforeEach / @AfterEach

Méthodes exécutées automatiquement avant (ou après) chaque test de la classe. Utile pour préparer un état commun et éviter de dupliquer la même initialisation dans chaque test.

assertThrows

Vérifie qu'un bloc de code lève bien une exception d'un type donné, et renvoie cette exception pour en inspecter le message. assertThrows(TypeException.class, () -> code()).

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.