JUnit Test d'exception attendu : @Test (attendu)

JUnit offre la possibilité de trace l'exception et aussi pour vérifier si le code lève l'exception attendue ou non.

JUnit La section 4 offre une méthode simple et lisible pour tester les exceptions. Vous pouvez utiliser :

• Le paramètre optionnel (attendu) de Annotation @Test et
• À tracà partir de ces informations, la fonction « fail() » peut être utilisée.

Si vers les tests En cas d'exception, vous devez vous assurer que la classe d'exception que vous fournissez dans ce paramètre optionnel de Annotation @Test est la même que celle que la méthode lève réellement. Cela s'explique par le fait que vous attendez une exception de la méthode que vous utilisez. tests unitaires; sinon notre JUnit le test échouerait.

Exemple : @Test(expected = IllegalArgumentException.class)

En utilisant le paramètre « expected », vous pouvez spécifier le nom de l'exception que notre test peut lever. Dans l'exemple ci-dessus, vous utilisez «Exception d'argument illégal", qui sera levée par le test si un développeur utilise un argument non autorisé.

Exemple utilisant @Test(expected)

Comprenons les tests d'exceptions en créant un Java classe avec une méthode qui lève une exception exceptionVous gérerez et testerez cela dans une classe de test. Considérez JUnitLe fichier Message.java contient une méthode effectuant une opération mathématique. La division à la ligne 14 divise par zéro, ce qui provoque systématiquement une exception « ArithmeticException ». Voir ci-dessous :

package guru99.junit;

public class JUnitMessage{

	private String message;

	public JUnitMessage(String message) {
		this.message = message;
	}

public void printMessage(){

	System.out.println(message); 
	int divide=1/0;

}

public String printHiMessage(){ 

	message="Hi!" + message;
	
	System.out.println(message);

	return message;
}

}

Code Explication:

• Code Ligne 7: Création d'un constructeur paramétré avec initialisation de champ.
• Code Ligne 11-14: Création d'une méthode pour l'opération mathématique.
• Code Ligne 18: Création d'une autre méthode pour imprimer un message.
• Code Ligne 20: Création d'une nouvelle chaîne pour imprimer un message.
• Code Ligne 22: Impression du nouveau message créé à la ligne 20.

Créons une classe de test pour ce qui précède. Java classe pour vérifier l'exception.

Vous trouverez ci-dessous la classe de test qui teste unitairement l'exception (ici ArithmeticException) levée par l'opération ci-dessus. Java classe:

AirthematicTest.java

La capture d'écran ci-dessous montre le même test dans l'éditeur, où le fichier est enregistré sous le nom AirthematicTest1, avec le paramètre attendu mis en évidence à la ligne 13 :

package guru99.junit;

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class AirthematicTest {

	public String message = "Saurabh";
	
	JUnitMessage junitMessage = new JUnitMessage(message);
	
	@Test(expected = ArithmeticException.class)
	public void testJUnitMessage(){

		System.out.println("Junit Message is printing ");
		junitMessage.printMessage();

	}

	@Test
	public void testJUnitHiMessage(){ 
		message="Hi!" + message;
		System.out.println("Junit Message is printing ");
		assertEquals(message, junitMessage.printHiMessage());
	
	}
}

Code Explication:

• Code Ligne 13: Nous utilisons l'annotation `@Test` pour créer notre test. Lorsque vous exécutez la méthode de la classe ci-dessus, elle effectue une opération mathématique. Une exception `ArithmeticException` est attendue ; vous la spécifiez donc comme paramètre dans `@Test`.
• Code Ligne 17: Appel de printMessage() depuis JUnitMessage.java.
• Code Ligne 21-22: Création d'une autre méthode de test pour vérifier le message « Salut », cette fois sans paramètre attendu.

La classe contient deux méthodes de test, donc une seule exécution les exécute toutes les deux : celle qui s’attend à une exception ArithmeticException et celle qui vérifie la chaîne de caractères renvoyée.

À noter: Cet exemple apparaît sous trois noms différents dans le document original : la liste des éléments mentionne la classe AirthematicTest, la capture d’écran de l’éditeur affiche AirthematicTest1 et l’affichage des résultats indique JunitTestExample. Le code est identique dans chaque cas ; seul le nom du fichier diffère.

Exécutons-le et vérifions le résultat. JUnit Le rapport ci-dessous indique l'exécution de Exemple de test Junit.java.

Sortie :

Voici le résultat, qui montre un test réussi sans aucun échec. trace comme indiqué ci-dessous :

Les deux méthodes sont validées. La première réussit car l'exception ArithmeticException qu'elle a déclarée a bien été levée, et la seconde réussit car la chaîne renvoyée correspond. Si la division n'avait jamais été levée, JUnit la première méthode aurait échoué avec le message « Exception attendue : java.lang.ArithmeticException ».

Trois façons de tester une exception dans JUnit 4

Le paramètre attendu est le plus court des trois JUnit Il existe quatre expressions idiomatiques, mais ce n'est pas toujours la bonne. Le tableau les compare en fonction des deux questions qui déterminent le choix : pouvez-vous affirmer quoi que ce soit du message, et savez-vous quelle ligne a été prononcée ?

La fonction `fail()` mentionnée dans l'introduction se présente comme suit : si l'appel ne génère pas d'exception, `fail()` s'exécute et le test renvoie le message que vous avez écrit.

@Test
public void testDivideByZero() {
    try {
        junitMessage.printMessage();
        fail("Expected an ArithmeticException");
    } catch (ArithmeticException e) {
        assertEquals("/ by zero", e.getMessage());
    }
}

La règle ExpectedException se situe entre les deux. Elle a été dépréciée dans JUnit 4.13 en faveur de la méthode assertThrows décrite ci-après, donc nouvelle JUnit 4 tests ne devraient pas l'adopter.

Comment tester les exceptions dans JUnit 5 avec assertThrows()

JUnit 5 supprime complètement le paramètre attendu de @Test. Jupiter fournit assertThrows ()Cette fonction prend en paramètres la classe d'exception et une lambda contenant le code testé. Elle renvoie l'exception interceptée, permettant ainsi de récupérer ultérieurement le message, la cause et tout champ personnalisé.

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;
import org.junit.jupiter.api.Test;

public class AirthematicJupiterTest {

    JUnitMessage junitMessage = new JUnitMessage("Saurabh");

    @Test
    public void testJUnitMessage() {
        ArithmeticException thrown = assertThrows(
                ArithmeticException.class,
                () -> junitMessage.printMessage());
        assertEquals("/ by zero", thrown.getMessage());
    }
}

Trois liens affirmations compléter la famille :

• assertThrows accepte le type d'exception ou toute sous-classe de celui-ci.
• assertThrowsExactly rejette une sous-classe, donc seul le type nommé est accepté.
• assertDoesNotThrow énonce l'attente inverse, à savoir que le bloc se termine proprement.

Le JUnit 4 lignes de code sur cette page s'exécutent toujours sur le JUnit La plateforme utilise le moteur d'origine, donc rien de ce qui précède n'a besoin d'être réécrit pour continuer à fonctionner pendant la migration d'un projet.

Erreurs courantes lors du test des exceptions dans JUnit

Les tests d'exception échouent de quelques manières facilement identifiables. Chaque ligne indique le symptôme, la cause et la solution.

C’est la dernière ligne qui pose le plus de problèmes lors d’une migration, car les deux annotations portent le nom @Test et seule l’importation permet de les distinguer. Keeping UN JUnit version par cas de test Cette classe permet d'éviter tout le problème de classe.

FAQ