Tutoriel Jasmine Framework : tests unitaires avec exemple

Qu’est-ce que JasmineJS ?

Jasmine est un framework de test de bibliothèque JavaScript open source et le plus populaire pour tester tout type d'application JavaScript. Jasmine suit la procédure de développement piloté par le comportement (BDD) pour garantir que chaque ligne d'instruction JavaScript est correctement testée unitairement.

À quoi sert le framework Jasmine ?

Les tests sont un élément clé de toute application. Pour les tests unitaires NodeJS, le framework disponible pour les tests s'appelle Jasmine. Au début des années 2000, il existait un cadre pour tester JavaScript applications appelées JsUnit. Later ce framework a été mis à niveau et est maintenant connu sous le nom de Jasmine.

Jasmine aide à l'automatisation Tests unitaires, ce qui est devenu une pratique clé lors du développement et du déploiement d’applications Web modernes.

Dans ce didacticiel Jasmine, vous apprendrez comment configurer votre environnement avec Jasmine et comment exécuter des tests Jasmine pour votre première application Node.js.

Jasmine pour tester les applications Node.js

Jasmine est un Développement axé sur le comportement (BDD) cadre de test pour JavaScript. Cela fait ne sauraient s'appuyer sur les navigateurs, le DOM ou tout autre framework JavaScript. Ainsi, il convient aux sites Web, aux projets Node.js ou à tout autre endroit où JavaScript peut s'exécuter. Pour commencer à utiliser Jasmine, vous devez d'abord télécharger et installer les modules Jasmine nécessaires.

Comment configurer l'environnement de test Jasmine

Ensuite, dans ce didacticiel Jasmine Node JS, vous devrez initialiser votre environnement et inspecter le fichier de configuration Jasmine. Les étapes ci-dessous montrent comment configurer Jasmine dans votre environnement

Étape 1) Installer les modules NPM
Vous devez Installer NPM module jasmine pour utiliser le framework jasmine à partir d'une application Node. Pour installer le module jasmine-node, exécutez la commande ci-dessous.

npm installer le nœud jasmin

Étape 2) Initialiser l'environnement Jasmine
Initialisation du projet – En faisant cela, jasmine crée un répertoire de spécifications et un json de configuration pour vous. Le répertoire spec est utilisé pour stocker tous vos fichiers de test. En faisant cela, Jasmine saura où se trouvent tous vos tests et pourra ensuite les exécuter en conséquence. Le JSON Le fichier est utilisé pour stocker des informations de configuration spécifiques sur Jasmine.

Pour initialiser l'environnement Jasmine, exécutez la commande ci-dessous

jasmin initial

Étape 3) Inspectez votre fichier de configuration.
Le fichier de configuration sera stocké dans le dossier spec/support sous le nom de jasmine.json. Ce fichier énumère les fichiers sources et les fichiers de spécifications que vous souhaitez que le programme d'exécution Jasmine inclue.

La capture d'écran ci-dessous montre un exemple typique du fichier package.json pour jasmine.

Configurer l'environnement de test Jasmine

  1. Notez que le répertoire spec est spécifié ici. Comme indiqué précédemment, lorsque Jasmine s'exécute, il recherche tous les tests de ce répertoire.
  2. La prochaine chose à noter est le paramètre spec_files – Cela indique que quels que soient les fichiers de test créés, ils doivent être ajoutés au mot-clé « spec ».

Ensuite, dans ce didacticiel du framework Jasmine, nous apprendrons comment utiliser Jasmine pour tester les applications Node.js.

Comment utiliser Jasmine pour tester les applications Node.js

Afin d'utiliser les tests unitaires Jasmine pour les applications Node.js, une série d'étapes doivent être suivies.

Dans notre exemple ci-dessous, nous allons définir un module qui ajoute 2 nombres qu'il faut tester. Nous définirons ensuite un fichier de code séparé avec le code de test, puis utiliserons Jasmine pour tester la fonction Add en conséquence.

Étape 1) Définissez le code qui doit être testé. Nous allons définir une fonction qui ajoutera 2 nombres et renverra le résultat. Ce code va être écrit dans un fichier appelé « Add.js ».

Utilisez Jasmine pour tester les applications Node.js

var exports=module.exports={};
exports.AddNumber=function(a,b)
{
return a+b;
};

Explication du code

  1. Le mot-clé « exports » est utilisé pour garantir que la fonctionnalité définie dans ce fichier est effectivement accessible par d'autres fichiers.
  2. Nous définissons ensuite une fonction appelée « AddNumber ». Cette fonction est définie pour prendre 2 paramètres, a et b. La fonction est ajoutée au module « exports » pour faire de la fonction une fonction publique accessible par d'autres modules d'application.
  3. Nous faisons enfin en sorte que notre fonction renvoie la valeur ajoutée des paramètres.

Étape 2) Ensuite, nous devons définir notre code de test jasmine, qui sera utilisé pour tester notre fonction « Ajouter » dans le fichier Add.js. Le code ci-dessous doit être placé dans un fichier appelé add-spec.js.

Notes: – Le mot « spec » doit être ajouté au fichier de test afin qu'il puisse être détecté par jasmine.

Utilisez Jasmine pour tester les applications Node.js

Explication du code

var app=require("../Add.js");
describe("Addition",function(){
it("The function should add 2 numbers",function() {
var value=app.AddNumber(5,6);
expect(value).toBe(11);
});
});
  1. Nous devons d'abord inclure notre fichier Add.js afin de pouvoir tester la fonction 'AddNumber' dans ce fichier.
  2. Nous créons maintenant notre module de test. La première partie du module de test consiste à décrire une méthode qui donne essentiellement un nom à notre test. Dans ce cas, le nom de notre test est « Addition ».
  3. Le bit suivant consiste à donner une description de notre test en utilisant la méthode « it ».
  4. Nous invoquons maintenant notre méthode Addnumber et envoyons 2 paramètres 5 et 6. Ceci sera transmis à notre méthode Addnumber dans le fichier App.js. La valeur de retour est ensuite stockée dans une variable appelée valeur.
  5. La dernière étape consiste à faire la comparaison ou notre test réel. Puisque nous nous attendons à ce que la valeur renvoyée par la fonction Addnumber soit 11, nous la définissons en utilisant la méthode expect(value).toBe(la valeur attendue).

Sortie

  1. Pour exécuter le test, il faut exécuter la commande jasmine.
  2. La capture d'écran ci-dessous montre qu'une fois la commande jasmine exécutée, elle détectera qu'il existe un test appelé add-spec.js et exécutera ce test en conséquence. S'il y a des erreurs dans le test, elles seront affichées en conséquence.

Utilisez Jasmine pour tester les applications Node.js

Résumé

  • Afin de tester un Node.js application, le framework jasmine doit être installé en premier. Cela se fait en utilisant le gestionnaire de packages Node.
  • Le code du test doit être écrit dans un fichier séparé et le mot « spec » doit être ajouté au nom du fichier. Ce n'est que si cela est fait que Jasmine pourra détecter qu'un fichier doit être exécuté.
  • Pour exécuter le test, vous devez exécuter la commande jasmine. Cela trouvera tous les fichiers auxquels le mot « spec » est attaché et exécutera le fichier en conséquence.