Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

queueMicrotask — programar una microtarea

queueMicrotask(callback) coloca una función breve en la cola de microtareas. Se ejecuta cuando termina el código síncrono actual, sin programar una tarea de temporizador aparte ni ceder tiempo al navegador para renderizar.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

queueMicrotask(callback)

queueMicrotask(callback) es una API web definida por el HTML Living Standard, no una función asignada a una edición concreta de ECMAScript. Está disponible en contextos de ventana y de worker. Recibe una función que se invoca sin argumentos y devuelve undefined, no una Promise. Comprueba typeof queueMicrotask === 'function' en el entorno de destino; la versión de Node usada en un repositorio no demuestra que el navegador admita esta API.

El callback no interrumpe el código síncrono actual. Se ejecuta en un punto de control de microtareas cuando la pila de ejecución está vacía. La cola se vacía en el orden de inserción, incluidas las microtareas añadidas mientras se procesa. En el ejemplo, microtask:3 se añade después de microtask:2, que ya estaba esperando.

A diferencia de setTimeout(callback, 0), esto no programa una tarea de temporizador aparte. Sirve para ordenar actualizaciones breves después del código síncrono. No traslada el trabajo a otro hilo: los callbacks largos o la incorporación continua de microtareas pueden bloquear el renderizado y el procesamiento de tareas posteriores.

Una excepción lanzada por el callback se comunica como un error, en vez de convertirse en un rechazo de promesa como ocurre con un callback de Promise.then. Un try...catch externo que rodee la propia llamada a queueMicrotask no puede capturar esa excepción posterior; si hace falta, gestiónala dentro del callback.

Ejemplos

(() => {
  const order = [];
  order.push('sync:start');

  queueMicrotask(() => {
    order.push('microtask:1');
    queueMicrotask(() => {
      order.push('microtask:3');
      console.log(order.join(' -> '));
    });
  });

  queueMicrotask(() => order.push('microtask:2'));
  order.push('sync:end');
})();

Resultado

sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes