База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

debounce: изпълнение след пауза

`debounce` обединява поредица от бързи извиквания в едно. В показания вариант след пауза се изпълнява само последното извикване.

Версия: User-defined debounce helper using web timers; host timer behavior varies

Синтаксис

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

debounce(fn, waitMs) връща обвиваща функция за fn. Предай самата функция fn, а не резултата от извикването ѝ, и неотрицателно закъснение waitMs в милисекунди. Създай обвиващата функция веднъж за всеки източник на извиквания и я използвай повторно, например за филтриране на резултати след пауза в писането.

При варианта в края на поредицата (trailing edge) всяко извикване отменя чакащия таймер и стартира нов. Когато таймерът най-сетне се задейства, fn се изпълнява веднъж с аргументите и стойността на this от последното извикване на обвиващата функция. Ако извикванията продължават достатъчно начесто, fn може изобщо да не се изпълни. За разлика от това throttling ограничава честотата на изпълнение дори докато извикванията продължават. Вариантът в началото на поредицата (leading edge) изпълнява fn веднага при първото извикване; примерът не прави това.

Всяка обвиваща функция има собствен таймер. Методът cancel() в примера отменя чакащо изпълнение, но не спира вече започнала работа. Обвиващата функция връща веднага undefined, а не по-късния резултат от fn. Изключение, хвърлено от fn в обратното извикване на таймера, не се предава обратно към кода, извикал обвиващата функция по-рано.

Функцията debounce и методът ѝ cancel() са дефинирани в примера, а не в ECMAScript или в уеб стандарт. Информацията за версията се отнася до стандартите, на които разчита примерът, а не до самата помощна функция. Примерът използва setTimeout и clearTimeout от хост средата. Избери стойност за waitMs в диапазона, поддържан от таймерите на тази среда: твърде голяма стойност може да се приеме за много по-кратко закъснение. Таймерът може да се задейства по-късно от зададеното. Извън браузъра провери дали средата за изпълнение предоставя таймери и как работят те.

Примери

(() => {
  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');
})();

Резултат

Search: cat

Изпълни целия код наведнъж в конзолата на браузъра. Трите извиквания са синхронни, затова само последното води до извеждането на `Search: cat`. Закъснението от 100 ms не гарантира точен момент на изпълнение.

Свързани уроци

  • JavaScript · Урок 21 · Начално · Версия: 4

Източници