Saltar al contenido
JavaScript en el servidor

Node.js hoy

Lección 1 de 711 min3 ejercicios

Node.js llevó JavaScript fuera del navegador en 2009: el mismo motor V8, pero con acceso a archivos, red y procesos. Hoy es la base de servidores, herramientas de línea de comandos y de casi todo el ecosistema de desarrollo web. Y cambió mucho: si aprendiste Node hace unos años, muchas de las librerías que usabas ya no hacen falta.

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, styleText y node:sqlite.
  • Un hashbang (#!/usr/bin/env node) en la primera línea convierte el archivo en un comando (ES2023).
  • node archivo.ts ejecuta 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

Elige una respuesta en cada pregunta.

  1. ¿Para qué sirve el prefijo node: en import fs from "node:fs"?

  2. ¿Qué hace node --watch servidor.js?

  3. ¿Necesitas instalar una librería para hacer peticiones HTTP en Node.js moderno?

  4. ¿Qué versiones de Node.js conviene usar en producción?

Ordena la salida: Argumentos de la línea de comandos

Un programa de línea de comandos que lee sus argumentos. Ordena lo que aparecería en la terminal.

import { parseArgs } from "node:util"; // Lo mismo que: node saludo.js --nombre Ana -v extraconst { values, positionals } = parseArgs({  args: ["--nombre", "Ana", "-v", "extra"],  options: {    nombre: { type: "string" },    verboso: { type: "boolean", short: "v" },  },  allowPositionals: true,}); console.log(values.nombre);console.log(values.verboso);console.log(positionals.join());console.log(typeof process.argv[0]);

Consola, de arriba abajo

  1. extra
  2. Ana
  3. string
  4. true

Detective: Una variable que ya no existe

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 scope

Paso 1: toca la línea de código que causa el error.

domina-js · JavaScript en español, gratis y paso a paso.