jQuery1.11源码分析，7-----jQuery一些基本的API

这篇文章比较繁杂，主要就是把jQuery源码从上到下列出来，看我的注释就好了。

jQuery源码对各种加载器做了处理。

//阅读这个源码是请先了解一下概念，即时函数，工厂模式
(function( global, factory ) {
    //这里之所以这样处理，是为了考虑CommonJS的环境，所以先检测是否有CommonJS的环境。
        if ( typeof module === "object" && typeof module.exports === "object" ) {
                // For CommonJS and CommonJS-like environments where a proper window is present,
                // execute the factory and get jQuery
                // For environments that do not inherently posses a window with a document
                // (such as Node.js), expose a jQuery-making factory as module.exports
                // This accentuates the need for the creation of a real window
                // e.g. var jQuery = require("jquery")(window);
                // See ticket #14549 for more info
        //有CommonJS环境则输出一个方法
                module.exports = global.document ?
            //若全局环境有document,则工厂函数调用时传入第二个参数
                        factory( global, true ) :
            //若全局环境没有document,则返回给CommonJS加载器一个留待以后调用的函数。
                        function( w ) {
                                if ( !w.document ) {
                                        throw new Error( "jQuery requires a window with a document" );
                                }
                                return factory( w );
                        };
        } else {
        //如果没有CommonJS环境，则直接执行函数获得全局jQuery方法。
                factory( global );
        }
// Pass this if window is not defined yet
//若全局环境里没有window(可能为NodeJS)，则调用上下文传入this。
}(typeof window !== "undefined" ? window : this, function( window, noGlobal ) {

上面最后的匿名函数相当于初始化函数，下面是该初始化函数的内容

// Can't do this because several apps including ASP.NET trace
// the stack via arguments.caller.callee and Firefox dies if
// you try to trace through "use strict" call chains. (#13335)
// Support: Firefox 18+
//这里我没看懂，补充链接
//http://developer.zdnet.com.cn/2007/0212/377947.shtml
//http://blog.csdn.net/arwindgao/article/details/6592357

//缓存各个方法到当前作用域，因为避免了每次调用slice等函数时要进行更深层次的查找,这样可以提升性能，更多方式可看《高性能Javascript》
var deletedIds = [];

var slice = deletedIds.slice;

var concat = deletedIds.concat;

var push = deletedIds.push;

var indexOf = deletedIds.indexOf;
//这个对象会在后面进行初始化，主要用来判断类型
var class2type = {};

var toString = class2type.toString;

var hasOwn = class2type.hasOwnProperty;

var trim = "".trim;
//这个后面用来保存支持性信息
var support = {};



var
        version = "1.11.0",

        // Define a local copy of jQuery
    //jQuery函数即是$函数，第一个参数是选择符，第二个参数是使用选择符查找的上下文环境
    // 比如要在父DOM里查找某子元素,$('body',document)
        jQuery = function( selector, context ) {
                // The jQuery object is actually just the init constructor 'enhanced'
                // Need init if jQuery is called (just allow error to be thrown if not included)
                return new jQuery.fn.init( selector, context );
        },

        // Make sure we trim BOM and NBSP (here's looking at you, Safari 5.0 and IE)
//此处的BOM是Byte Order Mark的缩写，字节序标记，为\uFEFF,必须去除
    //\xA0则是latin01编码中的nbsp;
        rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,

        // Matches dashed string for camelizing
    //后面这里主要负责把dash格式的变量名(webkit-transform)转换为驼峰格式(webkitTransform)
        rmsPrefix = /^-ms-/,
        rdashAlpha = /-([\da-z])/gi,

        // Used by jQuery.camelCase as callback to replace()
    //用来真正替换用的回调函数，后面真正用的时候的代码如下
    //camelCase: function( string ) {
    //        return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
    //},
        fcamelCase = function( all, letter ) {
                return letter.toUpperCase();
        };
//须了解概念，原型和原型链。
//此处将jQuery工厂函数的原型设置为一个包含制定属性的对象。
jQuery.fn = jQuery.prototype = {
        // The current version of jQuery being used
        jquery: version,
    //覆盖工厂函数的原型时必须保证constructor属性依旧指向原工厂函数
        constructor: jQuery,
    //最开始选择符为空
        // Start with an empty selector
        selector: "",

        // The default length of a jQuery object is 0
        length: 0,
    //调用数组的slice方法可以把this转换为数组。
    //为什么要用这个方法？添加了自定义属性的jQuery对象还是数组，可以试试Array.isArray($('body'))
        toArray: function() {
                return slice.call( this );
        },

        // Get the Nth element in the matched element set OR
        // Get the whole matched element set as a clean array
    //传数区间为[-length,length]
    //和后面eq的区别是，get返回DOM元素,eq返回jQuery对象
        get: function( num ) {
                return num != null ?

                        // Return a 'clean' array
            //如果传入的num为负数，则变为取从队尾开始数第N个元素
                        ( num < 0 ? this[ num + this.length ] : this[ num ] ) :

                        // Return just the object
            //之所以不调用toArray，是因为同样只需要一行代码，减轻耦合以及函数调用的开销
                        slice.call( this );
        },

        // Take an array of elements and push it onto the stack
        // (returning the new matched element set)
    //压栈函数，因为后面由部分工具需要改变 当前插找DOM元素的上下文，所以需要保存当前的环境。
    //后续函数实现依赖于此函数，凡是需要改变当前匹配元素集的操作，都需要进行压栈操作
        pushStack: function( elems ) {

                // Build a new jQuery matched element set
        //生成新的jQuery对象。
        //为什么要用这种奇葩的方式生成，不能直接$(elems)生成？
                var ret = jQuery.merge( this.constructor(), elems );

                // Add the old object onto the stack (as a reference)
        //prevObject指向之前的jQuery对象
                ret.prevObject = this;
                ret.context = this.context;

                // Return the newly-formed element set
                return ret;
        },

        // Execute a callback for every element in the matched set.
        // (You can seed the arguments with an array of args, but this is
        // only used internally.)
    //此处必须区分两个函数，jQuery.prototype.each和jQuery.each，
    //前者给由jQuery工厂函数生成的对象来使用，后者是以jQuery工厂函数为命名空间，把工具函数each绑定到jQuery工厂函数上，避免了全局污染。
    //前者通过调用后者来实现。
    //后面的很多函数实现都是采用这种方式。
        each: function( callback, args ) {
                return jQuery.each( this, callback, args );
        },

        map: function( callback ) {
        //因为map会生成新的jQuery对象，所以要pushStack
                return this.pushStack( jQuery.map(this, function( elem, i ) {
                        return callback.call( elem, i, elem );
                }));
        },

        slice: function() {
                return this.pushStack( slice.apply( this, arguments ) );
        },

        first: function() {
                return this.eq( 0 );
        },

        last: function() {
                return this.eq( -1 );
        },
    //eq取第几个元素然后生成jQuery对象
        eq: function( i ) {
                var len = this.length,
                        j = +i + ( i < 0 ? len : 0 ); //j = +i < 0 ? +i + len:+i 原写法比较好的是减少一次隐式转换
                return this.pushStack( j >= 0 && j < len ? [ this[j] ] : [] );
        },
    //对于本次jQuery对象的操作结束，返回压栈前的jQuery对象。
        end: function() {
                return this.prevObject || this.constructor(null);
        },

        // For internal use only.
        // Behaves like an Array's method, not like a jQuery method.
        push: push,
        sort: deletedIds.sort,
        splice: deletedIds.splice
};
//扩展对象函数
//接受三个参数，是否为深复制(可选)，目标对象，源对象。
//之所以把深复制参数放在最前面，是因为方便增加源对象的个数。
jQuery.extend = jQuery.fn.extend = function() {
        var src, copyIsArray, copy, name, options, clone,
                target = arguments[0] || {},
                i = 1,
                length = arguments.length,
                deep = false;
    //前面这几部分主要是为了复用，可以学习一下这种复用方式
        // Handle a deep copy situation
    //当传入的第一个参数是bool型
        if ( typeof target === "boolean" ) {
                deep = target;

                // skip the boolean and the target
        //跳过深复制标识符，重新获得新的目标对象。
                target = arguments[ i ] || {};
                i++;
        }

        // Handle case when target is a string or something (possible in deep copy)
    //为什么target不能是Function？因为有可能覆盖Function的一些属性
        if ( typeof target !== "object" && !jQuery.isFunction(target) ) {
                target = {};
        }

        // extend jQuery itself if only one argument is passed
    //如果只传进来一个对象，则说明目标对象为本jQuery对象。
        if ( i === length ) {
                target = this;
                i--;
        }
    //真正的复制开始了
        for ( ; i < length; i++ ) {
                // Only deal with non-null/undefined values
                if ( (options = arguments[ i ]) != null ) {
                        // Extend the base object
                        for ( name in options ) {
                                src = target[ name ];
                                copy = options[ name ];//待复制属性

                                // Prevent never-ending loop
                //如果待复制属性为目标对象，则不进行此次复制。
                                if ( target === copy ) {
                                        continue;
                                }

                                // Recurse if we're merging plain objects or arrays
                //如果进行深复制且待复制属性是朴素对象或队列
                                if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) {
                                        //深复制的时候要注意区分待复制的属性是对象还是数组
                    if ( copyIsArray ) {
                                                copyIsArray = false;            //使用此变量的目的是为了减少一次isArray的调用

                                                clone = src && jQuery.isArray(src) ? src : [];

                                        } else {
                                                clone = src && jQuery.isPlainObject(src) ? src : {};
                                        }

                                        // Never move original objects, clone them
                    //不是要增加一个引用到待复制对象，而是克隆它们。
                                        target[ name ] = jQuery.extend( deep, clone, copy );

                                // Don't bring in undefined values
                                } else if ( copy !== undefined ) {
                                        target[ name ] = copy;
                                }
                        }
                }
        }

        // Return the modified object
        return target;
};
//定义完扩展函数，就可以使用它了，添加一堆工具函数
jQuery.extend({
        // Unique for each copy of jQuery on the page
        expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),

        // Assume jQuery is ready without the ready module
        isReady: true,

        error: function( msg ) {
                throw new Error( msg );
        },

        noop: function() {},

        // See test/unit/core.js for details concerning isFunction.
        // Since version 1.3, DOM methods and functions like alert
        // aren't supported. They return false on IE (#2968).
    //这个写法是处理之前遗留的bug
        isFunction: function( obj ) {
                return jQuery.type(obj) === "function";
        },
    //先检测是否有原生的isArray方法。
        isArray: Array.isArray || function( obj ) {
                return jQuery.type(obj) === "array";
        },
    //通过检测对象下是否有window属性。。这个可以伪造。。
        isWindow: function( obj ) {
                /* jshint eqeqeq: false */
                return obj != null && obj == obj.window;
        },
    //是否为数字
        isNumeric: function( obj ) {
                // parseFloat NaNs numeric-cast false positives (null|true|false|"")
                // ...but misinterprets leading-number strings, particularly hex literals ("0x...")
                // subtraction forces infinities to NaN
        //当我们用typeof 来判断时，NaN和infinity都为number
        //这种方法可以检测字符串是否可以转换为数字。
                return obj - parseFloat( obj ) >= 0;
        },
    //检测空对象的方法
        isEmptyObject: function( obj ) {
                var name;
                for ( name in obj ) {
                        return false;
                }
                return true;
        },
    //检测是否为朴素对象，不能为DOM和window，不能为由工厂函数生产出来的对象
    //这里用了多种检测方式，值得学习
        isPlainObject: function( obj ) {
                var key;

                // Must be an Object.
                // Because of IE, we also have to check the presence of the constructor property.
                // Make sure that DOM nodes and window objects don't pass through, as well
                if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) {
                        return false;
                }

                try {
                        // Not own constructor property must be Object
            //为什么这里要加两个叹号？
                        if ( obj.constructor &&
                                !hasOwn.call(obj, "constructor") &&
                                !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) {
                                return false;
                        }
                } catch ( e ) {
                        // IE8,9 Will throw exceptions on certain host objects #9897
            // In some very specific cases (ex: IE accessing window.location of another window)
                        return false;
                }

                // Support: IE 0 && ( length - 1 ) in obj;
}