跟underscore一块儿学如何写函数库

原文:zhehuaxuan.github.io/2019/03/07/…
做者:zhehuaxuanjavascript

目的

Underscore 是一个 JavaScript 工具库,它提供了一整套函数式编程的实用功能,可是没有扩展任何 JavaScript 内置对象。前端

本文主要梳理underscore内部的函数组织与调用逻辑的方式和思想。java

经过这篇文章,咱们能够:node

了解underscore在函数组织方面的巧妙构思;git

为本身书写函数库提供必定思路;github

咱们开始!编程

本身写个函数库

前端的小伙伴必定不会对jQuery陌生,常用$.xxxx的形式进行调用,underscore使用_.xxxx,若是本身在ES5语法中写过自定义模块的话,就能够写出下面一段代码:数组

//IIFE函数
(function(){
    //获取全局对象
    var root = this;
    //定义对象
    var _ = {};
    //定义和实现函数
    _.first = function(arr,n){
        var n = n || 0;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }
    //绑定在全局变量上面
    root._ = _;
})();
console.log(this);
复制代码

在Chrome浏览器中打开以后,打印出以下结果:浏览器

image-20190305235718888

咱们看到在全局对象下有一个_属性,属性下面挂载了自定义函数。
咱们不妨使用_.first(xxxx)在全局环境下直接调用。bash

console.log(_.first([1,2,3,4]));
console.log(_.first([1,2,3,4],1));
console.log(_.first([1,2,3,4],3));
复制代码

输出结果以下:

image-20190306000334727

没问题,咱们的函数库制做完成了,咱们通常直接这么用,也不会有太大问题。

underscore是怎么作的?

underscore正是基于上述代码进行完善,那么underscore是如何接着往下作的呢?容我娓娓道来!

对兼容性的考虑

首先是对兼容性的考虑,工具库固然须要考虑各类运行环境。

// Establish the root object, `window` (`self`) in the browser, `global`
// on the server, or `this` in some virtual machines. We use `self`
// instead of `window` for `WebWorker` support.
var root = typeof self == 'object' && self.self === self && self ||
              typeof global == 'object' && global.global === global && global ||
              this ||
              {};
复制代码

上面是underscore1.9.1在IIFE函数中的源码,对应于咱们上面本身写的var root = this;

在源码中做者也做了解释:
建立root对象,而且给root赋值。怎么赋值呢?

浏览器端:window也能够是window.self或者直接self

服务端(node):global

WebWorker:self

虚拟机:this

underscore充分考虑了兼容性,使得root指向对局对象。

支持两种不一样风格的函数调用

在underscore中咱们可使用如下两种方式调用:

  1. 函数式的调用:console.log(_.first([1,2,3,4]));
  2. 对象式调用:console.log(_([1,2,3,4])).first();

在underscore中,它们返回的结果都是相同的。

第一种方式咱们如今就没有问题,难点就是第二种方式的实现。

对象式调用的实现

解决这个问题要达到两个目的:

  1. _是一个函数,而且调用返回一个对象;
  2. 这个对象依然可以调用挂载在_对象上声明的方法。

咱们来看看underscore对于_的实现:

var _ = function(obj) {
      if (obj instanceof _) return obj;
      if (!(this instanceof _)) return new _(obj);
      this._wrapped = obj;
};
复制代码

相關圖片

不怕,咱们不妨调用_([1,2,3,4]))看看他是怎么执行的!

第一步if (obj instanceof _) return obj;传入的对象及其原型链上有_类型的对象,则返回自身。咱们这里的[1,2,3,4]显然不是,跳过。

第二步if (!(this instanceof _)) return new _(obj);,若是当前的this对象及其原型链上没有_类型的对象,那么执行new操做。调用_([1,2,3,4]))时,thiswindow,那么(this instanceof _)false,因此咱们执行new _([1,2,3,4])

第三步:执行new _([1,2,3,4]),继续调用_函数,这时

obj[1,2,3,4]

this为一个新对象,而且这个对象的__proto__指向_.prototype(对于new对象执行有疑问,请猛戳此处)

此时

(obj instanceof _)为false

(this instanceof _)为true

因此此处会执行this._wrapped = obj;,在新对象中,添加_wrapped属性,将[1,2,3,4]挂载进去。

综合上述函数实现的效果就是:

_([1,2,3,4]))<=====>new _([1,2,3,4])

