Como depurar um aplicativo de servidor Node.js.

No momento, estou usando principalmente a depuração de alertas com instruções de impressão como esta:

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

Deve haver uma maneira melhor de depurar. Eu sei que o Google Chrome tem um depurador de linha de comando. Este depurador também está disponível para o Node.js?

O inspetor de nó pode salvar o dia! Use-o em qualquer navegador que suporte o WebSocket . Pontos de interrupção, criação de perfil, codificação ao vivo, etc ... É realmente incrível.

Instale-o com:

npm install -g node-inspector

Então corra:

node-debug app.js

Depuração

• Guia de Joyent
• Depurador
• Inspetor de nó
• Código do Visual Studio
• Cloud9
• Suportes

Criação de perfil

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

Heapdumps

• node-heapdump com as Ferramentas do desenvolvedor do Chrome

Flamegraphs

• 0x
• jam3 / devtool e, em seguida, gráficos de chama das Ferramentas do desenvolvedor do Chrome
• Dtrace e StackVis - suportado apenas no SmartOS
• clinicjs

Rastreamento

• Rastreios de pilha interativos com o TraceGL

Exploração madeireira

Bibliotecas que produzem informações de depuração

• Lagarta
• Marcador
• rabiscos

Bibliotecas que aprimoram as informações de rastreamento de pilha

• Longjohn

avaliação comparativa

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

De outros

• Vestígio
• Vantage
• Bugger
• Estrutura de rastreamento do Google
• Paul Irish's Guide

Legado

Eles costumam funcionar, mas não são mais mantidos ou não são mais aplicáveis ​​às versões modernas dos nós.

• https://github.com/bnoordhuis/node-profiler - substituído pela depuração incorporada
• https://github.com/c4milo/node-webkit-agent - substituído pelo inspetor do nó
• https://nodetime.com/ - extinto

O depurador V8 lançado como parte das Ferramentas do desenvolvedor do Google Chrome pode ser usado para depurar scripts do Node.js. Uma explicação detalhada de como isso funciona pode ser encontrada no wiki do Node.js GitHub .

Nó tem seu próprio construído em GUI depurador a partir da versão 6.3 (usando DevTools do Chrome)

Basta passar a bandeira do inspetor e você receberá um URL para o inspetor:

node --inspect server.js

Você também pode quebrar na primeira linha passando em seu --inspect-brklugar.

O Node.js. versão 0.3.4+ possui suporte a depuração interno.

node debug script.js

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

O Código do Visual Studio será minha opção para depuração. Nenhuma sobrecarga de instalação de ferramentas ounpm installoutras coisas. Basta definir o ponto de partida do seu aplicativo no package.json e o VSCode criará automaticamente um arquivo de configuração dentro da sua solução. ÉbaseadonoElectron, no qual editores como o Atom são criados.

O Código VS oferece uma experiência de depuração semelhante à de outros IDEs, como VS, Eclipse, etc.

Eu pessoalmente uso o JetBrains WebStorm , pois é o único IDE JavaScript que eu achei excelente para JavaScript front-end e back-end.

