Comment déboguer une application serveur Node.js?

En ce moment, j'utilise principalement le débogage des alertes avec des instructions d'impression comme ceci:

sys.puts(sys.inspect(someVariable));

Il doit y avoir une meilleure façon de déboguer. Je sais que Google Chrome dispose d'un débogueur en ligne de commande. Ce débogueur est-il également disponible pour Node.js?

l'inspecteur de nœuds pourrait sauver la situation! Utilisez-le depuis n'importe quel navigateur prenant en charge WebSocket . Points d'arrêt, profileur, livecoding, etc ... C'est vraiment génial.

Installez-le avec:

npm install -g node-inspector

Exécutez ensuite:

node-debug app.js

Débogage

• Guide de Joyent
• Débogueur
• Inspecteur de noeud
• Code Visual Studio
• Cloud 9
• Supports

Profilage

1. node --prof ./app.js
2. node --prof-process ./the-generated-log-file

Heapdumps

• node-heapdump avec Chrome Developer Tools

Flamegraphs

• 0x
• jam3 / devtool puis Chrome Developer Tools Flame Charts
• Dtrace et StackVis - uniquement pris en charge sur SmartOS
• clinicjs

Tracé

• Traces de pile interactives avec TraceGL

Enregistrement

Bibliothèques qui produisent des informations de débogage

• chenille
• Traceur
• gribouillis

Bibliothèques qui améliorent les informations de trace de pile

• Longjohn

Analyse comparative

• Banc Apache :ab -n 100000 -c 1 http://127.0.0.1:9778/
• wrk

Autre

• Trace
• Avantage
• Bugger
• Google Tracing Framework
• Guide de Paul Irish

Héritage

Ceux-ci ont l'habitude de fonctionner mais ne sont plus maintenus ou ne s'appliquent plus aux versions de nœuds modernes.

• https://github.com/bnoordhuis/node-profiler - remplacé par un débogage intégré
• https://github.com/c4milo/node-webkit-agent - remplacé par l'inspecteur de noeud
• https://nodetime.com/ - disparu

Le débogueur V8 publié dans le cadre des outils de développement Google Chrome peut être utilisé pour déboguer des scripts Node.js. Une explication détaillée de la façon dont cela fonctionne peut être trouvée dans le wiki Node.js GitHub .

Noeud a son propre construit dans débogueur GUI de la version 6.3 ( en utilisant les DevTools de Chrome)

Passez simplement le drapeau de l'inspecteur et vous recevrez une URL à l'inspecteur:

node --inspect server.js

Vous pouvez également casser sur la première ligne en passant à la --inspect-brkplace.

La version 0.3.4+ de Node.js a un support de débogage intégré.

node debug script.js

Manuel: http://nodejs.org/api/debugger.html

Visual Studio Code sera mon choix pour le débogage. Pas de frais généraux pour installer des outils ou desnpm installtrucs. Définissez simplement le point de départ de votre application dans package.json et VSCode créera automatiquement un fichier de configuration dans votre solution. Il est basé surElectron, sur lequel sont construits des éditeurs comme Atom.

VS Code offre une expérience de débogage similaire à celle que vous auriez pu avoir dans d'autres IDE comme VS, Eclipse, etc.

J'utilise personnellement JetBrains WebStorm car c'est le seul IDE JavaScript que j'ai trouvé, ce qui est parfait pour le frontend et le backend JavaScript.

Il fonctionne sur plusieurs systèmes d'exploitation et intègre le débogage Node.js (ainsi qu'une tonne d'autres choses] ( http://www.jetbrains.com/webstorm/features/index.html ).

Mes seuls «problèmes» / éléments de liste de souhaits sont étaient :

1. Il semble être plus gourmand en ressources sur Mac que sur Windows Cela ne semble plus être un problème dans la version 6.
2. Ce serait bien s'il avait un support Snippet (comme ceux de Sublime Text 2 - c'est-à-dire tapez 'fun' et appuyez sur 'tab' pour mettre une fonction. Voir le commentaire @WickyNilliams ci-dessous - Avec les modèles en direct, vous avez également la prise en charge des extraits.

Beaucoup de bonnes réponses ici, mais j'aimerais ajouter mon point de vue (en fonction de l'évolution de mon approche)

Journaux de débogage

Avouons-le, nous aimons tous un bien console.log('Uh oh, if you reached here, you better run.')et parfois cela fonctionne très bien, donc si vous êtes réticent à vous en éloigner trop, au moins ajoutez un peu de bling à vos journaux avec le débogage de Visionmedia .

