Lo que es
Node.js es un runtime: el motor V8 más una biblioteca propia (archivos, red, procesos, criptografía) y un event loop basado en la librería libuv. No tiene document ni window; tiene process, módulos como node:fs y node:http, y acceso completo a tu sistema.
node --version # v24.x
node programa.js # ejecutar un archivo
node # consola interactiva (REPL)
node -e 'console.log(1 + 1)'
Módulos: ESM y el prefijo node:
Los proyectos nuevos usan ESM ("type": "module" en el package.json, o archivos .mjs), como viste en la sección de Módulos. Los módulos propios de Node se importan con el prefijo node::
import { readFile } from "node:fs/promises";
import { join } from "node:path";
import { randomUUID } from "node:crypto";
const config = JSON.parse(await readFile(join(import.meta.dirname, "config.json"), "utf8"));
console.log(config.nombre, randomUUID());
Lo que ya viene incluido
Cosas que antes necesitaban un paquete de npm:
| Antes | Ahora |
|---|---|
node-fetch, axios |
fetch global |
ws (cliente) |
WebSocket global |
nodemon |
node --watch app.js |
dotenv |
node --env-file=.env app.js o process.loadEnvFile() |
jest, mocha |
node --test y node:test |
ts-node, compilar antes |
node app.ts (quita los tipos y ejecuta) |
yargs, minimist |
parseArgs de node:util |
chalk |
styleText de node:util |
sqlite3 |
node:sqlite |
uuid |
crypto.randomUUID() |
import { styleText } from "node:util";
console.log(styleText(["green", "bold"], "✔ Listo"));
console.log(process.env.PUERTO ?? "3000"); // con --env-file=.env
Scripts ejecutables: el hashbang
Si la primera línea de un archivo empieza con #!, el sistema la usa para saber con qué programa ejecutarlo. Node siempre la aceptó, y desde ES2023 es parte del lenguaje: cualquier motor la ignora sin dar error.
#!/usr/bin/env node
// saludar.js
const nombre = process.argv[2] ?? "mundo";
console.log(`Hola, ${nombre}`);
chmod +x saludar.js
./saludar.js Ana # Hola, Ana
Tiene que ser la primera línea, sin nada antes. En Windows no se usa; ahí ejecutas node saludar.js. Es lo que llevan los comandos que instala npm (el campo bin del package.json).
TypeScript sin compilar
Desde Node 23.6 (y en las versiones LTS siguientes), node archivo.ts funciona directamente: Node borra las anotaciones de tipos y ejecuta el resto. No revisa los tipos (para eso sigue estando tsc), y solo admite la sintaxis de TypeScript que se puede borrar sin más: nada de enum ni de namespace con código. Lo vas a ver en TypeScript para quien ya sabe JS.
Versiones
Node publica una versión mayor cada seis meses. Las pares (22, 24, 26…) se convierten en LTS (long-term support) y tienen unos tres años de correcciones: son las que se usan en producción. Las impares son para probar lo que viene.
Para tener varias versiones instaladas y cambiar entre ellas, usa un gestor como fnm, nvm o Volta, y fija la del proyecto en un archivo .node-version o en el campo engines del package.json.
Resumen
- Node.js = V8 + libuv + una biblioteca para archivos, red y procesos. No tiene DOM.
- ESM e imports con el prefijo
node:. - Vienen incluidos
fetch,WebSocket,--watch,--env-file,node --test,parseArgs,styleTextynode:sqlite. - Un hashbang (
#!/usr/bin/env node) en la primera línea convierte el archivo en un comando (ES2023). node archivo.tsejecuta TypeScript quitando los tipos.- En producción, versiones LTS (pares).
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Lo que trae Node.js
Resuelto
Elige una respuesta en cada pregunta.
¿Para qué sirve el prefijo
node:enimport fs from "node:fs"?¿Qué hace
node --watch servidor.js?¿Necesitas instalar una librería para hacer peticiones HTTP en Node.js moderno?
¿Qué versiones de Node.js conviene usar en producción?
Ordena la salida: Argumentos de la línea de comandos
Resuelto
Un programa de línea de comandos que lee sus argumentos. Ordena lo que aparecería en la terminal.
1import { parseArgs } from "node:util";2 3// Lo mismo que: node saludo.js --nombre Ana -v extra4const { values, positionals } = parseArgs({5 args: ["--nombre", "Ana", "-v", "extra"],6 options: {7 nombre: { type: "string" },8 verboso: { type: "boolean", short: "v" },9 },10 allowPositionals: true,11});12 13console.log(values.nombre);14console.log(values.verboso);15console.log(positionals.join());16console.log(typeof process.argv[0]);Consola, de arriba abajo
- extra
- Ana
- string
- true
parseArgs (de node:util) interpreta los argumentos: --nombre lleva un valor, -v es el atajo de verboso, y lo que sobra queda en positionals. Sin args, lee process.argv, cuyo primer elemento es la ruta del ejecutable de Node.
Detective: Una variable que ya no existe
Resuelto
Un servidor pasado de CommonJS a ESM deja de arrancar. Encuentra la línea y elige el arreglo.
Consola
file:///proyecto/servidor.mjs:5
const datos = await readFile(join(__dirname, "datos.json"), "utf8");
^
ReferenceError: __dirname is not defined in ES module scopePaso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?