Comment activer le débogage nodejs ? Comment déboguer le programme nodejs ?

Comment déboguer un programme nodejs ? L'article suivant vous présentera la méthode de débogage nodejs. J'espère qu'il vous sera utile !

Pour les développeurs, dans le processus de développement d'applications, ils ont souvent besoin de recourir à la fonction de débogage du langage de programmation pour faciliter le développement et résoudre les bugs. D'une manière générale, nous devons utiliser la fonction de débogage d'un IDE puissant pour terminer ce travail. nodejs ne fait pas exception.

Aujourd'hui, nous allons présenter en détail comment déboguer le programme node.

Activer le débogage nodejs

Vous souvenez-vous encore du programme koa dont nous avons parlé auparavant ? Cet article prendra comme exemple un simple programme serveur koa pour démarrer le débogage de nodejs.

Jetons d'abord un coup d'œil à un simple service koa app.js :

const Koa = require('koa');
const app = module.exports = new Koa();

app.use(async function(ctx) {
  ctx.body = 'Hello World';
});

if (!module.parent) app.listen(3000);

Le programme ci-dessus ouvre le port 3000 et établit un service http. Chaque fois qu'une demande est faite, hello World sera renvoyé, ce qui est très simple.

Pour exécuter le programme ci-dessus, nous devons exécuter le nœud app.js. Cela exécutera app.js mais n'activera pas le débogage.

Comment déboguer ?

Nous devons ajouter le paramètre --inspect :

node --inspect app.js

Le code ci-dessus activera la fonction de débogage de nodejs.

Jetons un œil au résultat :

Debugger listening on ws://127.0.0.1:9229/88c23ae3-9081-41cd-98b0-d0f7ebceab5a
For help, see: https://nodejs.org/en/docs/inspector

Les résultats nous disent deux choses. La première chose est le port que le débogueur écoute. Par défaut, le port 9229 de 127.0.0.1 sera ouvert. Et attribué un UUID unique pour la différenciation.

La deuxième chose est de nous dire que le débogueur utilisé par nodejs est Inspector.

Inspector a été introduit après nodejs 8. Si c'est avant nodejs 7, alors l'ancien débogueur est utilisé.

Sécurité du débogage

Si le débogueur est connecté à l'environnement d'exécution de nodejs, s'il existe un attaquant malveillant, l'attaquant malveillant peut exécuter du code arbitraire dans l'environnement nodejs. Cela entraînera de grands risques de sécurité pour notre programme.

Nous devons donc faire attention à la sécurité du débogage. De manière générale, nous déconseillons le débogage à distance.

Par défaut, --inspect est lié à 127.0.0.1, ce qui autorise uniquement l'accès aux programmes locaux. Et tout programme exécuté localement est autorisé à déboguer le programme.

Si nous voulons vraiment exposer le programme de débogage à des programmes externes, nous pouvons spécifier l'adresse IP externe de la machine ou 0.0.0.0 (c'est-à-dire n'importe quelle adresse, aucune restriction), afin que la machine distante puisse effectuer un débogage à distance.

Que devons-nous faire si nous voulons effectuer un débogage à distance en toute sécurité ?

Tout d'abord, nous devons activer le débogage local :

node --inspect app.js

Ensuite, nous pouvons construire un tunnel ssh pour mapper le port 9221 local au port 9229 du serveur distant :

ssh -L 9221:localhost:9229 user@remote.example.com

De cette façon, nous pouvons nous connecter au 9221 local port. Débogage à distance.

Utilisez WebStorm pour le débogage de nodejs

WebStorm produit par JetBrains peut être considéré comme un outil puissant pour développer nodejs. WebStorm a sa propre option de débogage, elle sera activée en arrière-plan --inspect. :

Utiliser le débogage WebStorm est similaire à l'utilisation d'IDEA pour déboguer des programmes Java, je n'entrerai donc pas dans les détails ici.

Utilisez Chrome devTools pour le débogage

La condition préalable à l'utilisation de Chrome devTools pour le débogage est que nous avons activé le mode --inspect.

Entrez chrome://inspect dans chrome :

Nous pouvons voir l'interface chrome inspect Si vous avez déjà un programme nodejs avec inspect activé localement, vous pouvez le voir directement dans Remote Target.

Sélectionnez la cible que vous souhaitez déboguer et cliquez sur inspecter pour ouvrir l'outil de débogage Chrome devTools :

Vous pouvez profiler le programme et le déboguer.

Ici, nous nous concentrons sur le débogage, alors allez dans la colonne source et ajoutez le code source du programme que vous souhaitez déboguer :

Ajoutez des points d'arrêt pour démarrer le débogage. C'est la même chose que le débogage de js côté Web dans Chrome.

Utilisez node-inspect pour le débogage

En fait, nodejs dispose d'un outil de débogage intégré appelé node-inspect, qui est un outil de débogage cli. Voyons comment l'utiliser.

Nous utilisons directement :

node inspect app.js

< Debugger listening on ws://127.0.0.1:9229/f1c64736-47a1-42c9-9e9e-f2665073d3eb
< For help, see: https://nodejs.org/en/docs/inspector
< Debugger attached.
Break on start in app.js:1
> 1 const Koa = require(&#39;koa&#39;);
  2 const app = module.exports = new Koa();
  3 
debug>

node inspect pour faire deux choses. La première chose est de générer un sous-programme pour exécuter node --inspect app.js, et la deuxième chose est d'exécuter la fenêtre de débogage CLI dans le programme principal.

Ce débogueur CLI nous fournit des commandes très utiles :

1, Stepping

• cont, c : Continuer l'exécution
• next, n : Passer à l'étape suivante
• step, s : Step in
• out, o : Sortez
• pause : Suspendez l'exécution du code

2, Points d'arrêt

• setBreakpoint(), sb() : Définir un point d'arrêt sur la ligne actuelle
• setBreakpoint(line), sb(line) : Définir un point d'arrêt sur la ligne spécifiée
• setBreakpoint('fn()'), sb(… ) : Définir un point d'arrêt dans la fonction spécifiée
• setBreakpoint('script.js', 1), sb(...) : Définir un point d'arrêt dans le fichier de script spécifié
• clearBreakpoint('script.js', 1), cb (...) : Effacer les points d'arrêt du fichier

3, Informations

• backtrace, bt : Imprimer les informations de trace du cadre d'exécution actuel
• list(5) : Répertorier les 5 lignes avant et après le code source
• watch (expr) : Ajouter une expression de surveillance
• unwatch(expr) : Supprimer l'expression de surveillance
• watchers : Liste tous les observateurs
• repl : Ouvrir l'expression de repl
• exec expr : Exécuter l'expression

via ce qui précède commande, nous pouvons effectuer des activités de débogage plus complexes dans la CLI.

Autres clients de débogage

En plus de ceux que nous avons mentionnés ci-dessus, nous pouvons également utiliser vscode, Visual Studio, Eclipse IDE, etc. pour déboguer nodejs, qui ne sera pas présenté en détail ici.

Les amis intéressés peuvent explorer par eux-mêmes.

Pour plus de connaissances sur les nœuds, veuillez visiter : tutoriel Nodejs ! !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!