El REPL y los Experimentos Rápidos

El REPL de Node.js es un shell interactivo para sondear APIs, inspeccionar objetos y validar suposiciones antes de que confirmes el código en un archivo.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

node                          # iniciar REPL
node --env-file=.env          # precargar variables de entorno en el contexto del REPL
node -e "console.log(process.version)"
node --input-type=module -e "import { ok } from 'node:assert'; ok(1)"

Cuándo usarlo:

• Explorar las formas de retorno de un paquete npm desconocido
• Verificar rápidamente expresiones regulares, cálculos de fechas o codificación de Buffer
• Depurar una respuesta fetch única antes de conectarla a un servicio
• Enseñar a los compañeros de equipo cómo se comportan process o import.meta

Ejemplo de Funcionamiento

# Iniciar REPL con archivo .env (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' }
 
> // Inspeccionar encabezados de fetch incorporados
> 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

Lo que esto demuestra:

• await de nivel superior funciona en el REPL sin envolverlo en una función asíncrona
• import() dinámico carga módulos ESM incorporados dentro de la sesión REPL
• .save escribe cada expresión evaluada en un archivo para su posterior limpieza
• --env-file refleja la carga de configuración de producción durante los experimentos

Análisis Profundo

Cómo Funciona

• El REPL compila cada línea con V8, mantiene un contexto persistente (global) e imprime los resultados de las expresiones.
• La entrada multilínea se abre cuando las llaves están sin cerrar; pega funciones asíncronas o literales de objetos libremente.
• _ contiene el último resultado evaluado; _error contiene el último error lanzado (convención del REPL de Node).
• Los comandos de punto (.help, .break, .clear) son metacomandos y no se envían a V8.

Comandos de Punto Útiles

Notas de TypeScript

# Ejecuta TypeScript en líneas individuales tipo REPL con tsx
npx tsx -e "const x: number = 42; console.log(x)"
 
# O inicia el REPL de tsx para experimentos tipados
npx tsx

Para la exploración tipada, el REPL de tsx es preferible al node simple cuando necesitas interfaces y genéricos.

Errores comunes

• Desplegar directamente la salida de .save - las sesiones guardadas incluyen los prompts > y pueden carecer de importaciones. Solución: refactoriza en un módulo adecuado y añade pruebas.
• Secretos en el historial del REPL - las claves API pegadas persisten en .node_repl_history. Solución: .clear las líneas sensibles; nunca .save sesiones con secretos.
• Asumir que REPL === ámbito de módulo de producción - require no está definido en proyectos ESM-first. Solución: usa await import() o inicia con --input-type=module.
• Volcados de objetos grandes - console.log(hugeArray) bloquea el terminal. Solución: usa util.inspect(obj, { depth: 2, maxArrayLength: 10 }).
• Sin cobertura de pruebas a partir de las comprobaciones del REPL - los experimentos validan la intuición, no las regresiones. Solución: copia los fragmentos validados en casos de node:test.

Alternativas

Preguntas Frecuentes

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

Relacionado

• Conceptos Básicos de Node.js - primeros comandos de node
• Ejecución de Scripts y Shebang - cuando los experimentos se convierten en scripts
• Lectura de la Documentación Oficial y Diagnósticos - profundiza después de las sorpresas del REPL
• node:test - pasa los experimentos a pruebas

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS Activo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.