JUnit - 2.1 Créer votre premier test JUnit

Un test unitaire vérifie qu'une méthode donne le résultat attendu pour une situation donnée. Cette leçon écrit un premier test étape par étape, pour des débutants en test unitaire. Le test suit le modèle Given, When, Then, qui découpe le code en trois parties claires.

Nommer le test selon le cas vérifié

Avant d'écrire le code du test, on renomme la méthode de test pour qu'elle décrive le cas vérifié. Un nom explicite indique tout de suite ce qui est testé, et ce qui échoue en cas de problème.

Given : préparer les données

La partie Given prépare les variables qui correspondent aux valeurs passées en paramètre à la méthode testée, comme la taille.

On crée aussi une variable qui représente la classe contenant la méthode à tester.

When et Then : appeler la méthode et vérifier le résultat

La partie When appelle la méthode avec les variables préparées. La partie Then compare le résultat obtenu à la valeur attendue, avec une méthode assert fournie par JUnit.

Le cas contraire, où le résultat attendu n'est pas obtenu, est vérifié dans la leçon suivante.

En résumé

Un test JUnit suit trois étapes : Given prépare les données, When appelle la méthode et Then vérifie le résultat. Un nom de méthode clair décrit le cas testé. Les assertions comparent le résultat obtenu à celui qui est attendu. La leçon suivante étudie le cas contraire.

Points clés

• Un test unitaire vérifie une méthode dans une situation donnée.
• Le nom de la méthode de test doit décrire le cas testé.
• Given prépare les variables qui servent de paramètres.
• When appelle la méthode à tester.
• Then vérifie le résultat avec une assertion de JUnit.

Questions fréquentes

Qu'est-ce qu'un test unitaire ?

C'est un test qui vérifie le comportement d'une méthode, isolément, pour une situation donnée.

Pourquoi renommer la méthode de test ?

Un nom qui décrit le cas testé permet de comprendre rapidement ce qui est vérifié, et ce qui échoue.

Que signifient Given, When et Then ?

Ce sont trois parties du test : préparer les données, appeler la méthode, puis vérifier le résultat.