lodash源码学习debounce,throttle

函数去抖(debounce)和函数节流(throttle)通常是用于优化浏览器中频繁触发的事件,具体内容可以看这篇文章http://www.cnblogs.com/fsjohnhuang/p/4147810.html

直接看lodash中对应方法的实现

_.debounce(func, [wait=0], [options={}])

//debounce.js

var isObject = require(‘./isObject‘),//是否是对象
    now = require(‘./now‘),//获取当前时间
    toNumber = require(‘./toNumber‘);//转为为数字

var FUNC_ERROR_TEXT = ‘Expected a function‘;

var nativeMax = Math.max,//原生最大值方法
    nativeMin = Math.min;//原生最小值方法

/**
 * 函数去抖,也就是说当调用动作n毫秒后,才会执行该动作,若在这n毫秒内又调用此动作则将重新计算执行时间。
 *
 * @param {Function} func 需要去抖的函数.
 * @param {number} [wait=0] 延迟执行的时间.
 * @param {Object} [options={}] 选项对象.
 * @param {boolean} [options.leading=false] 指定是否在超时前调用.
 * @param {number} [options.maxWait] func延迟调用的最大时间.
 * @param {boolean} [options.trailing=true] 指定是否在超时后调用.
 * @returns {Function} 返回去抖之后的函数.
 * @example
 *
 * // Avoid costly calculations while the window size is in flux.
 * jQuery(window).on(‘resize‘, _.debounce(calculateLayout, 150));
 *
 * // Invoke `sendMail` when clicked, debouncing subsequent calls.
 * jQuery(element).on(‘click‘, _.debounce(sendMail, 300, {
 *   ‘leading‘: true,
 *   ‘trailing‘: false
 * }));
 *
 * // Ensure `batchLog` is invoked once after 1 second of debounced calls.
 * var debounced = _.debounce(batchLog, 250, { ‘maxWait‘: 1000 });
 * var source = new EventSource(‘/stream‘);
 * jQuery(source).on(‘message‘, debounced);
 *
 * // Cancel the trailing debounced invocation.
 * jQuery(window).on(‘popstate‘, debounced.cancel);
 */
function debounce(func, wait, options) {
  var lastArgs,    //上次调用参数
      lastThis,    //上次调用this
      maxWait,    //最大等待时间
      result,    //返回结果
      timerId,    //timerId
      lastCallTime,    //上次调用debounced时间,即触发时间,不一定会调用func
      lastInvokeTime = 0, //上次调用func时间,即成功执行时间
      leading = false,    //超时之前
      maxing = false,     //是否传入最大超时时间
      trailing = true;    //超时之后

  if (typeof func != ‘function‘) {
    throw new TypeError(FUNC_ERROR_TEXT);
  }
  wait = toNumber(wait) || 0;
  if (isObject(options)) {
    leading = !!options.leading;
    maxing = ‘maxWait‘ in options;
    maxWait = maxing ? nativeMax(toNumber(options.maxWait) || 0, wait) : maxWait;
    trailing = ‘trailing‘ in options ? !!options.trailing : trailing;
  }

  function invokeFunc(time) {//调用func,参数为当前时间
    var args = lastArgs,//调用参数
        thisArg = lastThis;//调用的this

    lastArgs = lastThis = undefined;//清除lastArgs和lastThis
    lastInvokeTime = time;    //上次调用时间为当前时间
    result = func.apply(thisArg, args);//调用func,并将结果返回
    return result;
  }

  function leadingEdge(time) {//超时之前调用
    lastInvokeTime = time;//设置上次调用时间为当前时间
    timerId = setTimeout(timerExpired, wait); //开始timer
    return leading ? invokeFunc(time) : result;//如果leading为true,调用func,否则返回result
  }

  function remainingWait(time) {//设置还需要等待的时间
    var timeSinceLastCall = time - lastCallTime,//距离上次触发的时间
        timeSinceLastInvoke = time - lastInvokeTime,//距离上次调用func的时间
        result = wait - timeSinceLastCall;//还需要等待的时间

    return maxing ? nativeMin(result, maxWait - timeSinceLastInvoke) : result;
  }

  function shouldInvoke(time) {//是否应该被调用
    var timeSinceLastCall = time - lastCallTime,//距离上次触发时间的时间
        timeSinceLastInvoke = time - lastInvokeTime;//距离上次调用func的时间

    return (lastCallTime === undefined || (timeSinceLastCall >= wait) ||
      (timeSinceLastCall < 0) || (maxing && timeSinceLastInvoke >= maxWait));
  }

  function timerExpired() {//刷新timer
    var time = now();
    if (shouldInvoke(time)) {//如果可以调用,调用trailingEdge
      return trailingEdge(time);
    }
    timerId = setTimeout(timerExpired, remainingWait(time));//不调用则重置timerId
  }

  function trailingEdge(time) {//超时之后调用
    timerId = undefined;

    // Only invoke if we have `lastArgs` which means `func` has been
    // debounced at least once.
    if (trailing && lastArgs) {//如果设置trailing为true,并且有lastArgs,调用func
      return invokeFunc(time);
    }
    lastArgs = lastThis = undefined;//清除lastArgs和lastThis
    return result;//否则返回result
  }

  function cancel() {//取消执行
    if (timerId !== undefined) {
      clearTimeout(timerId);
    }
    lastInvokeTime = 0;
    lastArgs = lastCallTime = lastThis = timerId = undefined;
  }

  function flush() {//直接执行
    return timerId === undefined ? result : trailingEdge(now());
  }

  function debounced() {
    var time = now(),
        isInvoking = shouldInvoke(time);//判断是否可以调用

    lastArgs = arguments;//得到参数
    lastThis = this;//得到this对象
    lastCallTime = time;//触发时间

    if (isInvoking) {
      if (timerId === undefined) {//首次触发,调用leadingEdge
        return leadingEdge(lastCallTime);
      }
      if (maxing) {
        // 处理多次频繁的调用
        timerId = setTimeout(timerExpired, wait);//设置定时器
        return invokeFunc(lastCallTime);
      }
    }
    if (timerId === undefined) {//如果没有timer,设置定时器
      timerId = setTimeout(timerExpired, wait);
    }
    return result;//返回result
  }
  debounced.cancel = cancel;
  debounced.flush = flush;
  return debounced;
}

