CKTIS / JavaScript
clearTimeout — cancelar un temporizador
clearTimeout(id) cancela una llamada pendiente programada con setTimeout(). Para cancelarla, pasa el identificador del temporizador correspondiente, no la función de callback. El argumento es opcional: si llamas a clearTimeout() sin argumento, se usa el valor predeterminado 0 y la llamada no tiene efecto.
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
clearTimeout()
clearTimeout(id)clearTimeout(id) cancela el temporizador identificado por el valor devuelto por setTimeout(). Devuelve undefined. Es una API del estándar HTML disponible en ventanas de navegador y workers, no forma parte de ECMAScript en sí. El estándar indica que es compatible con todos los motores de navegador actuales; la presencia de Node 24 no demuestra que admita las API de navegador.
Conserva el identificador y cancela el temporizador en el mismo entorno global en el que se creó. Un identificador que no esté en el registro de temporizadores no cambia nada. La cancelación no interrumpe un callback que ya se está ejecutando ni deshace sus efectos.
clearTimeout() y clearInterval() comparten un registro, así que técnicamente cualquiera de las dos puede cancelar ambos tipos de temporizador. Para que el código sea más claro, combina setTimeout() con clearTimeout() y setInterval() con clearInterval().
En el ejemplo, la cancelación ocurre de forma síncrona antes de que el callback pueda ejecutarse. Un retraso de 0 no significa que la ejecución sea inmediata, así que el único mensaje que se muestra es cancelled.
Ejemplos
(() => {
const id = setTimeout(() => console.log("unexpected"), 0);
clearTimeout(id);
console.log("cancelled");
})();Resultado
cancelled
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.