Deno Built-in Tools: Un aperçu et un guide d'utilisation

 $ deno test ./test

exécution de 4 tests
test lib / bonjour tests ... ok (4ms)
test lib / sum entiers tests ... ok (2ms)
test lib / sum string tests ... ok (2ms)
test lib / sum tests mixtes ... ok (2ms)

résultat du test: ok. 4 réussi; 0 a échoué; 0 ignoré; 0 mesuré; 0 filtré (11 ms)

$

Une chaîne - filter ou une expression régulière peut également être spécifiée pour limiter les tests par leur nom. Par exemple:

 $ deno test --filter "hello" ./test

exécution de 1 tests
test lib / bonjour tests ... ok (4ms)

résultat du test: ok. 1 réussi; 0 a échoué; 0 ignoré; 0 mesuré; 3 filtré (5 ms)

Les tests plus longs peuvent être arrêtés au premier échec en passant une option - failfast .

Pour plus d'informations, voir le Deno Manual: Testing . Quelques modules de test tiers sont également disponibles, y compris Merlin et Ruhm mais ceux-ci utilisent toujours Deno.test sous la surface.

V8 Debugger

Deno fournit le même moteur V8 et le même débogueur que Node.js. Il est possible de se connecter au débogueur à l'aide du navigateur Chrome ou de VS Code puis de parcourir le code pour afficher les modifications apportées aux variables et aux objets.

Pour lancer le débogueur, exécutez un script avec - inspect ou - inspect-brk pour s'arrêter sur la première ligne. Si vous devez vous connecter au débogueur à partir d'un autre périphérique de votre réseau, ajoutez son adresse IP et un port ou autorisez une connexion de n'importe où en utilisant - inspect = 0.0.0.0: 9229 . Par exemple:

 $ deno run --inspect-brk = 0.0.0.0: 9229 ./index.js

Débogueur à l'écoute sur ws: //0.0.0.0: 9229 / ws / ceb123 ...
La session du débogueur a démarré.

Ouvrez dans un nouvel onglet Chrome et le script deno apparaîtra comme une nouvelle Cible distante :

Remarque: les «DevTools dédiés pour Node» ne se connectent pas au débogueur de Deno, même s'ils sont similaires.

Cliquez sur le lien inspect de la cible pour lancer DevTools. Cela vous sera familier si vous avez utilisé le débogage côté client. L'onglet Sources est le plus utile et vous permet de parcourir l'exécution du code:

Pour plus d'informations, reportez-vous au Deno Manual: Débogueur .

Formateur de code

Le formateur de code intégré formate automatiquement le code JavaScript et TypeScript de la même manière que Prettier . Le formateur de Deno est également avisé et il n’est actuellement pas possible de configurer des options.

Pour l’utiliser, entrez deno fmt pour formater récursivement chaque fichier dans chaque sous-répertoire. Par exemple:

 $ deno fmt

/home/deno/testing/index.js
/home/deno/testing/test/lib.test.js
/home/deno/testing/lib.js

