WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

queueMicrotask — ein Microtask einreihen

queueMicrotask(callback) reiht eine kurze Funktion in die Microtask-Warteschlange ein. Sie wird ausgeführt, sobald der aktuelle synchrone Code beendet ist, ohne einen separaten Timer-Task einzuplanen oder dem Browser Zeit zum Rendern zu geben.

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

Syntax

queueMicrotask(callback)

queueMicrotask(callback) ist eine Web-API, die im HTML Living Standard definiert ist, und keine Funktion, die einer bestimmten ECMAScript-Version zugeordnet ist. Sie steht in Fenster- und Worker-Kontexten zur Verfügung. Sie nimmt eine Funktion entgegen, die ohne Argumente aufgerufen wird, und gibt undefined zurück, kein Promise. Prüfe in der Zielumgebung typeof queueMicrotask === 'function'; die in einem Repository verwendete Node-Version belegt nicht, dass die API im Browser unterstützt wird.

Der Callback unterbricht den aktuell ausgeführten synchronen Code nicht. Er läuft an einem Microtask-Kontrollpunkt, wenn der Ausführungsstapel leer ist. Die Warteschlange wird in der Reihenfolge geleert, in der Einträge hinzugefügt wurden, einschließlich Microtasks, die währenddessen hinzukommen. Im Beispiel wird microtask:3 hinter das bereits wartende microtask:2 eingereiht.

Anders als setTimeout(callback, 0) plant dies keinen separaten Timer-Task ein. Es eignet sich, um kurze Aktualisierungen nach synchronem Code anzuordnen. Die Arbeit wird dadurch nicht auf einen anderen Thread verlagert: Lange Callbacks oder das fortlaufende Hinzufügen von Microtasks können das Rendern und die Verarbeitung nachfolgender Tasks blockieren.

Eine vom Callback ausgelöste Ausnahme wird als Fehler gemeldet und nicht wie bei einem Promise.then-Callback in eine Promise-Ablehnung umgewandelt. Ein äußeres try...catch um den Aufruf von queueMicrotask selbst kann diese spätere Ausnahme nicht abfangen; fange sie bei Bedarf innerhalb des Callbacks ab.

Beispiele

(() => {
  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');
})();

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen