CKTIS / JavaScript
setTimeout — eine Funktion einmalig einplanen
setTimeout plant eine Funktion zur einmaligen Ausführung ein, ohne den aktuellen Code zu blockieren. Die Verzögerung garantiert keinen genauen Ausführungszeitpunkt; mit der zurückgegebenen Kennung lässt sich der ausstehende Aufruf abbrechen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);setTimeout ist eine vom HTML Standard definierte API für Fenster und Worker, keine Funktion von ECMAScript selbst. Sie plant eine Funktion zur einmaligen Ausführung ein; setInterval plant Wiederholungen ein. Übergib eine Funktion callback, eine Verzögerung delayMs in Millisekunden und optionale args, die an die Funktion übergeben werden. Übergib eine Funktion statt eines Code-Texts, der kompiliert werden müsste.
Der Aufruf kehrt zurück, ohne zu warten. Auch bei einer Verzögerung von 0 wartet der Callback auf eine spätere Aufgabe der Ereignisschleife; er unterbricht den aktuell ausgeführten synchronen Code nicht. Der angegebene Zeitpunkt ist nicht garantiert, und die Ausführung kann später erfolgen. Wenn die Verschachtelungsebene des Timers größer als 5 ist, werden Verzögerungen unter 4 ms auf 4 ms angehoben.
Beim Einplanen einer Funktion wird eine positive ganzzahlige Kennung id zurückgegeben. clearTimeout(id) bricht den ausstehenden Aufruf in derselben globalen Umgebung ab. Eine bereits ausgeführte Callback-Funktion wird dadurch nicht angehalten.
Das Beispiel bricht einen Timer ab und übergibt einem anderen "timer" als Argument. Der synchrone Code fügt "end" hinzu, bevor der Timer-Callback ausgeführt wird. Daher lautet das erwartete Ergebnis start -> end -> timer. Prüfe die Reihenfolge, nicht die genaue verstrichene Zeit.
Beispiele
(() => {
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");
})();Ergebnis
start -> end -> timer
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.