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 classeAssertionss'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()).
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.