Créer notre première tâche avec Grunt

L'installation et la mise en place du Grognement C'est quelque chose d'assez simple à faire, mais une fois que nous avons tous les outils et que nous connaissons certaines des commandes de base, nous nous demandons souvent, que pouvons-nous faire maintenant ? La prochaine étape est très simple, il est temps de commencer à créer des tâches.
L'idée derrière une tâche est qu'il s'agit de quelque chose qui peut résoudre des problèmes ou des activités fréquents que nous réalisons toujours au cours de notre journée de travail ou de développement d'applications, où, étant de nature répétitive, nous pouvons définir des paramètres pour ces tâches et ainsi elles peuvent toujours fonctionner sans avoir à les fabriquer à partir de zéro.
ExigencesCe tutoriel vous recommande de connaître les bases de base de JavaScript car nous utiliserons beaucoup de choses de cette langue. Une autre exigence essentielle est que nous devons avoir installé et configuré Grognement dans notre système ou sandbox, cela signifie que nous devons avoir Node.js, votre gestionnaire de paquets npm et bien sûr Grognement. Enfin, nous devons avoir un éditeur de texte pour créer le contenu de nos exercices et des autorisations suffisantes pour créer des fichiers et exécuter librement la commande grunt dans la console.
Une tâche est une activité qui a un début, un développement et une fin, en Grognement une tâche n'est rien de plus qu'une fonction dans JavaScript qui est contenu dans le fichier Gruntfile.js et que lors de l'exécution de la commande grognement dans notre console, nous pouvons faire exécuter cette fonction, provoquant le lancement de son contenu.
Les tâches sont gérées de manière modulaire, à la manière de la constitution de base de Node.jsPar conséquent, chaque fois que nous définissons un nouvel ensemble de tâches, nous devons ajouter les instructions qui indiquent leur modularité.
Afin de créer une tâche, nous avons besoin d'un code de base dans notre fichier gruntfile.js, ce code s'appelle passe-partout car il est répétitif, cependant nous ne l'utilisons qu'une seule fois, voyons à quoi cela ressemble :

 module.exports = function (grunt) {// voici le contenu de nos tâches};

Une fois que nous avons placé ce code dans notre fichier, nous avons déjà la base ou la constitution pour pouvoir créer nos tâches. Une fois cela fait, nous allons faire une tâche qui nous permet d'écrire un message par console, pour cela nous allons écrire le code suivant :

 module.exports = function (grunt) {grunt.registerTask ('default', function () {console.log ('Bonjour, nous avons envoyé un message dans Grunt.');});};

Ce que nous avons fait est très facile à expliquer, d'abord nous avons pris l'objet grognement que nous créons avec notre code passe-partout, alors dans cet objet nous avons exécuté la méthode s'inscrireTâche ce qui nous aide à dire Grognement que nous ajoutons une nouvelle tâche, l'acte suivant nous lui donnons un nom puis avec une fonction anonyme nous lui transmettons le contenu de notre tâche, qui dans ce cas est le message sur la console.
Voyons à quoi ressemble cet exemple lors de l'exécution de la tâche, pour cela dans le dossier où nous enregistrons notre fichier gruntfile.js nous allons exécuter la commande suivante :

 grognement

Où alors la console devrait nous donner un résultat comme le suivant :

Il est important de mentionner que nous utilisons le nom par défaut pour cette tâche car c'est la tâche qui Grognement il recherchera par défaut comme son nom l'indique dans notre fichier gruntfile.js, s'il n'avait pas ce nom, nous obtiendrions une erreur lors de l'exécution grognement comme on le voit sur l'image suivante :

Notre exemple précédent, bien qu'il fonctionne, n'est pas le plus recommandé, nous avons simplement utilisé la console Node.js mais cela n'a pas toutes les fonctionnalités et propriétés de la console Grognement donc si nous avons des informations supplémentaires du moteur de tâches, nous ne les verrons sûrement pas. C'est pourquoi nous devons utiliser la console de notre moteur d'automatisation des tâches, le concept en philosophie est pratiquement le même que nous modifions les objets et les fonctions que nous devons appeler.
Voyons dans le code suivant comment nous pouvons réécrire notre code à partir de l'exemple précédent pour pouvoir remplir ce que nous avons expliqué :

 module.exports = function (grunt) {grunt.registerTask ('default', function () {grunt.log.writeln ('Ce message est affiché par la console Grunt.');});};

Comment nous voyons que nous ne réutilisons que l'objet grognement initiale du fichier, alors on utilise sa classe Journal et enfin la méthode écrire, le résultat est le même que dans l'exemple précédent, à la différence près que nous avons utilisé quelque chose de plus optimal pour nos besoins. Voyons dans l'image suivante comment tout a été correctement entretenu :

Au début, nous avons parlé de tâches réutilisables et qui nous permettent de gagner du temps, l'une des choses qui peuvent nous permettre d'atteindre un degré adéquat de réutilisation des tâches est la possibilité de leur ajouter des paramètres, avec cela nous pouvons modifier certaines valeurs selon la situation dans laquelle nous pouvons nous trouver, comme créer des utilisateurs pour un système directement avec Grognement, avec lequel on peut passer en paramètre un nom de fichier avec la liste des utilisateurs.
Dans le code suivant, nous allons faire quelque chose de très intéressant, tout d'abord nous allons voir comment créer des tâches qui ne sont pas notre processus par défaut, avec cela nous aurons déjà la clé pour avoir plusieurs tâches dans le même fichier. Le paramètre qui recevra notre tâche sera simplement défini dans la fonction anonyme, de cette manière nous pourrons le capturer et le traiter dans le corps de celle-ci.
Voyons le code pour générer cette tâche, à titre d'exercice, nous pouvons placer ledit code après notre tâche par défaut pour tester ce que nous avons expliqué :

 grunt.registerTask ('dire bonjour', fonction (nom) {grunt.log.writeln ('Bonjour :' + nom + 'bonjour aujourd'hui');});

Maintenant, pour faire l'appel console de la tâche, nous procédons simplement comme suit :

 grunt dire bonjour : nom

Comment pouvons-nous voir que nous plaçons le nom de la tâche et avec un deux-points nous séparons pour passer le paramètre nécessaire, dans ce cas le nom que nous voulons envoyer à la tâche, voyons à quoi cela ressemble dans notre console :

Maintenant, que se passe-t-il si notre tâche nécessite que nous passions deux ou plusieurs paramètres, simplement dans le code du même, nous les ajoutons séparés par des virgules en tant que fonction JavaScript normal, et en les appelant dans la console, nous pouvons les placer avec le même mode de séparation, voyons un code où nous effectuons une tâche qui nous montre ceci :

 grunt.registerTask ('ajouter', fonction (valeur1, valeur2) {var sum = Nombre (valeur1) + Nombre (valeur2); grunt.log.writeln ('Le résultat de l'addition' + valeur1 + '+' + valeur2 + ' est : '+ somme);});

Voyons maintenant à quoi cela ressemble lorsque nous parcourons la console cet exemple avec l'appel et la réponse :

Quelque chose d'intéressant que nous avons pu remarquer, c'est que nous utilisons JavaScript Plat et simple à définir le traitement, l'utilisation de ce langage est très importante puisque de cette façon nous pourrons étendre notre capacité de tout ce que nous pouvons réaliser au moment de construire nos tâches avec Grognement.
Il est possible d'utiliser des avertissements dans nos tâches, avec cela nous pouvons valider un peu les paramètres reçus de l'utilisateur, par exemple notre tâche précédente est une somme mais si nous mettons autre chose qu'un nombre sûrement notre opération échouera, donc nous pouvons procédez comme suit : à l'aide de la méthode prévenir () Nous validerons que les deux paramètres sont des nombres et dans le cas où ils ne le sont pas, nous lancerons un avertissement :

 grunt.registerTask ('ajouter', fonction (valeur1, valeur2) {if (estNaN (Nombre (valeur1))) {grunt.warn ('La première valeur' ​​+ valeur1 + 'doit être un nombre.');} si ( isNaN (Nombre (valeur2))) {grunt.warn ('La deuxième valeur' ​​+ valeur2 + 'doit être un nombre.');} Var sum = Nombre (valeur1) + Nombre (valeur2); grunt.log.writeln ( 'Le résultat de l'addition '+ valeur1 +' + '+ valeur2 +' est : '+ somme);});

Dans notre code réécrit, nous avons validé que si le résultat de la conversion en Numéro () des paramètres n'est pas un nombre lancer la méthode prévenir () ou avertissement, cela interrompt le fil et affiche le message, afin que nous puissions éviter une tâche défectueuse. Voyons à quoi cela ressemble dans notre console lors de l'exécution de la tâche :

Comme nous remarquons aussi la connaissance de la langue JavaScript C'est très important, donc si nous sommes en dessous du niveau que nous voulons atteindre, nous devons nous entraîner et essayer de faire autant d'exercices que possible pour améliorer nos compétences.
Avec cela, nous avons terminé ce tutoriel, car nous voyons la création de tâches avec Grognement Il n'est pas très complexe, mais sa logique au moment de les définir nous aide à faciliter la compréhension de l'utilisation de l'outil. La vraie complexité est dans la définition de notre propre logique au moment de savoir ce que fera notre tâche et comment nous pouvons la rendre aussi réutilisable que possible, car si ce n'est pas le cas, nous travaillerons en vain.