Node.js
Construcción de servidores HTTP con Node.js: request, response, headers, streaming, routing básico, timeouts, errores y límites del módulo nativo.
El módulo expone las piezas fundamentales de un servidor HTTP: request, response, headers, body, conexión, timeouts y streaming. Express construye abstracciones sobre estas piezas; no las reemplaza.
node:httpsocket TCP
↓
parser HTTP
↓
IncomingMessage
↓
aplicación
↓
ServerResponseimport { createServer } from "node:http";
const server = createServer(async (req, res) => {
try {
const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
if (req.method === "GET" && url.pathname === "/health") {
res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
res.end(JSON.stringify({ status: "ok" }));
return;
}
res.writeHead(404, { "content-type": "application/json; charset=utf-8" });
res.end(JSON.stringify({ error: "Not found" }));
} catch (error) {
console.error(error);
if (!res.headersSent) {
res.writeHead(500, { "content-type": "application/json; charset=utf-8" });
}
res.end(JSON.stringify({ error: "Internal server error" }));
}
});
server.requestTimeout = 15_000;
server.headersTimeout = 10_000;
server.keepAliveTimeout = 5_000;
server.listen(3000, "127.0.0.1");req es un readable y res es un writable. Un body puede llegar en múltiples chunks.
async function readJson(req, limit = 1_000_000) {
const chunks = [];
let size = 0;
for await (const chunk of req) {
size += chunk.length;
if (size > limit) throw new Error("Body too large");
chunks.push(chunk);
}
return JSON.parse(Buffer.concat(chunks).toString("utf8"));
}Para archivos o respuestas grandes, evita concatenar: usa pipeline.
Content-Type describe formato.Content-Length mide bytes.No envíes headers después de comenzar el body.
Usa códigos según el resultado real:
2xx: operación aceptada o completada.4xx: request inválido, no autorizado o recurso ausente.5xx: el servidor no pudo cumplir una request válida.Un status correcto no reemplaza un body consistente ni logging interno.
const url = new URL(req.url, `http://${req.headers.host}`);
const page = Number(url.searchParams.get("page") ?? "1");El header Host puede ser manipulado. No lo uses para decisiones de seguridad sin una lista de hosts permitidos o configuración confiable.
import { createReadStream } from "node:fs";
import { pipeline } from "node:stream/promises";
res.writeHead(200, { "content-type": "application/octet-stream" });
await pipeline(createReadStream(filePath), res);Para servir archivos valida el path, tipo, tamaño y errores. Los range requests requieren interpretar Range, responder 206 y fijar Content-Range correctamente.
El cliente puede cerrar antes de completar request o response. Cancela trabajo costoso y no sigas escribiendo sobre recursos cerrados.
req.on("aborted", () => controller.abort());
res.on("close", () => controller.abort());Node incluye fetch estable en líneas modernas.
const response = await fetch(url, { signal });
if (!response.ok) throw new Error(`HTTP ${response.status}`);fetch no rechaza automáticamente por 404 o 500. Controla timeouts con AbortSignal y limita redirects, tamaños y destinos cuando la URL proviene de terceros.
Los clientes HTTP pueden reutilizar conexiones mediante pools. Esto reduce handshakes, pero requiere límites de sockets, tiempos de inactividad y observación de errores.
node:http.No asumas que HTTP/2 siempre es más rápido; depende de infraestructura, latencia y carga.
Una cookie es un header con estado del cliente. Seguridad exige flags como HttpOnly, Secure, SameSite, expiración y validación del contenido. Node no crea una política segura automáticamente.
Node HTTP → sockets, mensajes, streams, headers, timeouts
Express → routing, middleware, parsing y ergonomíaAprender el módulo nativo permite entender qué abstrae el framework y dónde aparecen límites.
¿Por qué una request con JSON pequeño puede llegar en varios chunks?
Porque TCP y los streams no preservan límites de mensajes; el body se reconstruye hasta el final o se procesa incrementalmente.
Desarrollo de CLI utiliza process, streams y señales en programas de terminal.