CKTIS / JavaScript
clearTimeout — einen Timer abbrechen
clearTimeout(id) bricht einen ausstehenden Aufruf ab, der mit setTimeout() geplant wurde. Übergib dazu die zugehörige Timer-ID, nicht die Callback-Funktion. Das Argument ist optional: Ein Aufruf von clearTimeout() ohne Argument verwendet den Standardwert 0 und hat keine Wirkung.
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
clearTimeout()
clearTimeout(id)clearTimeout(id) bricht den Timer ab, der durch den von setTimeout() zurückgegebenen Wert gekennzeichnet ist. Die Funktion gibt undefined zurück. Sie ist eine API des HTML-Standards, die in Browserfenstern und Workern verfügbar ist, und kein Bestandteil von ECMAScript selbst. Der Standard nennt Unterstützung in allen aktuellen Browser-Engines; die Verfügbarkeit in Node 24 belegt keine Unterstützung der Browser-API.
Bewahre die ID auf und brich den Timer in derselben globalen Umgebung ab, in der er erstellt wurde. Eine ID, die nicht im Timerregister vorhanden ist, bewirkt nichts. Das Abbrechen unterbricht keinen Callback, der bereits ausgeführt wird, und macht dessen Auswirkungen nicht rückgängig.
clearTimeout() und clearInterval() verwenden ein gemeinsames Register, daher kann technisch jede der beiden Funktionen beide Timerarten abbrechen. Für bessere Lesbarkeit solltest du setTimeout() mit clearTimeout() und setInterval() mit clearInterval() kombinieren.
Im Beispiel erfolgt das Abbrechen synchron, bevor der Callback ausgeführt werden kann. Eine Verzögerung von 0 bedeutet nicht, dass etwas sofort ausgeführt wird. Daher wird nur cancelled ausgegeben.
Beispiele
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Ergebnis
cancelled
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.