Makes a function execute only once in a given interval.

Downloads in past


1001.0.28 years ago8 years agoMinified + gzip package size for debounce-collect in KB


An implementation of debounce. Unlike underscore's debounce, this one collects arguments of all calls.
This is based on underscore's implementation of debounce.


Debounce-collect is available as an npm package.
var debounce = require('debounce-collect')

When used outside a CommonJS environment, it's accessible as global.debounceCollect.


debounce(function, wait, [immediate])

Creates and returns a new debounced version of the passed function which will postpone its execution until after wait milliseconds have elapsed since the last time it was invoked. Useful for implementing behavior that should only happen after the input has stopped arriving. For example: rendering a preview of a Markdown comment, recalculating a layout after the window has stopped being resized, and so on.
Pass true for the immediate argument to cause debounce() to trigger the function on the leading instead of the trailing edge of the wait interval. Useful in circumstances like preventing accidental double-clicks on a "submit" button from firing a second time.

Differences from _.debounce

The resulting function will be called with an array of all function arguments for all calls.


// this will call the update function:
//    update('change', 'file1.txt')
//    update('change', 'file2.txt')
  .on('all', debounce(update, 50))

function update (argsList) {

  // result:
  // [
  //   [ 'change', 'file1.txt' ],
  //   [ 'change', 'file2.txt' ]
  // ]


debounce-collect © 2015+, Rico Sta. Cruz. Released under the MIT License.
Authored and maintained by Rico Sta. Cruz with help from contributors (listcontributors).  ·  GitHub @rstacruz  ·  Twitter @rstacruz