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

CKTIS / JavaScript

debounce: ejecutar tras una pausa

`debounce` agrupa varias llamadas rápidas en una sola. En la variante mostrada, solo se ejecuta la última llamada, después de una pausa.

Versión: User-defined debounce helper using web timers; host timer behavior varies

Sintaxis

const debounced = debounce(fn, waitMs);
debounced(...args);
debounced.cancel();

debounce(fn, waitMs) devuelve una función envolvente para fn. Pasa la función fn, no el resultado de llamarla, y un retraso waitMs no negativo en milisegundos. Crea la función envolvente una vez por cada origen de llamadas y reutilízala, por ejemplo para filtrar resultados cuando alguien deja de escribir un momento.

En la variante de final de ráfaga (trailing edge), cada llamada cancela el temporizador pendiente e inicia otro. Cuando por fin se activa el temporizador, fn se ejecuta una vez con los argumentos y el valor de this de la última llamada a la función envolvente. Si las llamadas siguen llegando lo bastante rápido, puede que fn nunca se ejecute. En cambio, el throttling limita la frecuencia de ejecución incluso si las llamadas continúan. La variante de inicio de ráfaga (leading edge) ejecuta fn de inmediato en la primera llamada; el ejemplo no lo hace.

Cada función envolvente tiene su propio temporizador. El método cancel() del ejemplo descarta una ejecución pendiente, pero no detiene el trabajo que ya ha comenzado. La función envolvente devuelve undefined de inmediato, no el resultado posterior de fn. Una excepción lanzada por fn en la función del temporizador no se propaga al código que llamó antes a la función envolvente.

El ejemplo define debounce y su método cancel(); ninguno está definido por ECMAScript ni por un estándar web. La información de versión se refiere a los estándares en los que se apoya el ejemplo, no a la función auxiliar en sí. El ejemplo usa setTimeout y clearTimeout, que proporciona el entorno anfitrión. Elige un valor de waitMs dentro del rango admitido por los temporizadores de ese entorno: un valor demasiado alto puede interpretarse como un retraso mucho más corto. El temporizador puede activarse más tarde de lo solicitado. Fuera del navegador, comprueba si el entorno ofrece temporizadores y cómo se comportan.

Ejemplos

(() => {
  function debounce(fn, waitMs) {
    let timer;

    function cancel() {
      if (timer !== undefined) {
        clearTimeout(timer);
        timer = undefined;
      }
    }

    function debounced(...args) {
      cancel();
      timer = setTimeout(() => {
        timer = undefined;
        Reflect.apply(fn, this, args);
      }, waitMs);
    }

    debounced.cancel = cancel;
    return debounced;
  }

  const search = {
    prefix: 'Search: ',
    update: debounce(function (query) {
      console.log(this.prefix + query);
    }, 100),
  };

  search.update('c');
  search.update('ca');
  search.update('cat');
})();

Resultado

Search: cat

Ejecuta todo el código de una vez en la consola del navegador. Las tres llamadas son síncronas, así que solo la última hace que se muestre `Search: cat`. Los 100 ms no garantizan un instante exacto de ejecución.

Lecciones relacionadas

  • JavaScript · Lección 21 · Básico · Versión: 4

Fuentes