CKTIS / JavaScript
queueMicrotask — planifier une microtâche
queueMicrotask(callback) place une fonction courte dans la file des microtâches. Elle s’exécute lorsque le code synchrone en cours est terminé, sans planifier une tâche de minuterie distincte ni laisser au navigateur le temps d’effectuer le rendu.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
queueMicrotask(callback)queueMicrotask(callback) est une API Web définie par le HTML Living Standard, et non une fonction rattachée à une édition particulière d’ECMAScript. Elle est disponible dans les contextes de fenêtre et de worker. Elle prend une fonction appelée sans argument et renvoie undefined, pas une Promise. Dans l’environnement cible, vérifiez typeof queueMicrotask === 'function' ; la version de Node utilisée dans un dépôt ne prouve pas que l’API est prise en charge par le navigateur.
Le callback n’interrompt pas le code synchrone en cours. Il s’exécute lors d’un point de contrôle des microtâches, quand la pile d’exécution est vide. La file est vidée dans l’ordre d’ajout, y compris les microtâches ajoutées pendant son traitement. Dans l’exemple, microtask:3 est ajoutée après microtask:2, qui était déjà en attente.
Contrairement à setTimeout(callback, 0), cela ne planifie pas une tâche de minuterie distincte. Cette méthode convient pour ordonner de courtes mises à jour après du code synchrone. Elle ne déplace pas le travail vers un autre thread : des callbacks longs ou l’ajout continu de microtâches peuvent bloquer le rendu et le traitement des tâches suivantes.
Une exception levée par le callback est signalée comme une erreur, au lieu d’être transformée en rejet de promesse comme avec un callback Promise.then. Un try...catch externe entourant l’appel à queueMicrotask lui-même ne peut pas intercepter cette exception ultérieure ; gérez-la à l’intérieur du callback si nécessaire.
Exemples
(() => {
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');
})();Résultat
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.