CKTIS / JavaScript
Debounce y throttle: controlar las llamadas a funciones
Debounce aplaza la ejecución hasta que una serie de llamadas se calme, mientras que throttle limita la frecuencia de ejecución durante la serie. Distingue las variantes leading y trailing: determinan si se conserva la primera llamada, la última o ambas.
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 debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle son patrones para controlar llamadas, no funciones integradas de ECMAScript. El debounce trailing ejecuta una función tras un periodo de inactividad de wait: cada nueva llamada cancela el temporizador anterior y programa otro. Conserva los argumentos más recientes y this. Sirve, por ejemplo, para iniciar una búsqueda después de una pausa al escribir; las llamadas continuas pueden aplazar la ejecución indefinidamente.
Throttle limita la frecuencia de ejecución aunque sigan llegando llamadas. La variante leading del ejemplo ejecuta la primera llamada de inmediato y después descarta las siguientes hasta que un temporizador la desbloquea. No ejecuta la última llamada descartada. Puede servir para limitar la frecuencia con que se procesa el desplazamiento. Leading significa ejecutar al inicio de una ventana; trailing, ejecutar de forma diferida al final. Las implementaciones pueden ofrecer ambas variantes, así que define estas reglas explícitamente.
El ejemplo usa sintaxis de ECMAScript 2015 y setTimeout() y clearTimeout() del navegador, especificados por HTML y no por ECMAScript. Los temporizadores están disponibles en contextos window y worker; que Node 24 los admita no demuestra que la API esté disponible en el navegador. En el navegador, setTimeout() convierte el retraso en un entero de 32 bits con signo. Por ejemplo, 2147483648 ms se convierte en un valor negativo que se trata como cero. Un retraso no garantiza un momento exacto de ejecución: otras tareas pueden aplazarla y los temporizadores con suficiente anidamiento tienen un mínimo de 4 ms. No es un mecanismo de tiempo real.
Crea el wrapper una vez y reutilízalo; si lo creas de nuevo para cada evento, pierdes el estado compartido. El ejemplo presupone un fn válido y un valor entero de wait en milisegundos que cumpla 0 <= wait && wait <= 2147483647. No propaga el valor devuelto por la función y no ofrece cancel(), flush() ni maxWait. En producción, prevé cancelar el trabajo pendiente al retirar un componente. Cancelar un temporizador no detiene una solicitud ya iniciada ni protege frente a respuestas obsoletas.
Ejemplos
function debounce(fn, wait) {
let timer;
return function (...args) {
clearTimeout(timer);
timer = setTimeout(() => {
timer = undefined;
fn.apply(this, args);
}, wait);
};
}
function throttle(fn, wait) {
let blocked = false;
return function (...args) {
if (blocked) return;
blocked = true;
setTimeout(() => { blocked = false; }, wait);
fn.apply(this, args);
};
}
const debounced = debounce(value => console.log('debounce:', value), 50);
const throttled = throttle(value => console.log('throttle:', value), 50);
for (const value of ['A', 'B', 'C']) {
debounced(value);
throttled(value);
}Resultado
throttle: A debounce: C
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.