Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes