CKTIS / JavaScript
setTimeout — een functie eenmalig inplannen
setTimeout plant een functie in om één keer uit te voeren zonder de huidige code te blokkeren. De vertraging garandeert geen exact uitvoeringstijdstip en met de geretourneerde identifier kun je de wachtende aanroep annuleren.
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
const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);setTimeout is een API die door de HTML Standard is gedefinieerd voor vensters en workers, niet een functie van ECMAScript zelf. De API plant een functie in voor één aanroep; setInterval plant herhalingen in. Geef een functie callback, een vertraging delayMs in milliseconden en optionele args door die aan de functie worden meegegeven. Geef een functie door in plaats van codetekst die compilatie vereist.
De aanroep keert terug zonder te wachten. Ook bij een vertraging van 0 wacht de callback op een latere taak van de eventloop; hij onderbreekt de huidige synchrone code niet. Het opgegeven tijdstip is niet gegarandeerd en de uitvoering kan later plaatsvinden. Als het nestingniveau van de timer hoger is dan 5, worden vertragingen korter dan 4 ms verhoogd tot 4 ms.
Bij het inplannen van een functie wordt een positieve integeridentifier id geretourneerd. clearTimeout(id) annuleert de wachtende aanroep in dezelfde globale omgeving. Het stopt geen callback die al wordt uitgevoerd.
Het voorbeeld annuleert één timer en geeft "timer" als argument mee aan een andere. De synchrone code voegt "end" toe voordat de timer-callback wordt uitgevoerd. Het verwachte resultaat is dus start -> end -> timer. Controleer de volgorde, niet de exacte verstreken tijd.
Voorbeelden
(() => {
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");
})();Resultaat
start -> end -> timer
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.