打造属于自己的underscore系列 ( 一 )
underscore作为开发中比较常用的一个javascript工具库,提供了一套丰富的函数式编程功能,该库并没有拓展原有的javascript原生对象,而是在自定义的
_
对象上,提供了100多个方法函数。在这个系列中,将从uderscore源码角度, 打造一个自己的underscore框架
一,框架设计
1.1 自执行函数
现代js 库的框架设计,一般都是以自执行函数的形式,自执行函数一般有两种形式
(function(){
// 形式一
}())
(function(){
// 形式二
})()
我们知道,函数声明的形式会挂载到window对象作为方法存在,而函数表达式的形式则会挂载在window对象作为属性存在,这都会造成变量污染,而自执行函数的好处在于可以防止变量的污染,函数执行完后便立刻销毁掉。
1.2 使用风格
underscore有两种风格形式可以使用,一种是面向对象类型,另一种是函数类型。
// 例子
_.map([1, 2, 3], function(n){ return n * 2; });
_([1, 2, 3]).map(function(n){ return n * 2; });
因此,在定义underscore类的时候需要考虑对象和函数两种场景。当以函数的形式调用时需要把 _ 当作一个构造函数并返回他的实例化。代码如下
(function(root){
var _ = function (obj) {
if (!(this instanceof _)) {
return new _(obj)
}
}
root._ = _
}(this))
1.3 使用环境
现在前端开发重视模块化,以node服务端而论, 我们有commonjs规范,以客户端而论,我们有AMD 和 CMD规范,对应的模块加载器为 requirejs 和 seajs。目前通行的javascript模块规范主要集中在commonjs 和 AMD,因此为了让定义的underscore库能够适用于各种规范。在框架的定义时需检测使用环境并兼容各种规范。
- 服务端:commonjs规范,检测module.exports 是否存在,满足时通过 module.exports = {} 将 underscore暴露出来,不满足则 通过window对象暴露出来。
- 客户端: AMD 规范, 检测 define.amd 是否存在,满足时通过
define('**', [], function(){ return '***' })
暴露模块
(function (root) {
var _ = function (obj) {
if (!(this instanceof _)) {
return new _(obj)
}
}
// commonjs 规范 检测 module.exports 是否存在
if ((typeof module !== 'undefined' && module.exports)) {
module.exports = {
_: _
}
} else {
root._ = _;// window 对象暴露方法
}
// amd 规范,检测 define.amd 是否存在
if (typeof define == 'function' && define.amd) {
define('underscore', [], function () {
return _;
});
}
}(this))
1.3.1 服务端使用
// commonjs
const _ = require('./underscore.js')
console.log(_)
1.3.2 客户端使用
// AMD
require(['underscore'], function (underscore) {
console.log(underscore)
})
1.4 方法定义
underscore的调用,既可以通过_.unique()
,也可以通过 _().unique()
,两种方法效果相同却需要在框架设计时定义两套方法,一套是定义 _ 对象的静态方法,另一套是扩展 _对象原型链上的方法。
_.uniqe = function() {}
_.prototype.unique = function() {}
为了避免冗余代码,可以将定义好的静态方法复制一份成为原型链上的方法
(function(root){
···
_.mixins = function() {
// 复制静态方法到原型上
}
_.mixins() // 执行方法
}(this))
mixins 方法的实现,需要遍历 underscore 对象上所有的静态方法,因此需要先完成对 遍历方法 _.each 的实现
1.41 _.each
_.each(list, iteratee, [context]) Alias: forEach
遍历list中的所有元素,按顺序用每个元素当做参数调用 iteratee 函数。如果传递了context参数,则把iteratee绑定到context对象上。每次调用iteratee都会传递三个参数:(element, index, list)。如果list是个JavaScript对象,iteratee的参数是 (value, key, list))。返回list以方便链式调用。
each 的第一个参数按照文档可以支持 数组,类数组,对象三种类型,数组类数组和对象在遍历时的处理方式不同。前者回调函数处理的是 值和下标,后者处理的是 值和属性。
// 判断数组,类数组方法
(function(root) {
···
_.each = function (list, callback, context) {
// context 存在会改变callback 中this 的指向
var i = 0;
var key;
if (isArrayLikeLike(list)) { // 数组,类数组
for (var i = 0; i < list.length; i++) {
context ? callback.call(context, list[i], i, list) : callback(list[i], i, list)
}
} else { // 对象
for (key in list) {
context ? callback.call(context, list[key], key) : callback(list[key], key)
}
}
}
var isArrayLike = function (collection) {
// 返回参数 collection 的 length 属性值
var length = collection.length;
// length是数值,非负,且小于等于MAX_ARRAY_INDEX
// MAX_ARRAY_INDEX = Math.pow(2, 53) - 1
return typeof length == 'number' && length >= 0 && length <= MAX_ARRAY_INDEX;
}
}(this))
1.4.2 _.mixin
mixin方法的设计,目的是为了在underscore原型对象上扩展更多的方法,它既可以用来扩展用户自定义的方法,比如
_.mixin({
capitalize: function(string) {
return string.charAt(0).toUpperCase() + string.substring(1).toLowerCase();
}
});
_("fabio").capitalize();
=> "Fabio"
当然也可以用来内部拷贝静态方法到原型链的方法上。
(function(root){
···
var push = Array.prototype.push
var _ = function (obj) {
if (!(this instanceof _)) {
return new _(obj)
}
this.wrap = obj // 存储实例对象传过来的参数
}
_.mixins = function (obj) {
_.each(obj, function (value, key) {
_.prototype[key] = function () {
var args = [this.wrap]
push.apply(args, arguments)
return value.apply(this, args)
}
})
}
_.mixins(_)
}(this))
其中关注点在arguments 的处理上,静态方法需要传递目标源作为方法的参数 即_.unique(目标源, 回调函数)
,而实例方法的目标源存储在构造对象的属性中 ,即_(目标源).unique(回调函数)
,因此定义实例方法时需要合并属性和回调函数。即Array.prorotype.push.apply([this.wrap], arguments)
,之后将他作为参数传递给静态方法并返回处理结果。
将类数组转成数组的方法
Array.prototype.slice.call(类数组)
var a = []; Array.prototype.push.apply(a, 类数组); console.log(a);
var a = []; Array.prototype.concat.apply(a, 类数组); console.log(a);
- ES6方法
Array.from(类数组)
- ES6扩展运算符
var args = [...类数组]
1.5 链式调用
1.5.1 _.chain()
返回一个封装的对象. 在封装的对象上调用方法会返回封装的对象本身, 直道 value 方法调用为止。
underscore中方法的调用返回的是处理后的值,因此无法支持方法的链式调用。如果需要链式调用,需要使用chain()方法,chain的使用会使每次调用方法后返回underscore的实例对象,直到 调用value方法才停止返回。
(function(root){
···
// chain方法会返回 _ 实例,并且标注该实例是否允许链式调用的
_.chain = function(obj) {
var instance = _(obj);
instance.chain = true;
return instance
}
// 增加是否支持链式调用的判断,如果支持,则返回该实例,不支持则直接返回结果,
var chainResult = function (instance, obj) {
return instance.chain ? _(obj).chain() : obj
}
_.mixins = function (obj) {
_.each(obj, function (value, key) {
_.prototype[key] = function () {
var args = [this.wrap]
push.apply(args, arguments)
return chainResult(this, value.apply(this, args)) // 修改实例方法的返回值,返回值通过chainResult 包装,根据chainResult的判断结果改变返回值
}
})
}
}(this))
1.5.2 value()
因为链式调用会使underscore的方法返回他的实例对象,所以当需要结束这一调用行为时,需要使用value()。 value()方法会返回调用的结果。
(function(root){
···
_.value = function(instance) {
return instance.wrap
}
}(this))