KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

clearTimeout — een timer annuleren

clearTimeout(id) annuleert een wachtende aanroep die met setTimeout() is gepland. Geef daarvoor de bijbehorende timer-ID mee, niet de callbackfunctie. Het argument is optioneel: een aanroep van clearTimeout() zonder argument gebruikt de standaardwaarde 0 en heeft geen effect.

Versie: 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) annuleert de timer die wordt aangeduid door de waarde die setTimeout() heeft teruggegeven. De functie retourneert undefined. Het is een API uit de HTML-standaard die beschikbaar is in browservensters en workers, en geen onderdeel van ECMAScript zelf. De standaard vermeldt ondersteuning in alle huidige browserengines; de aanwezigheid van Node 24 bewijst geen ondersteuning voor browser-API’s.

Bewaar de ID en annuleer de timer in dezelfde globale omgeving waarin deze is aangemaakt. Een ID die niet in het timerregister staat, verandert niets. Annuleren onderbreekt geen callback die al wordt uitgevoerd en maakt de effecten ervan niet ongedaan.

clearTimeout() en clearInterval() delen een register, dus technisch kan elk van beide beide soorten timers annuleren. Voor de leesbaarheid combineer je setTimeout() met clearTimeout() en setInterval() met clearInterval().

In het voorbeeld gebeurt het annuleren synchroon, voordat de callback kan worden uitgevoerd. Een vertraging van 0 betekent niet dat iets onmiddellijk wordt uitgevoerd. Daarom is cancelled het enige bericht dat wordt weergegeven.

Voorbeelden

(() => {
  const id = setTimeout(() => console.log("unexpected"), 0);
  clearTimeout(id);
  console.log("cancelled");
})();

Resultaat

cancelled

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen