jq源码解析之绑在$,jQuery上面的方法(实例讲解)

// jQuery.extend 的方法 是绑定在 $ 上面的。
jQuery.extend( {

 //expando 用于决定当前页面的唯一性。 /\D/ 非数字。其实就是去掉小数点。
 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() {},

 // 判断是不是一个函数
 isFunction: function( obj ) {
  return jQuery.type( obj ) === "function";
 },

 //判断当前对象是不是window对象。
 isWindow: function( obj ) {
  return obj != null && obj === obj.window;
 },

 //判断obj是不是一个数字 当为一个数字字符串的时候页可以的哦 比如 "3.2"
 isNumeric: function( obj ) {

  var type = jQuery.type( obj );
  return ( type === "number" || type === "string" ) &&

   // 这个话的意思就是要限制 "3afc 这个类型的 字符串"
   !isNaN( obj - parseFloat( obj ) );
 },

 //判断obj 是不是一个对象
 isPlainObject: function( obj ) {
  var proto, Ctor;

  // obj 存在且 toString.call(obj) !== "[object object]"; 就肯定不是一个对象了。
  if ( !obj || toString.call( obj ) !== "[object Object]" ) {
   return false;
  }

  //getProto获取原型链上的对象。 getProto = Object.getPrototypeOf(); 获取原型链上的属性
  proto = getProto( obj );

  // getProto(Object.create(null)) -> proto == null 这种情况也是对象 obj = Object.create(null);
  if ( !proto ) {
   return true;
  }

  // obj 原型上的属性。 proto 上面有 constructor hasOwn = hasOwnPrototypeOf('name') 判断某个对象自身是否有 这个属性
  // Ctor： 当 proto 自身有constructor的时候， 取得constructor 这个属性的value 值。 其实就是 obj的构造函数。 type -> function
  Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
  //Ctor 类型为“function” 且 为构造函数类型吧。 这个时候 obj 也是对象。 我的理解 这个时候，obj = new O(); 其实就是某个构造函数的实列
  return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
 },
 //判断obj是不是一个空对象
 isEmptyObject: function( obj ) {
  //var o = {}
  var name;

  for ( name in obj ) {
   return false;
  }
  return true;
 },
 //获取js的数据类型。 其实方法就是 Object.prototype.toString.call(xx); xx 就是要检测的某个变量。 得到的结果是 "[object object]" "[object array]" ...
 type: function( obj ) {

  //除去null 和undefined 的情况。 返回本身。 也就是 null 或者 undefined. 因为 undefined == null -> true。
  if ( obj == null ) {
   return obj + "";
  }
  // 这个跟typeof xx(某个变量 ) -> undefined object,number,string,function,boolean(typeof 一个变量只能得到6中数据类型)
  /**
   * 1. obj 是一个对象 或者 obj 是一个 function 那么 直接class2type[toString.call(obj)] 这个话其实是在class2type 中根据key值找到对应的value。
   * class2type = {
   *  [object object]: "object",
   *  [object array]:"array" ...
   *
   * }
   * 这样类似的值。
   * class2type[toString.call(obj)] || "object" 连起来读就是，在class2type 中找不到类型的值，就直接返回 object
   *
   * 2.或者返回 typeof obj。的数据类型。 -> number, string,boolean 基本数据了类型吧。 (js 中有5中基本数据类型。 null ,undefined,number,string,boolean)
   */
  return typeof obj === "object" || typeof obj === "function" ?
   class2type[ toString.call( obj ) ] || "object" :
   typeof obj;
 },

 // 翻译为：全局的Eval函数。 说句实话。没有看懂这个是拿来干嘛的。 DOMval();
 /**
  *
  * @param code
  * function DOMEval( code, doc ) {
  doc = doc || document;

  var script = doc.createElement( "script" );

  script.text = code;
  doc.head.appendChild( script ).parentNode.removeChild( script );
 }
  创建一个 script标签， 或remove 这个标签。 目前没有搞懂拿来干嘛用。
  */
 globalEval: function( code ) {
  DOMEval( code );
 },

 // 这个是用来转为 驼峰的用函数吧。 ms- 前缀转为驼峰的吧。
 camelCase: function( string ) {
  return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
 },

 // each 方法。 $.each(obj,function(){}); 用于循环数组和对象的方法。
 each: function( obj, callback ) {
  var length, i = 0;

  if ( isArrayLike( obj ) ) { // 当obj 是一个数组的时候执行这个方法
   length = obj.length;
   for ( ; i < length; i++ ) {

    /*当$.each(obj,function(i,item){
      if( i = 2){
       return false。
      }
     })
     当$.each(obj,function(){}) 中的匿名函数中纯在 return false； 的时候跳出循环。
    */
    if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
     break;
    }
   }
  } else { // for in 循环对象。 callback.call(obj[i],i,obj,[i]) === false 跟数组循环是一道理
   for ( i in obj ) {
    if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
     break;
    }
   }
  }

  return obj;
 },

 // 去掉 text 两边的空白字符 $("input").val().trim() 一个道理吧。 text + "" 其实是为了把 text 转成一个字符串。 类型这种情况 123.replace(rtrim,"") 是会报错的。
 // 如果 123 + "" 其实变成了 "123"
 trim: function( text ) {
  return text == null ?
   "" :
   ( text + "" ).replace( rtrim, "" );
 },

 // $.makeArray 其实是将类数组转换成数组 对象。
 /**
  *
  *
  * @param arr
  * @param results
  * @returns {*|Array}
  * 比如： var b = document.getElementsByTagName("div"); b.reverse() 。 用b 来调reserver() 方法会直接报错的。因为这个时候b是类数组对象。
  * var a = $.makeArray(document.getElementsByTagName("div")); a.reverser()。 这样就不会报错了。
  *
  */
 makeArray: function( arr, results ) {
  var ret = results || [];

  if ( arr != null ) {
   if ( isArrayLike( Object( arr ) ) ) {
    jQuery.merge( ret,
     typeof arr === "string" ?
     [ arr ] : arr
    );
   } else {
    push.call( ret, arr );
   }
  }

  return ret;
 },

 /**
  *
  * @param elem 要检测的值
  * @param arr 待处理的数组
  * @param i 从待处理的数组的第几位开始查询. 默认是0
  * @returns {number} 返回 -1 。表示arr 中没有该value值， 或者该值的下表
  * $.inArray()。
  *
  */
 inArray: function( elem, arr, i ) {

  //如果arr 为 null 直接返回 -1 。
  /**
   * 对indxOf.call(arr,elem,i);方法的解释
   * var s = new String();
   * eg: var indexOf = s.indexOf; 用indexOf 变量来存字符串中的 indexOf的方法。
   * indexOf.call(arr,elem,i) ; 其实就是把字符串的indexOf 继承给数组，并且传递 elem 和 i 参数。
   * 更简单一点其实可以理解为: arr.indexOf(elem,i);
   */
  return arr == null ? -1 : indexOf.call( arr, elem, i );
 },

 // 合并数组
 /**
  *
  * @param first 第一个数组
  * @param second 第二个数组
  * @returns {*}
  */
 merge: function( first, second ) {
  var len = +second.length, //第二个数组的长度
   j = 0, //j 从0 开始
   i = first.length; //第一个数组的长度

  for ( ; j < len; j++ ) {
   first[ i++ ] = second[ j ];
  }
  // 其实用push 应该可以吧。

  first.length = i;

  return first;
 },
 /**
  *
  * @param elems 带过滤的函数
  * @param callback 过滤的添加函数
  * @param invert 来决定 $.grep(arr,callback) 返回来的数组，是满足条件的还是不满足条件的。 true 是满足条件的。 false 是不满足条件的。
  * @returns {Array}
  *
  * 返回一个数组。
  */
 grep: function( elems, callback, invert ) {
  var callbackInverse,
   matches = [],
   i = 0,
   length = elems.length,
   callbackExpect = !invert;

  // Go through the array, only saving the items
  // that pass the validator function
  for ( ; i < length; i++ ) {
   callbackInverse = !callback( elems[ i ], i );
   if ( callbackInverse !== callbackExpect ) {
    matches.push( elems[ i ] );
   }
  }

  return matches;
 },

 /**
  *
  * @param elems 带处理的数组
  * @param callback 回调函数
  * @param arg 这参数用在callback回调函数的。
  * callback(elems[i],i,arg)
  * @returns {*}
  *
  * $.map(arr,function(item,i,arg){},arg)
  * 将一个数组，通过callback 转换成另一个数组。
  * eg: var b = [2,3,4];
  * var a = $.map(b,function(item,i,arg){
  *   return item + arg;
  * },1)
  * console.log(a) [3,4,5]
  */
 map: function( elems, callback, arg ) {
  var length, value,
   i = 0,
   ret = [];

  // Go through the array, translating each of the items to their new values
  if ( isArrayLike( elems ) ) {
   length = elems.length;
   for ( ; i < length; i++ ) {
    value = callback( elems[ i ], i, arg );

    if ( value != null ) {
     ret.push( value );
    }
   }

  // Go through every key on the object,
  } else {
   for ( i in elems ) {
    value = callback( elems[ i ], i, arg );

    if ( value != null ) {
     ret.push( value );
    }
   }
  }

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

 // 对对象的一个全局标志量吧。 没搞懂具体用处
 guid: 1,

 // Bind a function to a context, optionally partially applying any
 // arguments.
 /**
  *
  * @param fn
  * @param context
  * @returns {*}
  *
  * es6也提供了 new Proxy() 。对象。
  */
 proxy: function( fn, context ) {
  var tmp, args, proxy;
  //当content是字符串的时候 
  if ( typeof context === "string" ) {
   tmp = fn[ context ];
   context = fn;
   fn = tmp;
  }

  // Quick check to determine if target is callable, in the spec
  // this throws a TypeError, but we will just return undefined.
  if ( !jQuery.isFunction( fn ) ) {
   return undefined;
  }

  // Simulated bind
  args = slice.call( arguments, 2 );
  proxy = function() {
   return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
  };

  // Set the guid of unique handler to the same of original handler, so it can be removed
  proxy.guid = fn.guid = fn.guid || jQuery.guid++;

  return proxy;
 },
 //$.now 当前时间搓
 now: Date.now,

 // jQuery.support is not used in Core but other projects attach their
 // properties to it so it needs to exist.
 /**
  * 检测浏览器是否支持某个属性
  * $.support.style
  */
 support: support
} );