O REPL & Experimentos Rápidos

O REPL (Read-Eval-Print Loop) do Node.js é um shell interativo para sondar APIs, inspecionar objetos e validar suposições antes de confirmar código em um arquivo.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

node                          # inicia o REPL
node --env-file=.env          # pré-carrega variáveis de ambiente no contexto do REPL
node -e "console.log(process.version)"
node --input-type=module -e "import { ok } from 'node:assert'; ok(1)"

Quando usar isso:

• Explorar os formatos de retorno de um pacote npm desconhecido
• Verificar rapidamente regex, cálculos de data ou codificação de Buffer
• Depurar uma resposta fetch única antes de integrá-la a um serviço
• Ensinar aos colegas como process ou import.meta se comportam

Exemplo de Trabalho

# Inicia o REPL com arquivo de ambiente (Node 20+)
node --env-file=.env.development

> const { readFile } = await import('node:fs/promises')
> const raw = await readFile('package.json', 'utf8')
> const pkg = JSON.parse(raw)
> pkg.engines
{ node: '>=24.18.0 <25' }
 
> // Inspeciona cabeçalhos do fetch integrado
> const res = await fetch('https://httpbin.org/headers')
> [...res.headers.entries()].slice(0, 3)
[
  [ 'content-type', 'application/json' ],
  [ 'content-length', '...' ],
  [ 'date', '...' ]
]
 
> .save repl-session.js
> .exit

O que isso demonstra:

• O await de nível superior funciona no REPL sem precisar envolvê-lo em uma função async
• O import() dinâmico carrega built-ins ESM dentro da sessão do REPL
• .save grava cada expressão avaliada em um arquivo para limpeza posterior
• --env-file espelha o carregamento de configuração de produção durante os experimentos

Mergulho Profundo

Como Funciona

• O REPL compila cada linha com o V8, mantém um contexto persistente (global) e imprime os resultados das expressões.
• A entrada de múltiplas linhas é aberta quando chaves não são fechadas - cole funções assíncronas ou literais de objeto livremente.
• _ contém o último resultado avaliado; _error contém o último erro lançado (convenção do REPL do Node).
• Comandos de ponto (.help, .break, .clear) são metacomandos e não são enviados ao V8.

Comandos de Ponto Úteis

Notas sobre TypeScript

# Executa TypeScript em one-liners semelhantes ao REPL com tsx
npx tsx -e "const x: number = 42; console.log(x)"
 
# Ou inicia o REPL tsx para experimentos tipados
npx tsx

Para exploração tipada, o REPL tsx é preferível ao node puro quando você precisa de interfaces e genéricos.

Armadilhas

• Enviar saída de .save diretamente - sessões salvas incluem prompts > e podem faltar imports. Correção: refatore para um módulo adequado e adicione testes.
• Segredos no histórico do REPL - chaves de API coladas persistem em .node_repl_history. Correção: use .clear em linhas sensíveis; nunca use .save em sessões com segredos.
• Assumir que REPL === escopo de módulo de produção - require não é definido em projetos com ESM primeiro. Correção: use await import() ou inicie com --input-type=module.
• Grandes dumps de objetos - console.log(hugeArray) bloqueia o terminal. Correção: use util.inspect(obj, { depth: 2, maxArrayLength: 10 }).
• Sem cobertura de teste das verificações do REPL - experimentos validam a intuição, não regressões. Correção: copie os trechos validados para casos node:test.

Alternativas

FAQs

node --input-type=module
> import.meta.url
'file:///...'

Relacionados

• Fundamentos do Node.js - primeiros comandos node
• Executando Scripts & Shebang - quando experimentos se tornam scripts
• Lendo a Documentação Oficial & Diagnósticos - aprofunde-se após surpresas no REPL
• node:test - promova experimentos para testes

Versões do Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 e NestJS 11.