All files / fn lock.js

100% Statements 11/11
83.33% Branches 5/6
100% Functions 3/3
100% Lines 11/11

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37                                      1x 1x 3x 1x   2x 2x 2x 2x   2x 2x         1x  
/**
 * 包装为触发一次后,预置时间内不能再次触发的函数
 * - 类似于技能冷却。
 * @method fn/lock
 * @param {Function} fn 要延迟触发的函数
 * @param {Number} delay 延迟时间(ms)
 * @param {Object} [bind] 函数的 this 指向
 * @returns {Function} 经过包装的冷却触发函数
 * @example
 * var $lock = require('@spore-ui/kit/packages/fn/lock');
 * var request = function () {
 *   console.info('do request');
 * };
 * $('#input').keydown($lock(request, 500));
 * // 第一次按键,就会触发一次函数调用
 * // 之后连续按键,仅在 500ms 结束后再次按键,才会再次触发 request 函数调用
 */
 
function lock(fn, delay, bind) {
  var timer = null;
  return function () {
    if (timer) {
      return;
    }
    bind = bind || this;
    var args = arguments;
    timer = setTimeout(function () {
      timer = null;
    }, delay);
    Eif (typeof fn === 'function') {
      fn.apply(bind, args);
    }
  };
}
 
module.exports = lock;