jquery原型方法map的使用和源码分析

原型方法map跟each类似调用的是同名静态方法，只不过返回来的数据必须经过另一个原型方法pushStack方法处理之后才返回，源码如下：

map: function( callback ) { return this.pushStack( jQuery.map(this, function( elem, i ) { return callback.call( elem, i, elem ); })); },

本文主要就是分析静态map方法至于pushStack在下一篇随笔里面分析；

首先了解下map的使用（手册内容）

$.map将一个数组中的元素转换到另一个数组中。

作为参数的转换函数会为每个数组元素调用，而且会给这个转换函数传递一个表示被转换的元素作为参数。

转换函数可以返回转换后的值、null（删除数组中的项目）或一个包含值的数组，并扩展至原始数组中。

参数

arrayOrObject,callbackArray/Object,FunctionV1.6

arrayOrObject:数组或者对象。

为每个数组元素调用，而且会给这个转换函数传递一个表示被转换的元素作为参数。

函数可返回任何值。

另外，此函数可设置为一个字符串，当设置为字符串时，将视为“lambda-form”（缩写形式？），其中 a 代表数组元素。

如“a * a”代表“function(a){ return a * a; }”。

 

示例1：

//将原数组中每个元素加 4 转换为一个新数组。

//jQuery 代码:
 $.map( [0,1,2], function(n){ return n + 4; }); //结果:
 [4, 5, 6]

示例2：

//原数组中大于 0 的元素加 1 ，否则删除。

//jQuery 代码:
 $.map( [0,1,2], function(n){ return n > 0 ? n + 1 : null; }); //结果:
 [2, 3]

示例3：

//原数组中每个元素扩展为一个包含其本身和其值加 1 的数组，并转换为一个新数组

//jQuery 代码:
 $.map( [0,1,2], function(n){ return [ n, n + 1 ]; }); //结果:
 [0, 1, 1, 2, 2, 3]

可以看出map方法跟each方法类似通过循环每个对象或者数组的“项”执行回调函数来实现对数组或者对象的操作，但是这两个方法也有很多不同点

比如each()返回的是原来的数组，并不会新创建一个数组，而map则会创建新的数组，；each遍历是this指向当前数组或对象值，map则指向window，因为在源码中并不像each那样使用对象冒充；

例如：

var items = [1,2,3,4]; $.each(items, function() { alert('this is ' + this); }); var newItems = $.map(items, function(i) { return i + 1; }); // newItems is [2,3,4,5]
 //使用each时，改变的还是原来的items数组，而使用map时，不改变items，只是新建一个新的数组。 var items = [0,1,2,3,4,5,6,7,8,9]; var itemsLessThanEqualFive = $.map(items, function(i) { // removes all items > 5 
if (i > 5) 　　return null; 　　return i; }); // itemsLessThanEqualFive = [0,1,2,3,4,5]

言归正传回到map源码

// arg is for internal usage only
    map: function( elems, callback, arg ) { var value, key, ret = [], i = 0, length = elems.length, // jquery objects are treated as arrays
            isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ; // Go through the array, translating each of the items to their
        if ( isArray ) { for ( ; i < length; i++ ) { value = callback( elems[ i ], i, arg ); if ( value != null ) { ret[ ret.length ] = value; } } // Go through every key on the object,
        } else { for ( key in elems ) { value = callback( elems[ key ], key, arg ); if ( value != null ) { ret[ ret.length ] = value; } } } // Flatten any nested arrays
        return ret.concat.apply( [], ret ); },

首先还是声明几个变量为接下来的遍历做准备，其中jsArray变量用来简单区分对象和数组，这个布尔复合表达式比较长不过只要记住js运算符的有优先顺序就不难理解了，首先括号优先执行然后就是逻辑与》逻辑或》全等》赋值，然后就可以分析啦

首先圆括号里先计算然后结果加上 length !== undefined 、 typeof length === "number这两个必要条件最后的结果再跟elems instanceof jQuery进行逻辑或的运算，简单的说就是isArray为真的情况有：

1、elems instanceof jQuery  为true 换言之就是jquery对象

2、length !== undefined && typeof length === "number" 和  length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems )这三个至少成立一个

可以拆分为3个小情况

length是存在并且是数字而且待遍历的数组或者类数组等length属性大于0 length-1存在  这样就保证了是能遍历的，比如对于jquery对象  domList对象等

length是存在并且是数字而且length属性等于0  如果是0也没关系就是不会遍历

length是存在并且是数字而且待遍历对象是纯数组

满足这些条件之后开始根据isArray的结果分开遍历，对于“数组”采用for循环，对于对象采用for...in循环

// Go through the array, translating each of the items to their
        if ( isArray ) { for ( ; i < length; i++ ) { value = callback( elems[ i ], i, arg ); if ( value != null ) { ret[ ret.length ] = value; } }

是数组或者类数组的时候直接把循环的每一项的值和指针以及arg参数传入回调函数中执行，arg参数是此方法内部使用的参数，跟each以及一些其他jquery方法很相似，只要在执行回调函数时不返回null就把执行返回的结果添加到新数组中，对象操作亦是如此直接略过

// Flatten any nested arrays
        return ret.concat.apply( [], ret );

最后将结果集扁平化，为什么有这一步呢？因为map是可以扩展数组的在前面第3个示例就是如此：

$.map( [0,1,2], function(n){ return [ n, n + 1 ]; });

如果是这样使用的话得到的新数组是一个二维数组，所以必须降维

 ret.concat.apply( [], ret )等价于[].concat.apply([],ret)关键作用的是apply,因为apply的第二个参数把ret的数组分成多个参数传入给concat把二维数组转化为一维数组这个用法还是值得收藏的的
map方法简单分析完毕，能力有限错误之处望多多指正。