而后执行以下构造函数:

var _ = function(obj){
    this._wrapped = obj
}
复制代码

最后获得的对象为:

image-20190306201849178

image-20190306235445836

咱们执行以下代码:

console.log(_([1,2,3,4]));
console.log(_.prototype);
console.log(_([1,2,3,4]).__proto__ == _.prototype);
复制代码

看一下打印的信息:

image-20190306214133549

这代表经过_(obj)构建出来的对象确实具备两个特征:

  1. 下面挂载了咱们传入的对象/数组
  2. 对象的_proto_属性指向_prototype

到此咱们已经完成了第一个问题。

「我正是个天才 表æƒ
åŒ
」的圖片搜尋結果

接着解决第二个问题:

这个对象依然可以调用挂载在_对象上声明的方法

咱们先来执行以下代码:

_([1,2,3,4]).first();
复制代码

此时JavaScript执行器会先去找_([1,2,3,4])返回的对象上是否有first属性,若是没有就会顺着对象的原型链上去找first属性,直到找到并执行它。

咱们发现_([1,2,3,4])返回的对象属性和原型链上都没有first

image-20190307000429320

那咱们本身先在_.prototype上面加一个first属性上去试试:

(function(){
    //定义
    var root = typeof self == 'object' && self.self === self && self ||
    typeof global == 'object' && global.global === global && global ||
    this ||
    {};
    
    var _ = function(obj) {
        if (obj instanceof _) return obj;
        if (!(this instanceof _)) return new _(obj);
        this._wrapped = obj;
      };

    _.first = function(arr,n){
        var n = n || 0;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }
    _.prototype.first = function(arr,n){
        var n = n || 0;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }
    root._ = _;
})();
复制代码

咱们在执行打印一下:

console.log(_([1,2,3,4]));
复制代码

效果以下:

image-20190306214554433

原型链上找到了first函数,咱们能够调用first函数了。以下:

console.log(_([1,2,3,4]).first());
复制代码

惋惜报错了:

image-20190306214848922

因而调试一下:

image-20190306214932983

咱们发现arrundefined,可是咱们但愿arr[1,2,3,4]

「不æ
Œ 表æƒ
åŒ
」的圖片搜尋結果

咱们立刻改一下_.prototype.first的实现

(function(){
    
    var root = typeof self == 'object' && self.self === self && self ||
    typeof global == 'object' && global.global === global && global ||
    this ||
    {};

    var _ = function(obj) {
        if (obj instanceof _) return obj;
        if (!(this instanceof _)) return new _(obj);
        this._wrapped = obj;
      };

    _.first = function(arr,n){
        var n = n || 0;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }
    _.prototype.first = function(arr,n=0){
        arr = this._wrapped;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }
    root._ = _;
})();
复制代码

咱们在执行一下代码:

console.log(_([1,2,3,4]).first());
复制代码

效果以下:

image-20190306215555025

咱们的效果彷佛已经达到了!

「赞 表æƒ
åŒ
」的圖片搜尋結果

如今咱们执行下面的代码:

console.log(_([1,2,3,4]).first(2));
复制代码

调试一下:

image-20190306215729756

凉凉了。

「凉凉 表æƒ
åŒ
」的圖片搜尋結果

其实咱们但愿的是:

[1,2,3,4]2arguments的形式传入first函数

咱们再来改一下:

//_.prototype.first = function(arr,n=0){
        // arr = this._wrapped;
        // if(n==0) return arr[0];
        // return arr.slice(0,n);
    //}
    _.prototype.first=function(){
        /** * 搜集待传入的参数 */
        var that = this._wrapped;
        var args = [that].concat(Array.from(arguments));
        console.log(args); 
    }
复制代码

咱们再执行下面代码:

_([1,2,3,4]).first(2);
复制代码

看一下打印的效果:

image-20190306220704637

参数都已经拿到了。

咱们调用函数一下first函数,咱们继续改代码:

_.prototype.first=function(){
     /** * 搜集待传入的参数 */
     var that = this._wrapped;
     var args = [that].concat(Array.from(arguments));
     /** * 调用在_属性上的first函数 */
     return _.first(...args);
}
复制代码

这样一来_.prototype上面的函数的实现都省掉了,至关于作一层代理;并且咱们不用再维护两套代码,一旦修改实现,两边都要改。

一箭双雕!