Débogage interactif

Aussi pratique que puisse être la consignation de la console, pour déboguer professionnellement, vous devez retrousser vos manches et rester coincé. Définissez des points d'arrêt, parcourez votre code, inspectez les étendues et les variables pour voir ce qui cause ce comportement étrange. Comme d'autres l'ont mentionné, l' inspecteur de nœuds est vraiment le genou des abeilles. Il fait tout ce que vous pouvez faire avec le débogueur intégré, mais en utilisant cette interface familière de Chrome DevTools. Si, comme moi, vous utilisez Webstorm , voici un guide pratique pour déboguer à partir de là.

Traces de pile

Par défaut, nous ne pouvons pas tracer une série d'opérations sur différents cycles de la boucle d'événements (ticks). Pour contourner cela, jetez un œil à longjohn (mais pas en production!).

Fuites de mémoire

Avec Node.js, nous pouvons avoir un processus serveur censé rester en place pendant un temps considérable. Que faites-vous si vous pensez qu'il a provoqué des fuites désagréables? Utilisez heapdump et Chrome DevTools pour comparer certains instantanés et voir ce qui change.

Pour quelques articles utiles, consultez

• RisingStack - Débogage des applications Node.js
• Excellent article de David Mark Clements de nearForm

Si vous avez envie de regarder une vidéo, alors

• Netflix JS Talks - Débogage de Node.js en production
• Vidéo intéressante du groupe de travail sur le traçage sur le traçage et le débogage node.js
• Vidéo de 15 minutes vraiment informative sur l'inspecteur de nœuds

Quel que soit le chemin que vous choisissez, assurez-vous simplement de comprendre comment vous déboguez

C'est une chose douloureuse
De regarder ses propres problèmes et de savoir
que toi-même et personne d'autre n'y est arrivé

Sophocles, Ajax

Theseus est un projet d'Adobe research qui vous permet de déboguer votre code Node.js dans leurs supports d' édition Open Source . Il possède des fonctionnalités intéressantes telles que la couverture de code en temps réel, l'inspection rétroactive, l'arborescence d'appels asynchrones.

Les outils Node.js pour Visual Studio 2012 ou 2013 incluent un débogueur. La vue d'ensemble ici indique que "les outils Node.js pour Visual Studio incluent une prise en charge complète du débogage des applications de nœuds". Étant nouveau dans Node.js, mais ayant une expérience en .NET, j'ai trouvé que cet ajout était un excellent moyen de déboguer les applications Node.js.

Visual Studio Code a un support de débogage Node.js vraiment agréable. Il est gratuit, open source et multiplateforme et fonctionne sous Linux, OS X et Windows.

Vous pouvez même déboguer des tâches de grognement et de gorgée , si vous en avez besoin ...

J'ai écrit une approche différente pour déboguer le code Node.js qui est stable et extrêmement simple. Il est disponible sur https://github.com/sa/iron-node .

Un débogueur visuel multiplateforme open source.

Installation:

npm install iron-node -g;

Déboguer:

iron-node yourscript.js;

Si vous utilisez l' IDE Atom , vous pouvez installer le node-debuggerpackage.

Utilisation de Chrome version 67.0.3396.62 (+)

1. Exécuter l'application de nœud

node --inspect-brk = 0.0.0.0: 9229 server.js (nom de fichier du serveur js)

2. Parcourez votre application dans Chrome, par exemple "localhost: port"
3. Ouvrez DevTools.
4. Cliquez sur l'icône du nœud à côté de l'icône du périphérique réactif.

Il y aura une autre fenêtre DevTools qui apparaîtra spécifiquement pour le débogage de l'application de nœud.

J'ai créé un petit outil soigné appelé pry.js qui peut vous aider.

Mettez une simple déclaration quelque part dans votre code, exécutez votre script normalement et le nœud arrêtera le thread actuel vous donnant accès à toutes vos variables et fonctions. Affichez / modifiez / supprimez-les à volonté!

var pry = require('pryjs')

class FizzBuzz

  run: ->
    for i in [1..100]
      output = ''
      eval(pry.it) // magic
      output += "Fizz" if i % 3 is 0
      output += "Buzz" if i % 5 is 0
      console.log output || i

  bar: ->
    10

fizz = new FizzBuzz()
fizz.run()

