Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła