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

CKTIS / JavaScript

`throttle`: limitar la frecuencia de ejecución de una función

`throttle` limita la frecuencia de ejecución de una función aunque las llamadas no se interrumpan. Por ejemplo, reduce el trabajo durante el desplazamiento de una página.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.

throttle es un nombre habitual para una función auxiliar, no una función incorporada en ECMAScript ni una API estándar del navegador. Devuelve una función envolvente que limita la frecuencia con la que se inicia fn. Por ejemplo, permite actualizar la interfaz con menos frecuencia durante el desplazamiento. Crea la función envolvente una sola vez y reutilízala: cada una guarda su propia hora del último inicio.

En el ejemplo, la primera llamada ejecuta fn de inmediato (leading edge). Otra llamada puede ejecutarla si han transcurrido al menos intervalMs desde el inicio anterior. Las llamadas prematuras devuelven undefined, no alargan el intervalo y no se ponen en cola. Una llamada aceptada reenvía this y los argumentos, y devuelve el resultado de fn o propaga su excepción.

Otras variantes pueden ejecutar la última llamada pendiente al final del intervalo (trailing edge). Aquí, el mero paso del tiempo no activa nada. Un debounce típico que actúa al final espera una pausa entre llamadas; throttle puede seguir ejecutando la función aunque no haya una pausa.

Proporciona un intervalo positivo y finito y una función de reloj now que devuelva valores finitos y no decrecientes en milisegundos. El ejemplo usa un reloj simulado; en un navegador puedes pasar () => performance.now(). Es una API de la plataforma web: comprueba su disponibilidad en el entorno de destino. Si otra variante usa setTimeout(), su función de retorno puede ejecutarse más tarde de lo previsto.

Ejemplos

{
  function throttle(fn, intervalMs, now) {
    let lastRun;
    return function (...args) {
      const time = now();
      if (lastRun !== undefined && time - lastRun < intervalMs) {
        return undefined;
      }
      lastRun = time;
      return Reflect.apply(fn, this, args);
    };
  }

  let time = 0;
  const panel = {
    prefix: "Update",
    update: throttle(function (label) {
      console.log(`${this.prefix}: ${label}`);
    }, 100, () => time),
  };

  panel.update("A");
  time = 40;
  panel.update("B");
  time = 100;
  panel.update("C");
  time = 140;
  panel.update("D");
}

Resultado

Update: A
Update: C

A se ejecuta a los 0 ms, B se omite a los 40 ms, C se ejecuta justo en el límite de 100 ms y D se omite a los 140 ms sin ejecutarse más tarde.

Lecciones relacionadas

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

Fuentes