Ele funciona em vários sistemas operacionais e possui a depuração do Node.js integrada (além de várias outras coisas) ( http://www.jetbrains.com/webstorm/features/index.html ).

Meus únicos itens de "problemas" / lista de desejos estamos foram :

1. Parece ter mais recursos no Mac do que no Windows Não parece mais um problema na versão 6.
2. Seria bom se ele tivesse suporte a Snippet (como os do Sublime Text 2 - ou seja, digite 'fun' e toque em 'tab' para inserir uma função. Veja o comentário @WickyNilliams abaixo - Com os Live Templates, você também tem suporte para snippets.

Muitas ótimas respostas aqui, mas eu gostaria de adicionar minha visão (com base em como minha abordagem evoluiu)

Logs de depuração

Vamos ser sinceros, todos nós gostamos de algo bom console.log('Uh oh, if you reached here, you better run.')e, às vezes, que funciona muito bem, por isso, se você é reticente em se afastar demais, adicione pelo menos um pouco de brilho aos seus logs com a depuração do Visionmedia .

Depuração interativa

Tão útil quanto o log do console pode ser, para depurar profissionalmente, você precisa arregaçar as mangas e ficar preso. Defina pontos de interrupção, percorra seu código, inspecione escopos e variáveis ​​para ver o que está causando esse comportamento estranho. Como outros já mencionaram, o inspetor de nós é realmente o joelho das abelhas. Ele faz tudo o que você pode fazer com o depurador embutido, mas usando a interface familiar do Chrome DevTools. Se, como eu, você usa o Webstorm , aqui está um guia útil para depuração a partir daí.

Rastreios de pilha

Por padrão, não podemos rastrear uma série de operações em diferentes ciclos do loop de eventos (ticks). Para contornar isso, dê uma olhada em longjohn (mas não em produção!).

Perdas de memória

Com o Node.js, podemos esperar que um processo do servidor permaneça ativo por um tempo considerável. O que você faz se acha que houve alguns vazamentos desagradáveis? Use heapdump e o Chrome DevTools para comparar alguns instantâneos e ver o que está mudando.

Para alguns artigos úteis, confira

• RisingStack - Depurando aplicativos Node.js.
• Excelente artigo de David Mark Clements do nearForm

Se você quiser assistir a um vídeo, então

• Netflix JS Talks - Depuração do Node.js na produção
• Vídeo interessante do grupo de trabalho de rastreamento sobre rastreamento e depuração node.js
• Vídeo realmente informativo de 15 minutos no inspetor de nós

Seja qual for o caminho escolhido, certifique-se de entender como você está depurando

É uma coisa dolorosa
Olhar para o seu próprio problema e saber
Que você mesmo e mais ninguém conseguiu

Sophocles, Ajax

Theseus é um projeto da pesquisa da Adobe que permite depurar o código Node.js. nos suportes do editor de código-fonte aberto . Possui alguns recursos interessantes, como cobertura de código em tempo real, inspeção retroativa e árvore de chamadas assíncronas.

As ferramentas do Node.js. para o Visual Studio 2012 ou 2013 incluem um depurador. A visão geral aqui afirma "As ferramentas do Node.js. para o Visual Studio incluem suporte completo para aplicativos de nó de depuração". Sendo novo no Node.js, mas com experiência em .NET, achei esse complemento uma ótima maneira de depurar aplicativos Node.js.

O Visual Studio Code tem um suporte de depuração muito bom para o Node.js. É gratuito, de código aberto e multiplataforma e roda em Linux, OS X e Windows.

Você pode até depurar tarefas grunt e gulp , caso precise ...

Eu escrevi uma abordagem diferente para depurar o código Node.js, que é estável e extremamente simples. Está disponível em https://github.com/sa/iron-node .

Um depurador visual de plataforma cruzada de código-fonte aberto.

Instalação:

npm install iron-node -g;

Depurar:

iron-node yourscript.js;

Se você estiver usando o Atom IDE , poderá instalar o node-debuggerpacote.

Usando a versão 67.0.3396.62 do Chrome (+)

1. Executar aplicativo do nó

nó --inspect-brk = 0.0.0.0: 9229 server.js (nome do arquivo js do servidor)

2. Navegue no seu aplicativo no chrome, por exemplo, "localhost: port"
3. Abra o DevTools.
4. Clique no ícone do nó ao lado do ícone do dispositivo responsivo.

Haverá outra janela do DevTools que será exibida especificamente para o aplicativo do nó de depuração.

Criei uma pequena ferramenta interessante chamada pry.js que pode ajudá-lo.

Coloque uma declaração simples em algum lugar do seu código, execute seu script normalmente e o node interromperá o encadeamento atual, fornecendo acesso a todas as suas variáveis ​​e funções. Veja / edite / apague-os à vontade!

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

Há um cliente depurador de linha de comando interno no Node.js. O IDE do Cloud 9 também possui um depurador (visual) bastante agradável .

O Código do Visual Studio funcionará para nós na depuração.

Eu montei um pequeno iniciador de depuração do Node.js. usando o inspetor de nós para aqueles que não sabem ao certo por onde começar.

Use Webstorm! É perfeito para depurar aplicativos Node.js. Ele possui um depurador embutido. Confira os documentos aqui: https://www.jetbrains.com/help/webstorm/2016.1/running-and-debugging-node-js.html

Inicie o processo do nó com o sinalizador --inspect .

node --inspect index.js

e depois abra chrome://inspectno chrome. Clique no link "Abrir DevTools dedicado para Nó" ou instale este extensão do Chrome para abrir facilmente o DevTools do Chrome.

Para mais informações, consulte este link

Se você precisar de uma biblioteca de log poderosa para o Node.js, o Tracer https://github.com/baryon/tracer é a melhor opção.

Ele gera mensagens de registro com registro de data e hora, nome do arquivo, nome do método, número da linha, caminho ou pilha de chamadas, suporta console de cores e suporta banco de dados, arquivo e transporte de fluxo com facilidade. Eu sou o autor.

Supondo que você tenha o node-inspector instalado no seu computador (caso contrário, digite 'npm install -g node-inspector'), basta executar:

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

E cole o URI da linha de comando em um navegador WebKit (Chrome / Safari).

Apenas para completar:

O plugin PyCharm 3.0 + Node.js oferece uma experiência incrível de desenvolvimento, execução e depuração .

O IntelliJ funciona maravilhosamente para o Node.js.

Além disso, o IntelliJ suporta bem o 'Code Assistance'.

Existem muitas possibilidades ...

• nó inclui um utilitário de depuração
• inspetor de nós
• Editores de código / IDEs (consulte as instruções de depuração para um dos seguintes)
  • Atom ,
  • VSCode
  • Tempestade na Web
  • e mais

O suporte à depuração geralmente é implementado usando o v8 Debugging Protocol ou o Chrome Debugging Protocol mais recente .

Há o novo projeto Nodeclipse de código aberto (como um plug-in do Eclipse ou Enide Studio ):

O Nodeclipse tornou-se o número 1 nos 10 novos plug-ins do Eclipse para 2013 . Ele usa um V8 modificado depurador (do Google Chrome Developer Tools para Java).

O Nodeclipse é um software de código aberto gratuito lançado no início de cada mês .

O NetBeans IDE possui suporte ao Node.js. desde a versão 8.1 :

<...>

Destaques dos novos recursos

Desenvolvimento de aplicativos Node.js.

• Assistente de Novo Projeto Node.js.
• Assistente para novo Node.js Express
• Editor JavaScript aprimorado
• Novo suporte para a execução de aplicativos Node.js.
• Novo suporte para depuração de aplicativos Node.js.

<...>

Referências adicionais:

1. NetBeans Wiki / NewAndNoteworthyNB81 .
2. Aplicativo Node.js Express no NetBeans IDE, Geertjan-Oracle .

Use estes comandos

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

O ndb é uma experiência aprimorada de depuração para o Node.js, habilitada pelo Chrome DevTools

https://github.com/GoogleChromeLabs/ndb

Uma maneira rápida e suja de depurar pequenos scripts do Node.j com o depurador de navegador favorito seria usar o browserify . Observe que essa abordagem não funciona com aplicativos que exijam bibliotecas de E / S nativas, mas é boa o suficiente para a maioria dos scripts pequenos.

$ npm install -g browserify

Agora mova todas as suas var x = requires('x')chamadas para um requires.jsarquivo e execute:

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

(A desvantagem aqui é que você deve mover ou comentar requiresem todos os seus arquivos.)

Inclua o bundle.jsem um arquivo HTML da seguinte forma:

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

Agora carregue o arquivo no seu navegador e pressione F12e viola: debug no navegador.