Conceptos básicos de las API integradas

8 ejemplos para empezar a usar las API integradas de Node: 6 básicos y 2 intermedios.

Prerrequisitos

• Node.js 24.18.0 - los módulos integrados se incluyen con el tiempo de ejecución.
• Prefiere import from 'node:…' en proyectos ESM.

Ejemplos básicos

1. Importación con prefijo node:

Importa los módulos integrados explícitamente y evita el sombreado.

import { readFile } from 'node:fs/promises';
import { createServer } from 'node:http';
import path from 'node:path';

• El prefijo node: es opcional pero recomendado en el código de la aplicación.
• Los módulos integrados no están en las dependencias de package.json.
• Las tipificaciones provienen de @types/node en devDependencies.

2. fs/promises readFile

Lectura de archivos asíncrona sin util.promisify.

import { readFile } from 'node:fs/promises';
 
const pkg = JSON.parse(await readFile('package.json', 'utf8'));
console.log(pkg.name);

• Siempre especifica la codificación para texto o se obtendrá un Buffer.
• Usa createReadStream para archivos grandes.
• Maneja ENOENT con try/catch para archivos de configuración opcionales.

Relacionado: fs y fs/promises - streams y flags

3. path.join y fileURLToPath

Rutas portátiles en ESM sin __dirname.

import path from 'node:path';
import { fileURLToPath } from 'node:url';
 
const __filename = fileURLToPath(import.meta.url);
const configPath = path.join(path.dirname(__filename), 'config.json');

• path.join normaliza los separadores para la plataforma.
• Nunca concatenes rutas con / manualmente en el código de la biblioteca.
• Usa path.posix.join para claves de almacenamiento de objetos en todas las plataformas.

Relacionado: path y url - URL vs path

4. Servidor node:http

HTTP mínimo sin Express.

import { createServer } from 'node:http';
 
createServer((req, res) => {
  res.writeHead(200, { 'content-type': 'text/plain' });
  res.end('ok');
}).listen(3000);

• Está bien para comprobaciones de estado y sondeos internos.
• Las API de producción suelen añadir Express 5 o Fastify 5 para el enrutamiento.
• Establece tiempos de espera en el servidor (server.requestTimeout) en Node 24.

5. crypto.randomUUID

Identificadores sin el paquete uuid.

import { randomUUID } from 'node:crypto';
 
const id = randomUUID();
console.log(id);

• UUID v4 criptográficamente fuerte.
• También randomBytes para tokens - codifica como base64url.
• Consulta crypto para hashing y HMAC.

6. timers/promises sleep

Retraso basado en promesas sin npm.

import { setTimeout } from 'node:timers/promises';
 
await setTimeout(100);
console.log('after delay');

• Acepta AbortSignal para retrasos cancelables.
• setInterval sigue siendo basado en callbacks para trabajo periódico.
• Consulta Timers y Scheduler.

Ejemplos intermedios

7. fetch (integrado)

Cliente HTTP sin axios para llamadas salientes simples.

const res = await fetch('https://nodejs.org/dist/index.json');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();

• fetch global en Node 24 - misma API que los navegadores.
• Configura agentes/tiempos de espera a través de las opciones de undici cuando sea necesario.
• Para políticas de reintento avanzadas, consulta got/axios.

8. util.parseEnv y styleText (Node 24)

Utilidades modernas para el entorno y la salida de la CLI.

import { parseEnv } from 'node:util';
import { styleText } from 'node:util';
 
const env = parseEnv('PORT=3000\nNODE_ENV=production');
console.log(styleText('green', 'boot'), env.PORT);

• parseEnv analiza cadenas de estilo dotenv en memoria.
• Prefiere Zod para la validación de entorno de producción.
• Consulta util y diagnostics.

Relacionado: Zod en los límites - valida el entorno

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