mathieubeauregard
10/19/2015 - 1:49 PM

Debounce

Returns a function, that, as long as it continues to be invoked, will not be triggered. The function will be called after it stops being called for N milliseconds. If immediate is passed, trigger the function on the leading edge, instead of the trailing.

/**
 * Returns a function, that, as long as it continues to be invoked, will not
 * be triggered. The function will be called after it stops being called for
 * N milliseconds. If `immediate` is passed, trigger the function on the
 * leading edge, instead of the trailing.
 * 
 * EX : 
 * 		var myEfficientFn = debounce(function() {
 *   		// Code here
 *		}, 250);
 *  	window.addEventListener('resize', myEfficientFn);
 * 
 * @see https://davidwalsh.name/javascript-debounce-function
 * @param  {function} func      Function to execute
 * @param  {number} wait      	Minimum delay between executions
 * @param  {boolean} immediate 	Execute function immediatly
 * @return {function}           Function execution
 */
function debounce(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);
	};
}