从react-start到co源码(三)

react作为当前非常盛行的前端框架,置信许多前端er都有捋臂张拳的进修它的主意。工欲善其事,必先利其器。这篇文章就简朴的给人人引见一下怎样我疾速的搭建一个react前端开辟环境。重要针对于react小白,大神不喜勿喷。
从题目可以看出,这里不会仅仅只引见一下react的开辟环境怎样搭建。我将这个系列分红三篇引见:

该篇是这个系列文章的第三篇,重假如对co的源码举行剖析解说。co的源码非常简朴,但完成的功用倒是非常的壮大。不相识的同砚可以经由过程co自行进修,也可以经由过程我这篇源码剖析的文章举行更深切的进修。

co源码归纳综合

co源码重要包含了两部份:大众要领和私有要领。

1、大众要领

  • co

  • co.wrap

2、私有要领

  • isObject

  • isGeneratorFunction

  • isGenerator

  • isPromise

  • objectToPromise

  • arrayToPromise

  • thunkToPromise

  • toPromise

源码的浏览递次发起先浏览私有要领的部份,然后在浏览大众要领的部份。各个部份的浏览递次也依据上面枚举的递次举行浏览。

co源码剖析

/**
 * slice() reference.
 */

var slice = Array.prototype.slice;

/**
 * Expose `co`.
 */

module.exports = co['default'] = co.co = co;

co.wrap = function (fn) {
  // 这个要领的重要作用就是将generator函数转化成平常的函数挪用  有点类似于thunk函数的转化
  /**
   * function* a(val) {
   *   return val
   * }
   *
   * console.log(co(a,'pavoooo'))
   * console.log(co.wrap(a)('pavoooo'))  就可以如许挪用了
   *  */
  createPromise.__generatorFunction__ = fn;
  return createPromise;
  function createPromise() {
    return co.call(this, fn.apply(this, arguments));
  }
};

function co(gen) {
  var ctx = this;
  var args = slice.call(arguments, 1)

  // co的挪用效果是一个promise对象
  return new Promise(function(resolve, reject) {
    // 假如co的第一个参数是函数的话 就将第二个以及后续的参数通报给这个函数
    // 并将gen的挪用效果赋给gen
    /**
     * co(function(){
     *    console.log(arguments)
     *  }, 1, 2, 3)
     * 不斟酌下面转化的状况 这个函数运转以后 会打印出{ '0': 1, '1': 2, '2': 3 }
     * 同时gen的值就是undefined
     */
    if (typeof gen === 'function') gen = gen.apply(ctx, args);
    // 这个条件推断的就是 假如gen挪用以后的返回值是undefined或许不是一个generator函数 直接将promise的状况转化成resolved
    // 同时将返回值作为resolved的状况值开释 也就是说co函数的参数应该是一个generator函数
    if (!gen || typeof gen.next !== 'function') return resolve(gen);

    // 挪用onFulfilled函数--递归的挪用generator函数的next要领
    onFulfilled();

    function onFulfilled(res) {
      var ret;
      try {
        // 这个语句有两重作用
        // 一、吸收上一个yield返回的值
        // 二、将挪用以后的遍历器赋值给ret并通报到next函数中以推断gen挪用是不是完毕
        ret = gen.next(res);
      } catch (e) {
        return reject(e);
      }
      // 递归的挪用next 也是是递归的实行gen函数的yield语句
      next(ret);
    }

    function onRejected(err) {
      var ret;
      try {
        // 这个函数重假如当yield后的语句不符合划定的范例的时刻 向外抛出一个毛病
        ret = gen.throw(err);
      } catch (e) {
        return reject(e);
      }
      next(ret);
    }

    function next(ret) {
      // 假如generator函数运转完毕 直接开释效果 这个效果就是gen函数中return的效果 这就可以在外部经由过程then要领吸收
      if (ret.done) return resolve(ret.value);
      // 否则将遍历器对应的value转化成promise
      var value = toPromise.call(ctx, ret.value);
      // 假如可以胜利的转化成promise 挪用then要领 将值开释出来 并将其作为onFulfilled函数的参数  而在onFulfilled函数内部  又经由过程
      // gen.next()吸收 如许 就可以把每次gen.next().value保存在gen函数内部的变量
      if (value && isPromise(value)) return value.then(onFulfilled, onRejected);
      // 这里示意通报给co函数的generator函数的yield后的语句必需是一个function, promise, generator, array, or object
      return onRejected(new TypeError('You may only yield a function, promise, generator, array, or object, '
        + 'but the following object was passed: "' + String(ret.value) + '"'));
    }
  });
}

function toPromise(obj) {
  // 这个函数实际上是对下面几种将元素转化成promise对象的几个函数的鸠合  如许做就不需要在各个函数中离别推断值的范例然后
  // 挪用差别的要领  一致交给这个函数依据差别的值的范例挪用差别的转换函数
  // obj是假值
  if (!obj) return obj;
  // obj是promise
  if (isPromise(obj)) return obj;
  // obj是generation
  if (isGeneratorFunction(obj) || isGenerator(obj)) return co.call(this, obj);
  // obj是thunk函数
  if ('function' == typeof obj) return thunkToPromise.call(this, obj);
  // obj是数组
  if (Array.isArray(obj)) return arrayToPromise.call(this, obj);
  // obj是对象
  if (isObject(obj)) return objectToPromise.call(this, obj);
  // obj是平常范例的数据且为真 如字符串  数字等
  return obj;
}

function thunkToPromise(fn) {
  // thunk函数转换成promise
  // js的thunk函数就是将多参数函数转换成单参数函数的一种体式格局
  // 约定俗成的也是第一个参数是error对象 后续的参数是函数的返回值
  var ctx = this;
  return new Promise(function (resolve, reject) {
    fn.call(ctx, function (err, res) {
      // error不为空 直接将promise转化成rejected状况
      if (err) return reject(err);
      // 否则将函数转化成resolve状况
      if (arguments.length > 2) res = slice.call(arguments, 1);
      resolve(res);
    });
  });
}

function arrayToPromise(obj) {
  // 数组转化成promise--
  // 先将数组中的各个元素转化成promise 然后经由过程Promise.all举行包装  转化成一个新的promise实例并返回
  return Promise.all(obj.map(toPromise, this));
}

/**
 * 这个函数是将一个对象转换成promise对象 从isPromise函数的内部可知
 * 把对象转换成promise对象的条件就是 这个对象必需具有then要领 也是是必需是一个thenable对象
 */

function objectToPromise(obj){
  // 经由过程obj的constructor 建立出一个新的对象 这个对象具有obj一切继续的属性 如许就可以在这个对象上举行转化 从而防备了变动源对象
  var results = new obj.constructor();
  //获取到obj的一切非继续属性的键构成的数组
  var keys = Object.keys(obj);
  // 定义一个promise容器  并通报给Promise.all这个要领
  var promises = [];
  for (var i = 0; i < keys.length; i++) {
    var key = keys[i];
    // 依据值的范例挪用对应的转换函数转换成promise对象
    var promise = toPromise.call(this, obj[key]);
    // 这个if条件中的第一个条件 是容错处置惩罚 假如isPromise用的许多的状况下  发起将这个容错处置惩罚
    // 放在isPromise函数中 转换以后的值是promise 就挪用then要领  掏出promise对象中返回的值  
    // 然后其设置为对应键的值
    /**
     * 也就是说 假如一个对象是以下的情势:
     * var a = {
     *    p: new Promise((resolve, reject) => {
     *       resolve(2)
     * }) 
     * }
     * 
     * 经由defer函数的转换以后a.p = 3
     */
    if (promise && isPromise(promise)) defer(promise, key);
    // 假如不是promise就直接返回对应的值
    else results[key] = obj[key];
  }
  // 经由过程Promise.all将多个promise实例转化成一个新的实例 并返回
  return Promise.all(promises).then(function () {
    return results;
  });

  function defer(promise, key) {
    // predefine the key in the result
    results[key] = undefined;
    promises.push(promise.then(function (res) {
      results[key] = res;
    }));
  }
}

/**
 * 推断obj是不是是一个promise对象 
 * 依据promise A+的范例
 * 一个及格的promise必需是一个thenable对象也就是其必需供应一个then要领来获取值
 * 所以我们可以经由过程推断一个对象是不是具有then要领来推断是不是是promise对象 但这不是相对正确的要领 co内部经由过程Promise.all这个
 * 要领对isPromise()返回true的对象举行了封装  都可以将其转化成promise对象  所以在运用的时刻不需要过量的忧郁
 */

function isPromise(obj) {
  return 'function' == typeof obj.then;
}

function isGenerator(obj) {
  return 'function' == typeof obj.next && 'function' == typeof obj.throw;
}

/** 
 * 推断参数obj是不是是一个generator函数
 */
function isGeneratorFunction(obj) {
  var constructor = obj.constructor;
  if (!constructor) return false;
  /**
   * 推断是不是是一个generator函数
   * function* gen() {}  ====> gen.constructor.name = 'GeneratorFunction'
   * 同时这个if条件也是对以下的这类状况作的推断
   * function* gen() {}  
   * var g = gen() ====> g.constructor.name = 'GeneratorFunction'
   * 
   * displayName是一个非标准的属性 用于返回函数显现的称号 不引荐运用
   *  */
  if ('GeneratorFunction' === constructor.name || 'GeneratorFunction' === constructor.displayName) return true;
   /**
   * obj是经由过程原生的generator函数操纵得出  即
   * obj = generator()
   * obj = Object.create(generator)
   * obj = Object.create(generator())
   * 
   * 上面if条件都邑返回true
   * 
   * 下面的这个isGenerator函数  笔者猜想
   * 一是对原生generator函数挪用以后返回的迭代器的推断
   * 而是对自定义的generator函数的推断
   * 比方这类情势的返回效果也是true
   * function A() {}
   * A.prototype.next = function() {
   *    return {
   *        value: 1,
   *        done: false
   *     }
   * }
   * Aa.prototype.throw = function() {}
   *
   * var a = new A()
   * console.log(isGeneratorFunction(a))
   *  */
  return isGenerator(constructor.prototype);
}

/**
 * 用于推断一个对象是不是是地道的js对象
 * js中地道的对象平常有三种建立体式格局
 * var obj = {}
 * var obj = new Object
 * var obj = Object.create(Object.prototype)
 */
function isObject(val) {
  return Object == val.constructor;
}

以上就是对co源码的大抵剖析,不理解的或许有贰言的同砚迎接留言议论。

    原文作者:2json
    原文地址: https://segmentfault.com/a/1190000008189685
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