O destino da saída padrão
O stdout, abreviação de standard output, é o canal de saída padrão de um processo. Ele pode levar o resultado ao terminal ou a um arquivo. Um pipe permite conectar essa saída à entrada de outro programa, que recebe o conteúdo para continuar o processamento.
No Node.js, process.stdout escreve no descritor de arquivo 1. O stderr (standard error) usa o descritor 2 e oferece um canal separado para diagnósticos. O destino de cada canal pode ser configurado de forma independente.
Um documento JSON e uma mensagem de andamento
Este exemplo didático em Node.js escreve o resultado e o diagnóstico em canais diferentes:
console.log(JSON.stringify({ arquivos: 3 }))console.error('Verificação encerrada')O console.log global envia {"arquivos":3} seguido de uma quebra de linha ao stdout. O console.error global envia a mensagem ao stderr. Um programa conectado apenas ao stdout recebe o documento JSON, mesmo que as duas mensagens apareçam no terminal durante uma execução interativa.
Trocar a segunda chamada por console.log acrescentaria a mensagem ao mesmo canal do documento. Você pode capturar os canais separadamente para conferir se a falha de leitura vem desse texto adicional. A separação depende de o comando que inicia o processo conservar os dois canais distintos.
Mensagens e encerramento do processo
Uma mensagem no stderr não determina o código de saída. O programa pode escrever um aviso nesse canal e encerrar normalmente, por isso a automação precisa conferir também a condição de término.
No Node.js, a escrita pode ser assíncrona conforme o sistema operacional e o destino. Chamar process.exit() com uma escrita ainda pendente pode truncar a saída. A implementação precisa permitir que o envio termine para que o próximo programa receba o documento completo.
Dúvidas frequentes
Perguntas frequentes sobre stdout
- O stdout sempre aparece no terminal?
- O destino depende de como o processo foi iniciado. A saída pode aparecer no terminal, ser gravada em um arquivo ou alimentar outro programa por um pipe.
- Uma mensagem no stderr significa que o comando falhou?
- O stderr também pode receber avisos e mensagens de andamento. O código de saída informa a condição de término escolhida pelo programa, independentemente do canal usado para as mensagens.
- Por que um aviso no stdout pode invalidar um JSON?
- Um consumidor que espera um documento JSON também recebe o aviso escrito nesse canal. O texto adicional não pertence ao documento e pode causar uma falha na leitura.
Para continuar
Recursos relacionados
Documentação
Node.js: stdout e entrada e saída de processos
Documenta o descritor do stdout e as diferenças de escrita conforme o sistema operacional e o destino.
Abrir recursoAplicação na formação
Developer Workspace
A saída padrão permite conectar ferramentas de terminal e interpretar resultados recebidos por outros programas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.