Sinon, vous pouvez formater un ou plusieurs fichiers individuels – par exemple, deno fmt ./index.js[19459012Often[19659009[]) Si vous examinez le fichier lib.test.js , vous verrez que le formateur a supprimé certains espacements et converti les chaînes pour utiliser des guillemets doubles ( "):

 // fonction bonjour
Deno.test ("lib / hello tests", () => {
  assertEquals (bonjour ("Quelqu'un"), "Bonjour quelqu'un!");
  assertEquals (bonjour (), "Bonjour anonyme!");
});

Des blocs de code individuels peuvent être ignorés en ajoutant un commentaire // deno-fmt-ignore . Par exemple:

 // deno-fmt-ignore
const bin = [
              1, 0, 0,
              0, 1, 0,
              0, 0, 1,
            ];

Des fichiers entiers peuvent être ignorés en ajoutant un commentaire // deno-fmt-ignore-file en haut du code.

Pour plus d'informations, voir le Deno Manual: Code Formatter .

Attention! Le formatage automatisé peut nuire aux commentaires JSDoc.

Documentation Generator

Deno peut générer de la documentation à partir des commentaires JSDoc dans le code source, qui expliquent le but, les paramètres et la valeur de retour d’une fonction. Actuellement, Deno ne génère de la documentation que pour les modules qui exportent fonctions. Par exemple:

 $ deno doc ./lib.js

Défini dans le fichier: ///home/deno/testing/lib.js: 9: 0

fonction bonjour (nom)
  retourne "Bonjour !" chaîne
  @module lib
  @param {string} nom
  @returns {string} Bonjour !

Défini dans le fichier: ///home/deno/testing/lib.js: 21: 0

fonction somme (... args)
  Renvoie le total de tous les arguments
  @module lib
  @param {... *} args
  @returns {*} au total

$

L'ajout d'un indicateur - json génère la documentation au format JSON.

Pour plus d'informations, voir le Deno Manual: Documentation Generator .

Script Bundling

] Votre script principal et toutes ses dépendances peuvent être regroupés dans un seul fichier en utilisant:

 deno bundle  

Par exemple:

 $ deno bundle ./index.js ./index.bundle.js

Fichier bundle: ///home/deno/testing/index.js
Émettre "./index.bundle.js" (3,13 Ko)

Le script résultant peut alors être exécuté:

 $ deno run ./index.bundle.js

Bonjour lecteur SitePoint.com!
total: 6

Cela peut être utile lors de la distribution de scripts aux utilisateurs finaux ou du déploiement d'une base de code finale sur un serveur en direct.

Remarque: les appels de niveau supérieur wait peuvent échouer lors du regroupement, donc un La fonction wrapper async doit être ajoutée. Il s'agit d'un problème connu qui sera résolu dans les prochaines versions de Deno.

Pour plus d'informations, reportez-vous au Deno Manual: Bundling .

Script Installer

Un script Deno peut être installé globalement afin qu'il puisse être exécuté à partir de n'importe quel emplacement du système de fichiers. C'est similaire à l'installation de modules globaux Node.js, mais un peu plus simple et plus facile à utiliser.

La commande deno install doit être passée:

1. Any required runtime permission flags such comme - allow-read - allow-write ou - allow-net .
2. Un nom de script installé facultatif avec ] - nom .
3. Un dossier racine d'installation facultatif avec - racine . Si ce n'est pas défini, Deno installe le script dans le chemin défini dans la variable d'environnement DENO_INSTALL_ROOT ou $ HOME / .deno / bin / .
4. Le chemin ou l'URL du module .

L'exemple de script ci-dessus peut être installé avec:

 $ deno install --name myscript ./index.js

✅ myscript installé avec succès
/home/deno/.deno/bin/myscript

Un fichier myscript est créé dans le répertoire .deno / bin / avec le contenu suivant:

 #! / Bin / sh
# généré par deno install
deno "run" "fichier: ///home/deno/testing/index.js" "$ @"

myscript peut maintenant être exécuté à partir de n'importe où sur le système. Par exemple:

 cd ~
$ myscript

Bonjour lecteur SitePoint.com!
total: 6

Ce processus permet d'indiquer facilement aux utilisateurs comment installer votre application à partir d'une URL publiée. Par exemple:

 deno install --name myapp https://myserver.com/myapp.js
myapp

Deno ne fournit actuellement pas de commande uninstall ou remove . La seule façon de supprimer le script est de supprimer manuellement le fichier généré du répertoire .deno / bin / ou de l'endroit où il a été installé.

Pour plus d'informations, voir le Deno Manual: Script Installateur .

Les outils de Deno sont nouveaux et certains sont rudimentaires, mais une approche «standard» documentée présente des avantages. Node.js offre de nombreuses options tierces, mais cela peut entraîner une paralysie des choix ou un changement de solution continu. Avez-vous utilisé la même suite de tests Node.js?

Cependant, méfiez-vous: ces outils intégrés peuvent évoluer rapidement à mesure que l'utilisation de Deno se développe.

Deno Foundations

Get up to vitesse avec Deno. Notre collection Deno Foundations vous aide à faire vos premiers pas dans le monde Deno et au-delà, et nous y ajoutons constamment. Nous vous apporterons les tutoriels dont vous avez besoin pour devenir un pro. Vous pouvez toujours vous référer à notre index tel qu’il est mis à jour à la fin de notre introduction à Deno:

➤ Deno Foundations