Debounce vs Throttle: del botón del ascensor a Kubernetes
Apretar diez veces el botón del ascensor lo llama una sola vez. La luz del pasillo se apaga recién cuando dejás de moverte. Eso es throttle y debounce, y las mismas dos reglas manejan tu buscador, tus alertas, tu productor de Kafka y tu autoscaler. Nueve lugares donde viven, la perilla que expone cada uno y qué se rompe cuando la ventana está mal.

Todos vimos a alguien apretar cinco veces el botón del ascensor, como si el ascensor pudiera darse cuenta de que está apurado. No puede. Un folleto de seguridad del Departamento de Trabajo e Industrias del estado de Washington lo pone en la lista de mitos: la llamada "se registra una sola vez", y apretar repetidamente no trae el ascensor antes (L&I, Elevator Safety).
Ahora pensá en la luz del pasillo con sensor de movimiento. No se apaga diez segundos después de que entrás. Se apaga un tiempo fijo después del último movimiento que detectó (Lutron, Application Note #489). Si te seguís moviendo, sigue prendida; si te quedás quieto, la cuenta regresiva finalmente termina.
Esas dos máquinas usan las dos reglas de tiempo más útiles del software:
- Throttle: actuar con el primer evento e ignorar el resto por un rato. El ascensor.
- Debounce: esperar a que los eventos paren y actuar una vez. La luz del pasillo.
Las dos convierten una ráfaga de eventos en una sola acción. Se diferencian en cuándo ocurre esa acción, y esa diferencia decide si tu buscador se siente instantáneo o lento, si la persona de guardia duerme y si tu cluster oscila. Este artículo sigue las dos reglas por nueve lugares, desde un edificio hasta un cluster de Kubernetes.
Las dos reglas, con precisión
Throttle garantiza una acción como mucho una vez por ventana. La definición de Lodash es la más clara: invoca la función "como mucho una vez cada wait milisegundos" (docs de Lodash). Puede actuar al principio de la ventana (el flanco de entrada, como el ascensor), al final (el flanco de salida, como un lote que se manda cuando se cierra su ventana) o en ambos.
Debounce actúa una vez, después de un período de silencio. Cada evento nuevo reinicia el timer; la acción corre recién cuando pasa wait sin eventos nuevos. La explicación clásica de David Corbacho lo describe como agrupar una ráfaga de llamadas seguidas en una sola (CSS-Tricks, 2016).
Las dos están más cerca de lo que parece. En el código de Lodash, throttle es un debounce con un techo de cuánto puede esperar (lodash.js 4.17.21):
return debounce(func, wait, {
leading: leading,
maxWait: wait, // never wait longer than one window
trailing: trailing,
});
Esa línea es toda la relación: un debounce que sigue recibiendo eventos esperaría para siempre, y maxWait lo convierte en un throttle que actúa al menos una vez por ventana.
Deslizá hacia el costado para ver el diagrama completo →
Hay una segunda variante de debounce que conviene separar, porque aparece por toda la infraestructura. Esperar silencio actúa cuando los eventos paran (un buscador, la luz del pasillo). Esperar que se sostenga actúa cuando una condición se mantuvo verdadera el tiempo suficiente (una tecla, una alerta, un autoscaler). Es la misma regla, aplicada a un estado en lugar de a un flujo de eventos.
Actuar ya, después ignorar: throttle
1. El botón del ascensor
Lo que ves. Apretás una vez, el botón se ilumina, y cada apretón extra no cambia nada.
La regla. Un throttle de flanco de entrada. El primer apretón registra la llamada; los siguientes se absorben hasta que llega la cabina y la llamada se atiende. La ventana no es una cantidad fija de milisegundos: es "hasta que el pedido se cumpla".
Por qué funciona. Quien espera quiere una reacción rápida al primer apretón (la luz), y el sistema no gana nada con más apretones. El consejo del folleto es exactamente la regla: apretar el botón una sola vez.
Una aclaración para que la analogía sea honesta: la lógica de despacho de los ascensores es propietaria, y algunos controladores patentados usan a propósito los apretones repetidos como señal. El folleto describe el caso común, no todos los ascensores del mundo.
2. El scroll infinito
Lo que ves. Deslizás un feed en el teléfono y aparecen posts nuevos antes de que llegues al final.
La regla. El evento de scroll se dispara muchas veces por segundo, y hacer cálculos de layout o un fetch en cada uno hace que la página tartamudee. La guía de MDN es directa: si notás tirones al scrollear rápido, considerá aplicar throttle al evento, y su ejemplo lo hace con setTimeout, una vez cada 20 ms (MDN, scroll event). También advierte que hacer throttle con requestAnimationFrame ya no sirve, porque se dispara al mismo ritmo que los eventos de scroll.
La mejor respuesta. Para "cargar más cuando el usuario se acerca al final", MDN recomienda IntersectionObserver y menciona el scroll infinito entre sus casos de uso (MDN). El navegador te avisa cuando un elemento centinela se vuelve visible, así que no necesitás ni un handler de scroll ni un throttle. Antes de recurrir a un timer, usá lo que ya trae la plataforma.
3. El linger.ms de Kafka
Lo que ves. Nada, y esa es la idea. Tu productor manda un pedido de red con muchos registros en lugar de un pedido por registro.
La regla. Un throttle de flanco de salida usado para armar lotes. Cuando llega un registro, el productor espera hasta linger.ms a que se sumen otros y después manda el lote, o lo manda antes si el lote llega a batch.size (16 KB por defecto). La documentación de Kafka lo compara con el algoritmo de Nagle en TCP (Apache Kafka, producer configs).
La perilla cambió. El valor por defecto fue 0 (mandar enseguida) hasta que Apache Kafka 4.0 lo pasó a 5 ms (KIP-1030). Cinco milisegundos de espera a cambio de menos pedidos y más grandes: los mantenedores de Kafka decidieron que la mayoría de los productores debería hacer ese intercambio por defecto.
Fijate que esto no es un debounce: los registros nuevos no reinician la espera. Un debounce no mandaría nunca mientras sigan llegando registros, que es justo lo que un productor no puede hacer.
Esperar silencio: debounce
4. La luz del pasillo
Lo que ves. La luz sigue prendida mientras te movés y se apaga un rato después de que te vas.
La regla. Un debounce de salida sobre el movimiento. Lutron describe el timeout como el tiempo después del cual las luces se apagan contado desde el último movimiento detectado, con opciones de 1, 5, 15 o 30 minutos y un valor por defecto de 15 (Lutron #489).
Lo que cuesta una ventana mal elegida. Si es muy corta, la luz se apaga sobre alguien que lee en su escritorio (el sensor no ve a una persona quieta). Si es muy larga, se pierde el ahorro de energía que justificaba el sensor. Todo debounce tiene esa tensión: la ventana tiene que ser más larga que las pausas naturales de la actividad, y no más.
5. El buscador
Lo que ves. Escribís "cafetería" y los resultados aparecen una vez, justo después de que dejás de escribir, no con cada letra.
La regla. Un debounce de salida sobre las teclas. La documentación de Algolia dice que InstantSearch genera una consulta por tecla por defecto, recomienda aplicar debounce, propone 200 ms como valor preferido y advierte que más de 300 ms empieza a degradar la experiencia (Algolia, Improve performance).
Deslizá hacia el costado para ver el diagrama completo →
Dos cosas que el debounce no hace.
- No ordena las respuestas. Si la respuesta para "cafe" vuelve después de la de "cafetería", una UI ingenua muestra resultados viejos. Cancelá el pedido anterior cuando empieza uno nuevo (
AbortController), o ignorá las respuestas que no son de la última consulta. - No protege al servidor. El debounce vive en el cliente, y cualquiera puede llamar a la API directo. El servidor igual necesita su propio rate limit por cliente. El debounce es una cortesía; el rate limiting es un control.
6. El agente de voz con IA
Lo que ves. Llamás a un negocio, atiende una IA, y no te corta mientras deletreás el nombre de tu calle.
La regla. Un debounce de salida sobre la voz de quien llama, que se llama endpointing o detección de turno. El agente espera una pausa antes de dar tu turno por terminado.
Por qué esta ventana es difícil. Los humanos somos rápidos para tomar el turno. Un estudio en diez idiomas encontró que el silencio entre una pregunta y su respuesta se concentra entre 0 y 200 ms (Stivers et al., PNAS 2009). Pero las pausas dentro de un turno, mientras alguien piensa o lee un número, en general son más largas que los silencios entre turnos (Heldner & Edlund, 2010). El silencio solo no distingue "terminé" de "dejame fijarme". Una ventana corta le habla encima a la gente; una larga hace que el agente parezca lento. Es el único lugar de la lista donde uso la regla en producción, así que tiene su propio caso más abajo.
Esperar que se sostenga: debounce sobre un estado
7. La tecla, de donde viene la palabra
Lo que ves. Apretás una tecla una vez y aparece un carácter, no cinco.
La regla. Dentro de un interruptor mecánico, los contactos de metal rebotan físicamente un instante antes de asentarse, así que para la electrónica un solo apretón parece una serie rápida de encendidos y apagados. Jack Ganssle midió 18 interruptores: sin contar dos casos extremos, el rebote promedio fue de unos 1,6 ms y el peor de 6,2 ms, y uno de los casos extremos rebotó 157 ms al abrirse. Su recomendación es elegir un período de debounce de entre 20 y 50 ms (Ganssle, A Guide to Debouncing).
Por qué le importa a la gente de software. Este es el origen literal de la palabra: de-bounce, quitar el rebote, significa aceptar un estado nuevo solo cuando se mantuvo estable un rato. Todos los demás debounce de este artículo tomaron prestada esa idea.
8. La alerta de Prometheus con for
Lo que ves. No te despiertan a las 3 de la mañana porque la CPU tuvo un pico de diez segundos.
La regla. Una regla de alerta con for: 5m no dispara cuando su condición se vuelve verdadera por primera vez. La alerta entra en estado pending, y Prometheus la considera firing recién cuando la condición se sostuvo durante todo ese tiempo (Prometheus, alerting rules). Si en el medio la condición deja de cumplirse, vuelve a inactive y la espera empieza de nuevo.
Deslizá hacia el costado para ver el diagrama completo →
Y en la otra dirección. keep_firing_for mantiene una alerta disparada un rato después de la última vez que se cumplió su condición, así una alerta que oscila alrededor del umbral no se resuelve y vuelve a avisar cada minuto. Un debounce a la entrada, otro a la salida.
Lo que cuesta una ventana mal elegida. Si es muy corta, entrenás a la gente a ignorar los avisos. Si es muy larga, una caída real corre varios minutos antes de que alguien se entere. Dimensionala según cuánto tiempo puede ser verdadera la condición sin que los usuarios lo noten.
9. El autoscaler de Kubernetes
Lo que ves. El tráfico baja un minuto y tus pods no desaparecen para tener que recrearse cuando el tráfico vuelve.
La regla. El HorizontalPodAutoscaler considera todas las recomendaciones dentro de una ventana configurable y elige la más alta de esa ventana. Para bajar réplicas, la ventana es de 300 segundos por defecto (behavior.scaleDown.stabilizationWindowSeconds); para subir, no hay ventana de estabilización (Kubernetes, HPA).
La decisión de diseño que vale copiar. La regla es asimétrica a propósito. Agregar capacidad tarde perjudica a los usuarios, así que subir es inmediato. Sacar capacidad antes de tiempo también los perjudica, así que bajar espera a que la carga baja se sostenga cinco minutos. Cuando el costo de actuar muy temprano y el de actuar muy tarde son distintos, dale a cada dirección su propia ventana.
Cómo elegir
| Preguntate | Usá | Ejemplo |
|---|---|---|
| ¿El primer evento merece una reacción inmediata, y el resto no agrega nada? | Throttle, flanco de entrada | Botón del ascensor, botón "Pagar" deshabilitado después del primer click |
| ¿Necesito actualizaciones regulares mientras siguen llegando eventos? | Throttle | Posición del scroll, barra de progreso, cursor en vivo en un documento compartido |
| ¿Solo me importa el valor final después de la ráfaga? | Debounce de salida | Buscador, autoguardado, resize de ventana, detección de turno en voz |
| ¿Una condición tiene que estar estable antes de actuar? | Debounce sobre un estado | Tecla, for de una alerta, bajada del autoscaler |
| ¿Estoy cambiando latencia por menos pedidos y más grandes? | Throttle como ventana de lote | linger.ms de Kafka, envío de logs, flush de métricas |
Cómo fallan
- Un debounce que nunca dispara. Si los eventos nunca paran (un flujo de lecturas de un sensor, alguien que sigue escribiendo), un debounce puro nunca actúa. Agregale un techo, como el
maxWaitde Lodash, para que actúe al menos una vez por ventana. - Un throttle que pierde el último evento. Un throttle solo de entrada puede ignorar el valor final en el que el usuario se quedó. Activá también la llamada de salida.
- Respuestas viejas. El debounce reduce pedidos; no los ordena. Cancelá o ignorá todo lo que no sea de la última entrada.
- Confundir una cortesía con un control. El debounce y el throttle del lado del cliente hacen un cliente educado. No son rate limiting, ni protección contra abuso, ni idempotencia. El servidor aplica sus propios límites.
- Una ventana que nadie dimensionó. 200 ms para escribir, 20 a 50 ms para una tecla, cinco minutos para bajar réplicas, 15 minutos para una luz: toda buena ventana sale del ritmo natural de lo que escucha. Medí ese ritmo antes de elegir un número.
Caso real: los turnos de habla en el recepcionista de voz de Afterhour
Deslizá hacia el costado para ver el diagrama completo →
Situación. Afterhour es un recepcionista de voz con IA, multi-tenant, para estudios jurídicos, que construí para Big Voodoo Interactive. Quienes llaman dictan los datos que el estudio necesita: nombres, direcciones, fechas, números de caso. Y en el medio de todo eso hacen pausas, para pensar, para leer de una carta, para deletrear una palabra.
Tarea. Evitar que el agente le hable encima a quien llama durante esas pausas, sin que parezca lento, y dejar que quien llama recupere el turno limpiamente cuando interrumpe.
Acción. Dos reglas de tiempo, configuradas en el proveedor de voz (VAPI) en todas las plantillas de recepcionista:
- La detección de turno como debounce.
startSpeakingPlan.waitSecondses el silencio mínimo que el agente espera antes de responder. Afterhour lo usa en 0,8 s, el doble del valor por defecto de VAPI, 0,4 s (VAPI, speech configuration). Esos 400 ms extra son el precio de no responder en medio de "mi dirección es 2-1-4… calle Oak": un agente que responde en la primera pausa corta le habla encima justamente a quien le está dando los datos que necesita. - La interrupción como "esperar que se sostenga".
stopSpeakingPlan.numWords: 1hace que quien llama tenga que decir una palabra de verdad para que el agente se calle (el valor por defecto, 0, lo frena después de 0,2 s de voz detectada, así que alcanza con una tos o un "mm").backoffSeconds: 2hace que el agente espere 2 s después de ser interrumpido antes de volver a hablar, el doble del valor por defecto de 1 s, para que quien llama pueda terminar la idea con la que interrumpió. - Un modelo de voz a texto hecho para audio telefónico antes de las dos reglas, para que actúen sobre palabras limpias y no sobre ruido de línea.
Resultado. Las mismas dos reglas forman parte de todas las plantillas de recepcionista de Afterhour desde que se escribieron, y la plataforma procesó más de 25.000 llamadas en producción con ellas. La lección que me quedo: una ventana de debounce es una decisión de producto disfrazada de número. 0,4 s y 0,8 s son los dos "correctos"; uno está pensado para un ida y vuelta rápido, el otro para gente que le dicta datos a un estudio jurídico.
Leé el caso completo: Afterhour, un recepcionista de voz con IA multi-tenant →
La conclusión
Throttle y debounce no son trucos de frontend. Son dos respuestas a una pregunta que todo sistema enfrenta: llega una ráfaga de eventos y querés una sola acción. ¿Actuás con el primero o con el último? El ascensor responde "con el primero, y después te ignoro". La luz del pasillo responde "con el último, cuando ya te fuiste". Tu buscador, tu productor de Kafka, tus alertas y tu autoscaler responden la misma pregunta, y la ventana que usan es una decisión sobre lo que va a sentir la gente del otro lado.
Referencias
- Washington State Department of Labor & Industries, Elevator Safety (F621-084-000, 2006).
- Lutron, Application Note #489: Maestro Dual-Circuit Occupancy Sensor (Rev B, 2019).
- Lodash,
_.debouncey_.throttley código fuente, v4.17.21. - David Corbacho, Debouncing and Throttling Explained Through Examples (CSS-Tricks, 2016).
- MDN, Document: scroll event y Intersection Observer API.
- Apache Kafka, Producer configs y KIP-1030.
- Algolia, Improve performance for InstantSearch.js.
- Stivers et al., Universals and cultural variation in turn-taking in conversation (PNAS, 2009).
- Heldner & Edlund, Pauses, gaps and overlaps in conversations (Journal of Phonetics, 2010).
- VAPI, Speech configuration.
- Jack Ganssle, A Guide to Debouncing (2008).
- Prometheus, Alerting rules.
- Kubernetes, Horizontal Pod Autoscaling.