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.