CKTIS / JavaScript
queueMicrotask — kolejkowanie mikrozadania
queueMicrotask(callback) odkłada krótką funkcję do kolejki mikrozadań. Wykona się ona po zakończeniu bieżącego kodu synchronicznego, bez planowania osobnego zadania timera ani oddawania przeglądarce czasu na renderowanie.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
queueMicrotask(callback)queueMicrotask(callback) to API środowiska WWW zdefiniowane w HTML Living Standard, a nie funkcja przypisana do konkretnej edycji ECMAScript. Jest udostępniane w kontekstach okna i workerów. Przyjmuje funkcję wywoływaną bez argumentów i zwraca undefined, nie Promise. W środowisku docelowym sprawdź typeof queueMicrotask === 'function'; wersja Node używana w repozytorium nie dowodzi obsługi w przeglądarce.
Callback nie przerywa bieżącego kodu synchronicznego. Uruchamia się podczas punktu kontrolnego mikrozadań, gdy stos wykonywania jest pusty. Kolejka jest opróżniana w kolejności dodawania, również z mikrozadań dodanych w trakcie jej obsługi. W przykładzie microtask:3 trafia za już oczekujące microtask:2.
W odróżnieniu od setTimeout(callback, 0) nie planuje to osobnego zadania timera. Nadaje się do porządkowania krótkich aktualizacji po kodzie synchronicznym. Nie przenosi pracy do innego wątku: długie callbacki lub ciągłe dopisywanie mikrozadań mogą blokować renderowanie i obsługę kolejnych zadań.
Wyjątek rzucony przez callback jest raportowany jako błąd, a nie zamieniany w odrzucenie obietnicy jak w callbacku Promise.then. Zewnętrzny try...catch otaczający samo wywołanie queueMicrotask nie przechwyci tego późniejszego wyjątku; w razie potrzeby obsłuż go wewnątrz callbacku.
Przykłady
(() => {
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');
})();Wynik
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.