¿Cómo depuro una aplicación de servidor Node.js?

En este momento estoy usando principalmente la depuración de alertas con declaraciones de impresión como esta:

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

Debe haber una mejor manera de depurar. Sé que Google Chrome tiene un depurador de línea de comandos. ¿Este depurador también está disponible para Node.js?

inspector de nodos podría salvar el día! Úselo desde cualquier navegador que admita WebSocket . Puntos de interrupción, perfilador, codificación en vivo, etc. Es realmente increíble.

Instalarlo con:

npm install -g node-inspector

Entonces corre:

node-debug app.js

Depuración

• Guia de Joyent
• Depurador
• Inspector de nodos
• Visual Studio Code
• Nube9
• Soportes

Perfilado

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

Heapdumps

• nodo-heapdump con las herramientas de desarrollador de Chrome

Flameógrafos

• 0x
• jam3 / devtool entonces Chrome Developer Tools Flame Charts
• Dtrace y StackVis - solo compatibles con SmartOS
• clinicajs

Rastreo

• Rastros interactivos de pila con TraceGL

Inicio sesión

Bibliotecas que generan información de depuración

• Oruga
• Trazador
• garabatos

Bibliotecas que mejoran la información de seguimiento de la pila

• Longjohn

Benchmarking

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

Otro

• Rastro
• Ventaja
• Tío
• Marco de seguimiento de Google
• Paul Irish's Guide

Legado

Suelen funcionar pero ya no se mantienen o ya no son aplicables a las versiones modernas de nodos.

• https://github.com/bnoordhuis/node-profiler - reemplazado por depuración incorporada
• https://github.com/c4milo/node-webkit-agent - reemplazado por el inspector de nodos
• https://nodetime.com/ - difunto

El depurador V8 lanzado como parte de las Herramientas para desarrolladores de Google Chrome se puede usar para depurar los scripts de Node.js. Una explicación detallada de cómo funciona esto se puede encontrar en el wiki Node.js GitHub .

Nodo tiene su propio construido en la GUI depurador partir de la versión 6.3 (usando DevTools de Chrome)

Simplemente pase la bandera del inspector y se le proporcionará una URL al inspector:

node --inspect server.js

También puede romper en la primera línea pasando en su --inspect-brklugar.

Node.js versión 0.3.4+ tiene soporte de depuración incorporado.

node debug script.js

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

Visual Studio Code será mi elección para la depuración. Sin gastos generales de instalación de herramientas onpm installcosas. Simplemente configure el punto de partida de su aplicación en package.json y VSCode creará automáticamente un archivo de configuración dentro de su solución. Está construido sobre Electron , en el que se basan editores como Atom.

VS Code brinda una experiencia de depuración similar a la que podría haber tenido en otros IDE como VS, Eclipse, etc.

Personalmente uso JetBrains WebStorm, ya que es el único IDE de JavaScript que he encontrado, que es excelente tanto para JavaScript frontend como backend.

