KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

queueMicrotask — een microtask inplannen

queueMicrotask(callback) plaatst een korte functie in de microtaskwachtrij. De functie wordt uitgevoerd zodra de huidige synchrone code klaar is, zonder een afzonderlijke timertaak in te plannen of de browser tijd te geven om te renderen.

Versie: 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) is een Web-API die is gedefinieerd door de HTML Living Standard, geen functie die bij een bepaalde ECMAScript-editie hoort. De API is beschikbaar in window- en worker-contexten. Ze neemt een functie aan die zonder argumenten wordt aangeroepen en geeft undefined terug, geen Promise. Controleer typeof queueMicrotask === 'function' in de doelomgeving; de Node-versie die in een repository wordt gebruikt, bewijst niet dat de browser de API ondersteunt.

De callback onderbreekt de huidige synchrone code niet. Hij wordt uitgevoerd tijdens een microtask-checkpoint, wanneer de uitvoeringsstack leeg is. De wachtrij wordt leeggemaakt in de volgorde waarin items zijn toegevoegd, ook voor microtasks die tijdens de verwerking worden toegevoegd. In het voorbeeld wordt microtask:3 toegevoegd na microtask:2, dat al klaarstond.

Anders dan setTimeout(callback, 0) plant dit geen afzonderlijke timertaak in. Het is geschikt om korte updates na synchrone code te ordenen. Het verplaatst het werk niet naar een andere thread: lange callbacks of voortdurend microtasks toevoegen kan het renderen en het verwerken van volgende taken blokkeren.

Een uitzondering die door de callback wordt gegooid, wordt als fout gemeld en niet omgezet in een promise-afwijzing zoals bij een Promise.then-callback. Een externe try...catch rond de aanroep van queueMicrotask zelf kan die latere uitzondering niet opvangen; handel deze zo nodig binnen de callback af.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen