Écrire des Tests Unitaires

La syntaxe générale pour écrire des tests unitaires dans Jest est expliquée dans la vidéo suivante :

Une version alternative de test est la fonction it, ayant une syntaxe identique, mais offrant une légère commodité en raison de son nom plus court.

La fonction test ou it a la syntaxe suivante :

• testDescription est une courte description de ce que le test concerne.
• callback est simplement une fonction inline qui contient le code du test.
• timeout est un argument optionnel, représentant une valeur en millisecondes. Si le test respectif prend plus de temps que cette durée, il est considéré comme un échec. Cette valeur est de 5000 ou 5 secondes par défaut.

Il est important de noter que plusieurs déclarations expect peuvent être incluses dans un seul cas de test :

Cela nous donne la capacité d'effectuer toutes sortes de tests de manière approfondie.

Dans le cas où vous devez effectuer des tests dans une langue différente, vous pouvez simplement consulter la documentation du framework de test utilisé, qui répertorie généralement toutes les méthodes disponibles pour les assertions.

La fonction expect attend un argument et la fonction expect elle-même renvoie un objet d'une classe appelée JestMatchers, qui possède des méthodes utiles pour effectuer des assertions. L'une de ces méthodes est toBe, que nous avons précédemment examinée. Le code suivant décompose la syntaxe :

L'exemple ci-dessus crée deux variables supplémentaires, à savoir, returnValue pour stocker le résultat de sum(-1, -2), et matcherObject pour stocker l'objet retourné par expect(returnValue).

Cependant, la syntaxe conventionnelle est plus courte et plus concise. Nous pouvons simplement appeler la fonction sum directement à l'intérieur des parenthèses expect, ce qui retourne le résultat calculé et le passe à son tour dans la fonction expect, éliminant ainsi le besoin d'une variable returnValue supplémentaire :

Nous pouvons encore raccourcir notre code en éliminant simplement la variable matcherObject. La fonction expect retourne l'objet matcher lui-même, donc la méthode toBe peut être exécutée directement à partir de celui-ci en conséquence :

La syntaxe mentionnée ci-dessus est la méthode conventionnelle pour écrire des assertions simples en utilisant Jest. La méthode toBe est connue sous le nom de Matcher, car elle correspond ou compare deux valeurs. Les Matchers sont fournis par l'objet Matcher retourné par la fonction expect.

Le matcher toBe compare strictement deux valeurs de tout type primitif.

Il existe de nombreux Matchers pour tester divers types de valeurs. Le matcher toBe est utilisé pour comparer des types primitifs comme les entiers, les flottants, les chaînes ou les caractères. Cependant, il n'est pas utilisable pour comparer des éléments plus compliqués comme les tableaux ou les objets car il n'effectue pas de comparaison approfondie.