执行一下最初咱们的代码:

console.log(_.first([1,2,3,4]));
console.log(_.first([1,2,3,4],1));
console.log(_.first([1,2,3,4],3));
复制代码

image-20190306221231484

如今好像咱们全部的问题都解决了。

「赞 表æƒ
åŒ
」的圖片搜尋結果

可是彷佛仍是怪怪的。
咱们每声明一个函数都得在原型链上也声明一个同名函数。形以下面:

_.a = function(args){
    //a的实现
}
_.prototype.a = function(){
    //调用_.a(args)
}
_.b = function(args){
    //b的实现
}
_.prototype.b = function(){
    //调用_.b(args)
}
_.c = function(args){
    //c的实现
}
_.prototype.c = function(){
    //调用_.c(args)
}
.
.
.
1000个函数以后...
复制代码

会不会以为太恐怖了!

「害怕 表æƒ
åŒ
」的圖片搜尋結果

咱们能不能改为以下这样呢?

_.a = function(args){
    //a的实现
}
_.b = function(args){
    //b的实现
}
_.c = function(args){
    //c的实现
}
1000个函数以后...
_.mixin = function(){
    //将_属性中声明的函数都挂载在_prototype上面
}
_.mixin(_);
复制代码

上面这么作好处大大的:

咱们能够专一于函数库的实现,不用机械式的复写prototype上的函数

underscore也正是这么作的!

咱们看看mixin函数在underscore中的源码实现:

// Add your own custom functions to the Underscore object.
_.mixin = function(obj) {
   _.each(_.functions(obj), function(name) {
   var func = _[name] = obj[name];
      _.prototype[name] = function() {
          var args = [this._wrapped];
          push.apply(args, arguments);
          return chainResult(this, func.apply(_, args));
      };
   });
    return _;
};
  
// Add all of the Underscore functions to the wrapper object.
_.mixin(_);
复制代码

有了上面的铺垫,这个代码一点都不难看懂,首先调用_.each函数,形式以下:

