[function.debounce]: add function

src/function/debounce.js

@@ -0,0 +1,25 @@
+/**
+ * Creates a function which debounces with the given timeout and resets the timer
+ * on every function call.
+ *
+ * The returned debounced function has a function property abort() which aborts the timer.
+ *
+ * @memberOf function
+ * @function
+ * @param {function} fn
+ * @param {number} timeout
+ * @return {function(...[*])}
+ */
+export default (fn, timeout = 0) => {
+    let timer = null;
+    const abortTimer = () => clearTimeout(timer);
+
+    const debouncedFunction = (...args) => {
+        abortTimer();
+        timer = setTimeout(() => fn(...args), timeout)
+    };
+
+    debouncedFunction.abort = abortTimer;
+
+    return debouncedFunction;
+};

src/function/index.js

@@ -5,6 +5,7 @@ export { default as argsToArray } from './argsToArray';
 export { default as checkTypes } from './checkTypes';
 export { default as combine } from './combine';
 export { default as curry } from './curry';
+export { default as debounce } from './debounce';
 export { default as enqueue } from './enqueue';
 export { default as enqueueWithResults } from './enqueueWithResults';
 export { default as identity } from './identity';

src/index.js

@@ -14,6 +14,7 @@ export {
     checkTypes,
     combine,
     curry,
+    debounce,
     enqueueWithResults,
     enqueue,
     identity,