libuv
Tu JavaScript corre en un solo hilo, pero Node.js no hace todo en ese hilo. libuv, la librería en C que está debajo, se encarga de la entrada y salida:
- La red la atiende el sistema operativo, que avisa cuando hay datos.
- Los archivos, la criptografía pesada y la compresión los hace un grupo de hilos auxiliares (cuatro por defecto).
Cuando una operación termina, libuv deja su callback en la cola de la fase que corresponde.
Las fases
Cada vuelta del event loop recorre estas fases, en orden:
| Fase | Qué callbacks corren |
|---|---|
| timers | Los de setTimeout y setInterval cuyo tiempo venció |
| pending callbacks | Algunos errores de sistema que quedaron pendientes |
| poll | Los de entrada y salida: datos de red, archivos leídos… Si no hay nada que hacer, el loop espera aquí |
| check | Los de setImmediate |
| close | Los de cierre, como socket.on("close") |
Y entre cada callback, de cualquier fase, Node.js vacía dos colas prioritarias:
- La de
process.nextTick. - La de microtareas: promesas y
queueMicrotask.
setImmediate o setTimeout
Como muestra el pizarrón, dentro de un callback de entrada y salida, setImmediate corre antes que setTimeout(…, 0): la fase check viene justo después de poll, y timers espera a la vuelta siguiente.
Desde el programa principal, en cambio, el orden entre los dos no está garantizado: depende de cuánto tardó el loop en arrancar. No escribas código que dependa de ese orden.
nextTick: con cuidado
process.nextTick(fn) corre fn apenas termine la operación actual, antes que cualquier promesa y que cualquier fase. Se usa, por ejemplo, para que una función siempre llame a su callback de forma asíncrona.
Pero su prioridad es un arma de doble filo: un nextTick que se agenda a sí mismo en bucle nunca deja avanzar al event loop. Para “hacer algo después”, prefiere setImmediate o queueMicrotask.
No bloquees el hilo
En un servidor, el único hilo atiende todas las peticiones. Si una petición hace algo síncrono y lento, las demás esperan:
import http from "node:http";
import { readFileSync } from "node:fs";
import { readFile } from "node:fs/promises";
http.createServer(async (req, res) => {
// ✗ Bloquea: mientras lee, nadie más es atendido
// const html = readFileSync("pagina.html", "utf8");
// ✓ No bloquea: libuv lee el archivo y el hilo sigue atendiendo
const html = await readFile("pagina.html", "utf8");
res.end(html);
}).listen(3000);
Lo mismo con cálculos pesados (cifrar, comprimir, procesar imágenes, un JSON enorme): o las versiones asíncronas de Node, o un worker thread, el próximo tema.
Resumen
- libuv hace la entrada y salida (la red con el sistema operativo y los archivos con un grupo de hilos) y avisa con callbacks.
- El loop recorre fases: timers → poll → check → close.
- Entre cada callback se vacían la cola de
nextTicky, después, la de microtareas. - Dentro de un callback de I/O,
setImmediategana asetTimeout(…, 0); desde el programa principal, el orden no está garantizado. - Nunca bloquees el hilo en un servidor: usa las APIs asíncronas o workers.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Fases y colas
Resuelto
Elige una respuesta en cada pregunta.
¿Quién hace el trabajo de entrada y salida (archivos, red) en Node.js?
¿Qué corre antes: un callback de
process.nextTicko elthende una promesa?Dentro del callback de una lectura de archivo, ¿qué corre primero,
setImmediateosetTimeout(…, 0)?¿Por qué un servidor no debe usar
fs.readFileSyncal atender cada petición?
Ordena la salida: nextTick, promesas e immediate
Resuelto
Las dos colas prioritarias de Node y una fase. Ordena lo que aparecería en la terminal.
1// orden.cjs: un archivo CommonJS2setImmediate(() => console.log("immediate"));3 4Promise.resolve().then(() => console.log("promesa"));5process.nextTick(() => console.log("nextTick"));6 7queueMicrotask(() => {8 console.log("microtarea");9 process.nextTick(() => console.log("nextTick desde una microtarea"));10});11 12console.log("síncrono");Consola, de arriba abajo
- nextTick desde una microtarea
- promesa
- síncrono
- immediate
- microtarea
- nextTick
Primero lo síncrono. Después la cola de nextTick, y después las microtareas, en orden. Un nextTick agregado desde una microtarea corre cuando esta termina, antes de pasar a las fases del event loop. setImmediate espera a la fase check. (Ojo: en un módulo ESM, todo el archivo se evalúa dentro de una microtarea, y ahí la promesa sale antes que el nextTick.)
Detective: Un rechazo que tumba el servidor
Resuelto
Un servidor se cae una vez por hora, cuando el inventario no responde. Encuentra la línea y elige el arreglo.
Consola
node:internal/process/promises:394
triggerUncaughtException(err, true /* fromPromise */);
^
Error: falló la consulta de stock
at consultarStock (file:///proyecto/stock.mjs:3:22)
Node.js v24.11.0Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?