CKTIS / JavaScript
setTimeout — programar una función una sola vez
setTimeout programa una función para que se ejecute una sola vez, sin bloquear el código actual. El retraso no garantiza un momento exacto de ejecución, y el identificador devuelto permite cancelar la invocación pendiente.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);setTimeout es una API definida por el HTML Standard para ventanas y workers, no una función del propio ECMAScript. Programa una función para que se invoque una vez; setInterval programa repeticiones. Proporciona una función callback, un retraso delayMs en milisegundos y los args opcionales que recibirá la función. Pasa una función en lugar de texto de código que requiera compilación.
La llamada retorna sin esperar. Incluso con un retraso de 0, el callback espera a una tarea posterior del bucle de eventos; no interrumpe el código síncrono actual. El momento indicado no está garantizado y la ejecución puede producirse más tarde. Cuando el nivel de anidamiento del temporizador supera 5, los retrasos inferiores a 4 ms se elevan a 4 ms.
Al programar una función, se devuelve un identificador entero positivo id. clearTimeout(id) cancela la invocación pendiente en el mismo entorno global. No detiene un callback que ya se esté ejecutando.
El ejemplo cancela un temporizador y pasa "timer" como argumento a otro. El código síncrono añade "end" antes de que se ejecute el callback del temporizador, por lo que el resultado esperado es start -> end -> timer. Comprueba el orden, no el tiempo exacto transcurrido.
Ejemplos
(() => {
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");
})();Resultado
start -> end -> timer
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.