Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é exit codes?

    Os exit codes comunicam o resultado de um processo ao programa que o executou. Zero indica sucesso por convenção. Os demais números dependem do comando.

    Também chamado de: exit code, código de saída, códigos de saída, status de saída

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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 = 1

    A 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

    Aplicaçã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
    Capa da Formação Developer Workspace

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano