jquery.debonce.js

jquery.debonce.js

/**
 * @see https://stackoverflow.com/questions/28948383/how-to-implement-debounce-fn-into-jquery-keyup-event
 * @see http://jsfiddle.net/bjb9s2w5/
 * @see https://learn.jquery.com/plugins/basic-plugin-creation/
 * 
 * Usage:
 * 
 * ```
 * $('input').on('keyup', $.fn.debonce(function () {
 *     // do some ajax request...
 * }, 500));
 * ```
 */
(function ($) {
    'use strict';
    
    // @see http://davidwalsh.name/javascript-debounce-function
    $.fn.debonce = function (func, wait, immediate) {
        var timeout;

        return function () {
            var context = this,
                args    = arguments
            ;
            var later = function () {
                timeout = null;
                if (!immediate) {
                    func.apply(context, args);
                }
            };
            var callNow = immediate && !timeout;
            
            clearTimeout(timeout);
            
            timeout = setTimeout(later, wait);

            if (callNow) {
                func.apply(context, args);
            }
        };
    };
})(window.jQuery);