Il y a un client de débogueur de ligne de commande intégré dans Node.js. L'IDE Cloud 9 a également un débogueur (visuel) plutôt sympa .

Visual Studio Code fonctionnera pour nous dans le débogage.

J'ai préparé une courte amorce de débogage Node.js sur l'utilisation de l' inspecteur de nœuds pour ceux qui ne savent pas par où commencer.

Utilisez Webstorm! Il est parfait pour déboguer les applications Node.js. Il a un débogueur intégré. Consultez les documents ici: https://www.jetbrains.com/help/webstorm/2016.1/running-and-debugging-node-js.html

Démarrez votre processus de nœud avec l' indicateur --inspect .

node --inspect index.js

puis Ouvrir chrome://inspecten chrome. Cliquez sur le lien "Ouvrir les DevTools dédiés pour le nœud" ou installez ce extension Chrome pour ouvrir facilement les DevTools Chrome.

Pour plus d'informations, reportez-vous à ce lien

Si vous avez besoin d'une bibliothèque de journalisation puissante pour Node.js, Tracer https://github.com/baryon/tracer est un meilleur choix.

Il génère des messages de journal avec un horodatage, un nom de fichier, un nom de méthode, un numéro de ligne, un chemin ou une pile d'appels, prend en charge la console couleur et prend en charge la base de données, le transport de fichiers et de flux facilement. Je suis l'auteur.

En supposant que vous avez installé node-inspector sur votre ordinateur (sinon, tapez simplement 'npm install -g node-inspector'), il vous suffit d'exécuter:

node-inspector & node --debug-brk scriptFileName.js

Et collez l'URI de la ligne de commande dans un navigateur WebKit (Chrome / Safari).

Juste pour être complet:

Le plug-in PyCharm 3.0 + Node.js offre une expérience de développement + exécution + débogage impressionnante .

IntelliJ fonctionne à merveille pour Node.js.

De plus, IntelliJ prend bien en charge l '«assistance de code».

Il existe de nombreuses possibilités ...

• le nœud inclut un utilitaire de débogage
• inspecteur de nœuds
• Éditeurs de code / IDE (voir les instructions de débogage pour l'un des éléments suivants)
  • Atom ,
  • VSCode
  • Webstorm
  • et plus

La prise en charge du débogage est souvent implémentée à l'aide du protocole de débogage v8 ou du protocole de débogage Chrome plus récent .

Il y a le nouveau projet Nodeclipse open source (en tant que plugin Eclipse ou Enide Studio ):

Nodeclipse est devenu n ° 1 dans le Top 10 des nouveaux plugins Eclipse pour 2013 . Il utilise un débogueur V8 modifié (de Google Chrome Developer Tools pour Java).

Nodeclipse est un logiciel open source gratuit publié au début de chaque mois .

L' IDE NetBeans prend en charge Node.js depuis la version 8.1 :

<...>

Faits saillants de la nouvelle fonctionnalité

Développement d'applications Node.js

• Nouvel assistant de projet Node.js
• Nouvel assistant Node.js Express
• Éditeur JavaScript amélioré
• Nouveau support pour l'exécution des applications Node.js
• Nouveau support pour le débogage des applications Node.js.

<...>

Références supplémentaires:

1. NetBeans Wiki / NewAndNoteworthyNB81 .
2. Application Node.js Express dans NetBeans IDE, Geertjan-Oracle .

Utilisez ces commandes

DEBUG_LEVEL=all node file.js
DEBUG=* node file.js
node file.js --inspect

ndb est une expérience de débogage améliorée pour Node.js, activée par Chrome DevTools

https://github.com/GoogleChromeLabs/ndb

Un moyen rapide et sale de déboguer de petits scripts Node.js avec votre débogueur de navigateur préféré serait d'utiliser browserify . Notez que cette approche ne fonctionne pas avec les applications qui nécessitent des bibliothèques d'E / S natives, mais elle est assez bonne pour la plupart des petits scripts.

$ npm install -g browserify

Déplacez maintenant tous vos var x = requires('x')appels dans un requires.jsfichier et exécutez:

$ browserify requires.js -s window -o bundle.js

(L'inconvénient ici est que vous devez soit déplacer, soit commenter requires dans tous vos fichiers.)

Incluez le bundle.jsdans un fichier HTML comme ceci:

<script type="text/javascript" src="bundle.js"></script>

Maintenant, chargez le fichier dans votre navigateur et appuyez sur F12et alto: déboguer dans le navigateur.