_.each(arrs, function(item) {
     //遍历arrs数组中的每个元素
 }
复制代码

咱们一想就明白,咱们在_对象属性上实现了自定义函数,那么如今要把它们挂载到—_.prototype属性上面,固然先要遍历它们了。

咱们能够猜到_.functions(obj)确定返回的是一个数组,并且这个数组确定是存储_对象属性上面关于咱们实现的各个函数的信息。

咱们看一下_.function(obj)的实现:

_.functions = _.methods = function(obj) {
  var names = [];
  /** ** 遍历对象中的属性 **/
  for (var key in obj) {
      //若是属性值是函数,那么存入names数组中
     if (_.isFunction(obj[key])) names.push(key);
  }
  return names.sort();
};
复制代码

确实是这样的!

「拉菲 表æƒ
åŒ
」的圖片搜尋結果

咱们把上述实现的代码整合起来:

(function(){
    /** * 保证兼容性 */
    var root = typeof self == 'object' && self.self === self && self ||
    typeof global == 'object' && global.global === global && global ||
    this ||
    {};

    /** * 在调用_(obj)时,让其执行new _(obj),并将obj挂载在_wrapped属性之下 */
    var _ = function(obj) {
        if (obj instanceof _) return obj;
        if (!(this instanceof _)) return new _(obj);
        this._wrapped = obj;
      };
    
    //本身实现的first函数
    _.first = function(arr,n){
        var n = n || 0;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }

    //判断是不是函数
    _.isFunction = function(obj) {
        return typeof obj == 'function' || false;
    };

    //遍历生成数组存储_对象的函数值属性
    _.functions = _.methods = function(obj) {
        var names = [];
        for (var key in obj) {
          if (_.isFunction(obj[key])) names.push(key);
        }
        return names.sort();
      };
  
    //本身实现的遍历数组的函数
    _.each = function(arrs,callback){
        for(let i=0;i<arrs.length;i++){
            callback(arrs[i]);
        }
    }
    
    var ArrayProto = Array.prototype;
    var push = ArrayProto.push;
 
    //underscore实现的mixin函数
    _.mixin = function(obj) {
        console.log(_.functions(obj)); //咱们打印一下_.functions(_)到底存储了什么?
        _.each(_.functions(obj), function(name) {
          var func = _[name] = obj[name];
           _.prototype[name] = function() {
               var args = [this._wrapped];
               push.apply(args, arguments);
               return func.apply(_, args);
           };
        });
         return _;
    };

    //执行minxin函数
    _.mixin(_);
    root._ = _;
})();
复制代码

咱们看一下_.functions(obj)返回的打印信息:

image-20190306224747300

确实是_中自定义函数的属性值。

咱们再来分析一下each中callback遍历各个属性的实现逻辑。

var func = _[name] = obj[name];
 _.prototype[name] = function() {
     var args = [this._wrapped];
      push.apply(args, arguments);
     return func.apply(_, args);
};
复制代码

第一句:func变量存储每一个自定义函数

第二句: _.prototype[name]=function();_.prototype上面声明相同属性的函数

第三句:args变量存储_wrapped下面挂载的值

第四句:跟var args = [that].concat(Array.from(arguments));做用类似,将两边的参数结合起来

第五句:执行func变量指向的函数,执行apply函数,将上下文对象_和待传入的参数`args``传入便可。

咱们再执行如下代码:

console.log(_.first([1,2,3,4]));
console.log(_.first([1,2,3,4],1));
console.log(_.first([1,2,3,4],3));
复制代码

结果以下:

image-20190306230712917

Perfect!

这个函数在咱们的浏览器中使用已经没有问题。

可是在Node中呢?又引出新的问题。

再回归兼容性问题

咱们知道在Node中,咱们是这样的:

//a.js
let a = 1;
module.exports = a;
//index.js
let b = require('./a.js');
console.log(b) //打印1
复制代码

那么:

let _ = require('./underscore.js')
_([1,2,3,4]).first(2);
复制代码

咱们也但愿上述的代码可以在Node中执行。

因此root._ = _是不够的。

underscore是怎么作的呢?

以下:

if (typeof exports != 'undefined' && !exports.nodeType) {
    if (typeof module != 'undefined' && !module.nodeType && module.exports) {
        exports = module.exports = _;
    }
    exports._ = _;
} else {
    root._ = _;
}
复制代码

咱们看到当全局属性exports不存在或者不是DOM节点时,说明它在浏览器中,因此:

root._ = _;

若是exports存在,那么就是在Node环境下,咱们再来进行判断:

若是module存在,而且不是DOM节点,而且module.exports也存在的话,那么执行:

exports = module.exports = _;

在统一执行:

exports._ = _;

附录

下面是最后整合的阉割版underscore代码:

(function(){
    /** * 保证兼容性 */
    var root = typeof self == 'object' && self.self === self && self ||
    typeof global == 'object' && global.global === global && global ||
    this ||
    {};

    /** * 在调用_(obj)时,让其执行new _(obj),并将obj挂载在_wrapped属性之下 */
    var _ = function(obj) {
        if (obj instanceof _) return obj;
        if (!(this instanceof _)) return new _(obj);
        this._wrapped = obj;
      };
    
    //本身实现的first函数
    _.first = function(arr,n){
        var n = n || 0;
        if(n==0) return arr[0];
        return arr.slice(0,n);
    }

    //判断是不是函数
    _.isFunction = function(obj) {
        return typeof obj == 'function' || false;
    };

    //遍历生成数组存储_对象的函数值属性
    _.functions = _.methods = function(obj) {
        var names = [];
        for (var key in obj) {
          if (_.isFunction(obj[key])) names.push(key);
        }
        return names.sort();
      };
  
    //本身实现的遍历数组的函数
    _.each = function(arrs,callback){
        for(let i=0;i<arrs.length;i++){
            callback(arrs[i]);
        }
    }

    var ArrayProto = Array.prototype;
    var push = ArrayProto.push;
 
    //underscore实现的mixin函数
    _.mixin = function(obj) {
        _.each(_.functions(obj), function(name) {
        var func = _[name] = obj[name];
           _.prototype[name] = function() {
               var args = [this._wrapped];
               push.apply(args, arguments);
               return func.apply(_, args);
           };
        });
        return _;
    };


    //执行minxin函数
    _.mixin(_);
    if (typeof exports != 'undefined' && !exports.nodeType) {
        if (typeof module != 'undefined' && !module.nodeType && module.exports) {
            exports = module.exports = _;
        }
        exports._ = _;
    } else {
        root._ = _;
    }
})();
复制代码

欢迎各位大佬拍砖!同时您的点赞是我写做的动力~谢谢。

相关文章
相关标签/搜索