Funciona en múltiples sistemas operativos y tiene la depuración Node.js incorporada (así como un montón de otras cosas) ( http://www.jetbrains.com/webstorm/features/index.html ).

Mis únicos 'problemas' / artículos de la lista de deseos son fueron :

1. Parece tener más recursos en Mac que Windows Ya no parece un problema en la versión 6.
2. Sería bueno si tuviera soporte Snippet (como los de Sublime Text 2 , es decir, escriba 'diversión' y toque 'pestaña' para poner una función. Vea el comentario de @WickyNilliams a continuación: con Live Templates también tiene soporte de fragmentos.

Muchas respuestas geniales aquí, pero me gustaría agregar mi punto de vista (basado en cómo evolucionó mi enfoque)

Registros de depuración

Seamos realistas, a todos nos encanta un bien console.log('Uh oh, if you reached here, you better run.')y, a veces, eso funciona muy bien, así que si eres reticente a alejarte demasiado, al menos agrega un poco de brillo a tus registros con la depuración de Visionmedia .

Depuración interactiva

A pesar de lo útil que puede ser el registro de la consola, para depurar profesionalmente debe arremangarse y quedarse atrapado. Establezca puntos de interrupción, recorra su código, inspeccione los ámbitos y las variables para ver qué está causando ese comportamiento extraño. Como otros han mencionado, el inspector de nodos realmente es la rodilla de las abejas. Hace todo lo que puede hacer con el depurador incorporado, pero usando esa interfaz familiar de Chrome DevTools. Si, como yo, usa Webstorm , aquí hay una guía práctica para depurar desde allí.

Rastros de pila

Por defecto, no podemos rastrear una serie de operaciones en diferentes ciclos del ciclo de eventos (ticks). Para evitar esto, eche un vistazo a Longjohn (¡pero no en producción!).

Pérdidas de memoria

Con Node.js podemos tener un proceso de servidor que se espera que permanezca activo durante un tiempo considerable. ¿Qué haces si crees que ha surgido algunas fugas desagradables? Use heapdump y Chrome DevTools para comparar algunas instantáneas y ver qué está cambiando.

Para algunos artículos útiles, consulte

• RisingStack - Depuración de aplicaciones Node.js
• Excelente artículo de David Mark Clements de nearForm

Si tienes ganas de ver un video (s) entonces

• Netflix JS Talks - Depuración de Node.js en producción
• Video interesante del grupo de trabajo de rastreo sobre rastreo y depuración de node.js
• Video de 15 minutos realmente informativo sobre el inspector de nodos

Cualquiera sea el camino que elija, solo asegúrese de comprender cómo está depurando

Es algo doloroso
mirar tus propios problemas y saber
que usted mismo y nadie más lo ha logrado.

Sófocles, Ajax

Theseus es un proyecto de Adobe Research que le permite depurar su código Node.js en sus corchetes del editor de código abierto . Tiene algunas características interesantes como cobertura de código en tiempo real, inspección retroactiva, árbol de llamadas asíncronas.

Las herramientas de Node.js para Visual Studio 2012 o 2013 incluyen un depurador. La descripción general aquí indica que "Node.js Tools for Visual Studio incluye soporte completo para depurar aplicaciones de nodo". Al ser nuevo en Node.js, pero con experiencia en .NET, he encontrado que este complemento es una excelente manera de depurar las aplicaciones de Node.js.

Visual Studio Code tiene un buen soporte de depuración de Node.js. Es gratuito, de código abierto y multiplataforma y se ejecuta en Linux, OS X y Windows.

Incluso puede depurar tareas de gruñidos y tragos , si necesita ...

Escribí un enfoque diferente para depurar el código Node.js que es estable y es extremadamente simple. Está disponible en https://github.com/sa/iron-node .

Un depurador visual multiplataforma de código abierto.

Instalación:

npm install iron-node -g;

Depurar:

iron-node yourscript.js;

Si está utilizando Atom IDE , puede instalar el node-debuggerpaquete.

Uso de la versión de Chrome 67.0.3396.62 (+)

1. Ejecutar aplicación de nodo

nodo --inspect-brk = 0.0.0.0: 9229 server.js (nombre de archivo del servidor js)

2. Explore su aplicación en Chrome, por ejemplo, "localhost: puerto"
3. Abre DevTools.
4. Haga clic en el icono del nodo junto al icono del dispositivo receptivo.

Habrá otra ventana de DevTools que aparecerá específicamente para la aplicación de nodo de depuración.

Creé una herramienta pequeña y ordenada llamada pry.js que puede ayudarte.

Ponga una declaración simple en algún lugar de su código, ejecute su script normalmente y el nodo detendrá el hilo actual y le dará acceso a todas sus variables y funciones. Ver / editar / eliminarlos a voluntad!

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()

Hay un cliente de depurador de línea de comando incorporado dentro de Node.js. Cloud 9 IDE también tiene un depurador (visual) bastante bueno .

Visual Studio Code nos funcionará en la depuración.

Reuní un breve manual de depuración de Node.js sobre el uso del nodo-inspector para aquellos que no están seguros de dónde comenzar.

Utilice Webstorm! Es perfecto para depurar aplicaciones Node.js. Tiene un depurador incorporado. Consulte los documentos aquí: https://www.jetbrains.com/help/webstorm/2016.1/running-and-debugging-node-js.html

Comience su proceso de nodo con --inspect flag.

node --inspect index.js

y luego Abrir chrome://inspecten cromo. Haga clic en el enlace "Abrir DevTools dedicado para el nodo" o instale esto extensión de Chrome para abrir fácilmente DevTools de Chrome.

Para más información consulte este enlace

Si necesita una biblioteca de registro potente para Node.js, Tracer https://github.com/baryon/tracer es una mejor opción.

Produce mensajes de registro con una marca de tiempo, nombre de archivo, nombre de método, número de línea, ruta o pila de llamadas, soporte de consola de color y soporte de base de datos, archivo, transporte de flujo fácilmente. Yo soy el autor

Suponiendo que tenga instalado el inspector de nodos en su computadora (si no, simplemente escriba 'npm install -g node-inspector') solo tiene que ejecutar:

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

Y pegue el URI desde la línea de comando en un navegador WebKit (Chrome / Safari).

Solo para completar:

El complemento PyCharm 3.0 + Node.js ofrece una increíble experiencia de desarrollo + ejecución + depuración .

IntelliJ funciona maravillosamente para Node.js.

Además, IntelliJ admite bien la 'Asistencia de código'.

Hay muchas posibilidades ...

• el nodo incluye una utilidad de depuración
• inspector de nodos
• Editores de código / IDE (consulte las instrucciones de depuración para uno de los siguientes)
  • átomo ,
  • VSCode
  • Tormenta web
  • y más

El soporte de depuración a menudo se implementa utilizando el Protocolo de depuración v8 o el nuevo Protocolo de depuración de Chrome .

Existe el nuevo proyecto Nodeclipse de código abierto (como un complemento Eclipse o Enide Studio ):

Nodeclipse se convirtió en el # 1 en Eclipse Top 10 NUEVOS complementos para 2013 . Utiliza un depurador V8 modificado (de Google Chrome Developer Tools para Java).

Nodeclipse es un software gratuito de código abierto lanzado a principios de cada mes .

El IDE de NetBeans ha tenido soporte para Node.js desde la versión 8.1 :

<...>

Nuevas características destacadas

Desarrollo de aplicaciones Node.js

• Nuevo asistente de proyecto Node.js
• Nuevo asistente de Node.js Express
• Editor de JavaScript mejorado
• Nuevo soporte para ejecutar aplicaciones Node.js
• Nuevo soporte para depurar aplicaciones Node.js.

<...>

Referencias adicionales:

1. NetBeans Wiki / NewAndNoteworthyNB81 .
2. Aplicación Node.js Express en NetBeans IDE, Geertjan-Oracle .

Usa estos comandos

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

ndb es una experiencia de depuración mejorada para Node.js, habilitada por Chrome DevTools

https://github.com/GoogleChromeLabs/ndb

Una forma rápida y sucia de depurar pequeños scripts de Node.js con su depurador de navegador favorito sería usar browserify . Tenga en cuenta que este enfoque no funciona con ninguna aplicación que requiera bibliotecas de E / S nativas, pero es lo suficientemente bueno para la mayoría de los scripts pequeños.

$ npm install -g browserify

Ahora mueva todas sus var x = requires('x')llamadas a un requires.jsarchivo y ejecute:

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

(La desventaja aquí es que debes mover o comentar requiresen todos tus archivos).

Incluya el bundle.jsen un archivo HTML de esta manera:

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

Ahora cargue el archivo en su navegador y presione F12y viola: depurar en el navegador.