WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen