O resultado recebido pelo programa que iniciou o processo
Os exit codes são números que comunicam o resultado de um processo ao programa que o executou. A convenção usa zero para sucesso e valores diferentes de zero para outros resultados, cujos significados dependem do comando.
Um script pode consultar esse status para continuar uma sequência ou interrompê-la. O número resume o resultado definido pelo programa, por isso a mensagem de erro ainda é necessária para explicar a causa de uma falha.
Definir uma falha no Node.js
Este exemplo didático imprime uma mensagem e define o código usado no encerramento normal do processo:
console.error('Configuração inválida: falta a porta do serviço.')process.exitCode = 1A chamada a console.error escreve a explicação na saída de erro. A atribuição a process.exitCode define o status 1, mas permite que o Node.js conclua o trabalho pendente. Quando não houver mais trabalho mantendo o processo ativo, ele encerra com esse código. O exemplo representa uma verificação já reprovada e não procura um arquivo nem valida uma porta.
Mensagem e status precisam ser coerentes
Um aviso pode acompanhar um encerramento bem-sucedido. Também é possível receber um status de falha com pouca explicação. Para conferir o comportamento de um comando, você pode executá-lo com uma entrada válida e outra inválida, comparando as mensagens e os códigos obtidos.
O programa que chama esse comando precisa tratar os resultados conforme a documentação. Encerrar com um número diferente de zero só interrompe uma sequência quando o script que a conduz reage a esse status.
Dúvidas frequentes
Perguntas frequentes sobre exit codes
- Zero confirma que a aplicação fez tudo corretamente?
- Zero indica o sucesso definido pelo comando. Um programa pode encerrar com zero mesmo após uma verificação incompleta, por isso o código precisa corresponder ao comportamento documentado.
- O código 1 tem o mesmo significado em todo programa?
- Não. Ele costuma indicar falha, mas o motivo específico depende da ferramenta. Consulte a documentação e a mensagem produzida pelo comando.
- Escrever uma mensagem de erro muda o código de saída?
- Não. A mensagem e o status são informações distintas. No Node.js, uma chamada a console.error escreve na saída de erro, mas o programa precisa definir o status ou terminar por uma condição que o determine.
Para continuar
Recursos relacionados
Documentação
Node.js: códigos de saída
Documenta process.exitCode e os códigos de encerramento definidos pelo Node.js.
Abrir recursoAplicação na formação
Developer Workspace
Os scripts precisam interpretar o resultado dos processos para continuar ou encerrar uma sequência de comandos.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.