Conceptos Básicos del Bucle de Eventos

9 ejemplos para empezar con el Bucle de Eventos: 6 básicos y 3 intermedios.

Requisitos previos

• Node.js 24.18.0 instalado.
• Lee Cómo funciona Node.js para obtener una visión general de V8 + libuv.
• ¿Eres nuevo en el bucle de eventos? Comienza con El Bucle de Eventos de Node.js para el modelo conceptual sobre el que se construyen estos ejemplos.

Ejemplos Básicos

1. Orden de la Pila de Llamadas

El código síncrono se ejecuta hasta su finalización antes que cualquier devolución de llamada programada.

console.log('1');
console.log('2');
console.log('3');
// Salida: 1, 2, 3

• La pila de llamadas ejecuta un marco a la vez, en orden LIFO.
• Nada asíncrono se ejecuta hasta que la pila está vacía.
• Las funciones síncronas largas retrasan todas las devoluciones de llamada de E/S pendientes.

Relacionado: Cómo funciona Node.js - V8 y el hilo único

2. setTimeout Programa una Macrotarea

setTimeout no se ejecuta inmediatamente, sino que encola una devolución de llamada para una iteración posterior del bucle.

console.log('start');
setTimeout(() => console.log('timeout'), 0);
console.log('end');
// start, end, timeout

• 0 ms es un retraso mínimo, no una garantía; el bucle debe despejarse primero.
• Los temporizadores se ejecutan en la fase de temporizadores de libuv.
• El trabajo síncrono pesado entre setTimeout y su activación retrasa aún más la devolución de llamada.

Relacionado: Temporizadores y Programación - deriva bajo carga

3. Las Microtareas de Promesas se Ejecutan Antes que los Temporizadores

Las microtareas (Promise .then) se vacían antes de la siguiente macrotarea.

console.log('A');
setTimeout(() => console.log('B'), 0);
Promise.resolve().then(() => console.log('C'));
console.log('D');
// A, D, C, B

• Promise.resolve().then programa una microtarea en la cola de microtareas.
• Node vacía todas las microtareas antes de pasar a la siguiente fase de macrotareas.
• Este orden explica muchos errores de "¿por qué X se ejecutó antes que Y?".

Relacionado: Microtareas vs Macrotareas - reglas completas de ordenación

4. await Cede al Bucle de Eventos

await suspende la función asíncrona y se reanuda a través de microtareas.

async function demo(): Promise<void> {
  console.log('before');
  await Promise.resolve();
  console.log('after');
}
demo();
console.log('sync');
// before, sync, after

• El código después de await se ejecuta como una continuación de microtarea.
• Otras microtareas y código síncrono pueden intercalarse antes de after.
• Las cadenas await anidadas apilan microtareas; mantén las cadenas poco profundas cuando sea posible.

Relacionado: async/await en Node - patrones de manejo de errores

5. Lectura de Archivos No Bloqueante

fs.promises programa E/S en libuv y devuelve el control inmediatamente.

import { readFile } from 'node:fs/promises';
 
console.log('before read');
readFile('package.json', 'utf8').then((data) => {
  console.log('read', data.length, 'bytes');
});
console.log('after read');

• La devolución de llamada .then se ejecuta después de que la lectura del archivo se completa en un hilo en segundo plano.
• JavaScript entre before y after se ejecuta mientras la E/S está en curso.
• readFileSync bloquearía el bucle; evítalo en las rutas de solicitud.

6. setImmediate vs setTimeout(0)

setImmediate se ejecuta en la fase de verificación, después del sondeo de E/S.

import { setImmediate } from 'node:timers';
 
setTimeout(() => console.log('timeout'), 0);
setImmediate(() => console.log('immediate'));
// El orden varía en el nivel superior; dentro de las devoluciones de llamada de E/S, immediate suele ganar

• A nivel superior del módulo, el orden entre setTimeout(0) y setImmediate no está garantizado.
• Dentro de una devolución de llamada de E/S, setImmediate normalmente se ejecuta antes del siguiente temporizador.
• Prefiere queueMicrotask o setImmediate sobre setTimeout(fn, 0) para el aplazamiento.

Relacionado: Fases de libuv - fases de temporizadores, sondeo, verificación

Ejemplos Intermedios

7. Bloqueando el Bucle de Eventos

El trabajo de CPU en el hilo principal detiene todas las demás devoluciones de llamada.

import { createServer } from 'node:http';
 
function block(ms: number): void {
  const end = Date.now() + ms;
  while (Date.now() < end) { /* spin */ }
}
 
createServer((req, res) => {
  if (req.url === '/block') block(3000);
  res.end('ok');
}).listen(3000);

• Mientras se ejecuta block, ninguna otra solicitud progresa en este proceso.
• Las pruebas de carga muestran picos de p99 incluso cuando la latencia media parece buena.
• Descarga el trabajo de CPU a worker_threads o a una cola de trabajos.

Relacionado: Detectando el Bloqueo del Bucle de Eventos - mide el retraso en producción

8. Prioridad de process.nextTick

nextTick se ejecuta antes que otras microtareas; úsalo con moderación.

Promise.resolve().then(() => console.log('promise'));
process.nextTick(() => console.log('nextTick'));
// nextTick, promise

• La cola nextTick se vacía antes que las microtareas de Promise.
• nextTick recursivo puede agotar la E/S; nunca hagas un bucle con nextTick.
• Prefiere queueMicrotask para el aplazamiento a menos que necesites la semántica de nextTick.

Relacionado: Microtareas vs Macrotareas - ordenación de nextTick

9. Medir la Utilización del Bucle de Eventos

perf_hooks.eventLoopUtilization informa lo ocupado que está el bucle.

import { eventLoopUtilization } from 'node:perf_hooks';
 
const start = eventLoopUtilization();
setInterval(() => {
  const elu = eventLoopUtilization(start);
  console.log('utilization:', elu.utilization.toFixed(3));
}, 5000);

• Una utilización cercana a 1.0 significa que el bucle está saturado; escala u optimiza.
• Combínalo con métricas de latencia HTTP para correlacionar el problema del usuario con la salud del bucle.
• Exporta como un medidor de Prometheus para alertas.

Relacionado: Mejores Prácticas del Bucle de Eventos - reglas operativas

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