Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é stdout?

    O stdout é a saída padrão de um processo e pode alimentar arquivos ou outros programas. Separar os diagnósticos no stderr preserva o formato do resultado.

    Também chamado de: standard output, saída padrão

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

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

    Aplicaçã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
    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