module.exports = debounce;

_.throttle(func, [wait=0], [options={}])

//throttle.js

var debounce = require(‘./debounce‘),//debounce方法
    isObject = require(‘./isObject‘);//判断是否为对象

var FUNC_ERROR_TEXT = ‘Expected a function‘;

/**
 * 函数节流
 *
 * @param {Function} func 需要处理的函数.
 * @param {number} [wait=0] 执行间隔.
 * @param {Object} [options={}] 选项对象.
 * @param {boolean} [options.leading=false] 指定是否在超时前调用.
 * @param {number} [options.maxWait] func延迟调用的最大时间.
 * @param {boolean} [options.trailing=true] 指定是否在超时后调用.
 * @returns {Function} 返回节流之后的函数.
 * @example
 *
 * // Avoid excessively updating the position while scrolling.
 * jQuery(window).on(‘scroll‘, _.throttle(updatePosition, 100));
 *
 * // Invoke `renewToken` when the click event is fired, but not more than once every 5 minutes.
 * var throttled = _.throttle(renewToken, 300000, { ‘trailing‘: false });
 * jQuery(element).on(‘click‘, throttled);
 *
 * // Cancel the trailing throttled invocation.
 * jQuery(window).on(‘popstate‘, throttled.cancel);
 */
function throttle(func, wait, options) {
  var leading = true,
      trailing = true;

  if (typeof func != ‘function‘) {
    throw new TypeError(FUNC_ERROR_TEXT);
  }
  if (isObject(options)) {
    leading = ‘leading‘ in options ? !!options.leading : leading;
    trailing = ‘trailing‘ in options ? !!options.trailing : trailing;
  }
  return debounce(func, wait, {
    ‘leading‘: leading,
    ‘maxWait‘: wait,
    ‘trailing‘: trailing
  });
}

module.exports = throttle;

可以看到这两个方法基本上都差不多,区别在于throttle初始的时候设置了leading为true和maxWait,这样和debounce的区别在于,在第一次触发的时候throttle会直接调用,并且每隔wait的时间都会调用一次,而debounce第一次不会调用,并且只有当触发的间隔时间大于wait时才会调用,否则一直不会调用。

时间: 2024-10-12 21:37:46

lodash源码学习debounce,throttle的相关文章

lodash源码学习(10)

_.delay(func, wait, [args]) 延迟wait毫秒之后调用该函数,添加的参数为函数调用时的参数 //delay.js var baseDelay = require('./_baseDelay'),//baseDelay方法 baseRest = require('./_baseRest'),//创建使用rest参数方法 toNumber = require('./toNumber');//转化为数字 /** * * @param {Function} func 需要延迟执

lodash源码学习(2)

继续学习lodash,依然是数组的方法 “Array” Methods _.indexOf(array, value, [fromIndex=0]) 获取value在数组 array所在的索引值 使用 SameValueZero方式比较(第一个全等===的元素). 如果 fromIndex 值是负数, 则从array末尾起算 该方法依赖于strictIndexOf和baseIndexOf方法,先看它们的源码 //_strictIndexOf.js /** * _.indexOf的专业版本,对元素

lodash源码学习(1)

前端开发这个行业这几年发展速度太快,各种新技术不断更新,从es5到es6再到es7,从grunt,browserify到webpack,gulp,rollup,还有什么postcss,typescript,flow...,一直都在学习新技术,作为一个才工作不久的新人,感觉内心有点浮躁了,想巩固一下基础,之前听别人说lodash的源码很不错,所以学习学习.我不是什么大牛,如果有什么分析得不对的,大家请务必要原谅我....话不多说,lodash版本4.17.4,开始!. 1.“Array” Meth

lodash源码学习(7)

继续学习lodash,下面是Date篇,Date篇只有一个方法 “Date” Methods _.now() 得到1970 年 1 月 1日午夜与当前日期和时间之间的毫秒数. //now.js var root = require('./_root');//运行环境,node环境下为global,浏览器环境为window /** * * * @returns {number} 得到一个时间戳. * @example * * _.defer(function(stamp) { * console.

lodash源码学习(3)

“Array” Methods _.pullAt(array, [indexes]) 移除数组中在indexs中对应索引的元素,并返回这些元素 这个方法依赖于basePullAt方法 //_basePullAt.js var baseUnset = require('./_baseUnset'),//_.unset的基本实现,移除对象中对应路径的元素(暂时不分析) isIndex = require('./_isIndex');//是否是一个正确的索引 var arrayProto = Arra

lodash源码学习partial,partialRight

_.partial(func, [partials]) 创建一个func的包装方法,调用这个方法可以提前传入部分func方法的参数. 这个方法感觉通常用在有很多参数相同的场景,然后将相同的参数提前传入. 比如 var ajax = (type,url,data,dataType,async) => { ..//具体实现 } var ajGet = _.partial('get', _, _, 'json', true) ajGet('/user',{id:1}) 来看看具体实现 //partia

FireMonkey 源码学习(5)

(5)UpdateCharRec 该函数的源码分析如下: procedure TTextLayoutNG.UpdateCharRec(const ACanvas: TCanvas; NeedBitmap: Boolean; var NewRec: PCharRec; HasItem: Boolean; const CharDic: TCharDic; const AFont: TFont; const Ch: UCS4Char; const NeedPath: Boolean = False);

jquery源码学习

jQuery 源码学习是对js的能力提升很有帮助的一个方法,废话不说,我们来开始学习啦 我们学习的源码是jquery-2.0.3已经不支持IE6,7,8了,因为可以少学很多hack和兼容的方法. jquery-2.0.3的代码结构如下 首先最外层为一个闭包, 代码执行的最后一句为window.$ = window.jquery = jquery 让闭包中的变量暴露倒全局中. 传参传入window是为了便于压缩 传入undefined是为了undifined被修改,他是window的属性,可以被修

Hadoop源码学习笔记(1) ——第二季开始——找到Main函数及读一读Configure类

Hadoop源码学习笔记(1) ——找到Main函数及读一读Configure类 前面在第一季中,我们简单地研究了下Hadoop是什么,怎么用.在这开源的大牛作品的诱惑下,接下来我们要研究一下它是如何实现的. 提前申明,本人是一直搞.net的,对java略为生疏,所以在学习该作品时,会时不时插入对java的学习,到时也会摆一些上来,包括一下设计模式之类的.欢迎高手指正. 整个学习过程,我们主要通过eclipse来学习,之前已经讲过如何在eclipse中搭建调试环境,这里就不多述了. 在之前源码初