Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

setTimeout — jednorazowe zaplanowanie funkcji

setTimeout planuje jednorazowe wykonanie funkcji bez blokowania bieżącego kodu. Opóźnienie nie gwarantuje dokładnego czasu wykonania, a zwrócony identyfikator pozwala anulować oczekujące wywołanie.

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

const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);

setTimeout to API zdefiniowane w HTML Standard dla okien i workerów, a nie funkcja samego ECMAScript. Planuje jednorazowe wywołanie funkcji; setInterval planuje powtarzanie. Przekaż funkcję callback, opóźnienie delayMs w milisekundach i opcjonalne args, które otrzyma funkcja. Przekazuj funkcję zamiast tekstu kodu, który wymaga kompilacji.

Wywołanie wraca bez czekania. Nawet przy opóźnieniu 0 funkcja oczekuje na późniejsze zadanie pętli zdarzeń — nie przerywa bieżącego kodu synchronicznego. Podany czas nie jest terminem gwarantowanym: wykonanie może nastąpić później. Gdy poziom zagnieżdżenia timera przekracza 5, opóźnienia poniżej 4 ms są podnoszone do 4 ms.

Przy planowaniu funkcji zwracany jest dodatni całkowity identyfikator id. clearTimeout(id) anuluje oczekujące wywołanie w tym samym środowisku globalnym. Nie zatrzymuje funkcji, która już się wykonuje.

Przykład anuluje jeden timer i przekazuje "timer" jako argument drugiemu. Kod synchroniczny dodaje "end" przed wykonaniem funkcji timera, więc oczekiwany wynik to start -> end -> timer. Sprawdzaj kolejność, nie dokładny czas.

Przykłady

(() => {
  const events = ["start"];
  const id = setTimeout(() => events.push("cancelled"), 0);
  clearTimeout(id);

  setTimeout((message) => {
    events.push(message);
    console.log(events.join(" -> "));
  }, 0, "timer");

  events.push("end");
})();

Wynik

start -> end -> timer

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła