Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Distributed debounced function execution like _.debounce on per session basis as connect middleware.
branch: master


latest commit ca2d36dcf2
@kof authored
Failed to load latest commit information.
.gitignore first commit
LICENSE first commit changelog
index.js Closes #3, with test to reproduce
package.json inc version docs
test.js Closes #3, with test to reproduce

Distributed debounced function execution ala underscore on per session basis as connect middleware.


If user interaction is followed by a request to the server and has heavy task to do, you might want to prevent the user from triggering this multiple times. It is not always possible to solve this on the client, because:

  1. User can reload the page directly after the action, so request never happens.
  2. User can switch to another page which has to display something depending on previous changes.
  3. Blocking the screen is not a good option from the UI side of view, also it will not prevent user from page reload.


Module will save the date of the last attempt to execute the function into the session store of connect. On every attempt to execute it again, it will check the date and prevent execution more often than the wait time defined for the function.


Debounce returns a middlware function. You can pass new wait option, default is 1000ms.


var debounce = require('connect-debounce');
var app = connect();

    .use(debounce({wait: 3000}))
    .use(function(req, res){
        res.end('hello world\n');

req.debounce(fn:Function, [wait:Number], [immediate:Boolean])

  • fn is a function which execution will be debounced. It can get an error object passed as first argument. Don't ignore it! Better to use a function name to avoid potential conflicts with some other debounced function which has the same implementation.
  • wait time in ms to wait, default is the value described in setup.
  • immediate exec function immediately and debounce it later


app.get('/', function(req, res, next) {
    req.debounce(function(err) {
        if (err) {

            // Request is already responded, log the error.
            return log(err);

    }, 3000);

    res.send('my response');


npm i connect-debounce

Running tests

npm test
Something went wrong with that request. Please try again.