npm-bluebird使用

注意

  • 时刻注意return;
  • 使用Promise.promisify简化对test(val, function(err, result){})的处理;
  • 尽量避免使用 deferred object;

.spread

  • 用于简化处理返回值是数组的情况；
  • 用es6取代其处理返回数组的时候注意添加.all();

.catch()

  • 允许传入错误类型(error constructor)来区别错误判断,包括:
    • TypeError,
    • ReferenceError,
    • EvalError,
    • SyntaxError,
    • RangeError,
    • NetworkError,
    • TimeoutError
  • 也可以自己设置特别的错误类型，并且可以详细错误类型的信息;
  • 可以传入一个返回布尔值的函数进行过滤;
  • 传入一个对象简化判断;

.error

  • 如果把错误分成Operational errors和programmer errors,则可以用error方法来处理前者;这些错误包括:
    * failed to connect to server
    * failed to resolve hostname
    * invalid user input
    * request timeout
    * server returned a 500 response
    * socket hang-up
    * system is out of memory

.finally

  • fulfilled状态后触发;并与之后的.then方法同时被触发;
  • fulfilled状态触发后不会返回值到这个方法;同时其返回的方法也不会传递到下一个.then方法;

Promise.try

  • 传入函数,没有错误则其返回值为fulfilled状态,有错误则返回rejected状态的错误;

Promise.method

  • 处理机制与Promise.try类似,都传入函数;但其返回的是一个会返回promise对象的方法;

Promise.resolve

  • 将传入的数据转化为promise对象返回,除了原本是promise对象且是rejected状态的都会变成fulfilled状态;

Promise.reject

  • 将传入的数据转化为promise对象返回，状态都为rejected;

Promise.bind/.bind

  • 传入一个值，给后续的链式操作中绑定一个this为这个值;如果传入this,则绑定的是.bind()方法之前返回的值;

Collections

Promise.all

  • 传入数组,当全部值为fulfilled状态时以数组形式传递返回值;
  • 当有一个值状态为rejected时将改值传递到错误处理;其他值不传递;

Promise.join

  • 参数为一般参数加处理函数;处理函数相当于一个.then方法;
Promise.join(val1, val2, val3, function (val1, val2, val3) {}).then...
  • 处理机制与Promise.all类似;

Promise.props

  • 处理机制与Promise.all类似，接受对象处理;

Promise.any

  • 接受数组,会返回第一个达到fulfilled状态的值;如果是空数组或都为rejected状态，则全部返回错误处理;
  • 注意实际的运行时间是包括全部值的判断的;

Promise.some

  • 第一参数为接受数组，第二参数为判断的个数; 设置个数必须，且不能大于数字个数，可以为0;
  • 处理机制与Promise.all类似;返回最先到达设置个数的fulfilled状态的值;
  • 如果参数中fulfilled状态的值达不到设定个数,返回rejected状态的值到错误处理函数;

Promise.map

  • 第一参数为接受数组,第二参数为判断函数;

Promise.reduce, Promise.filter, Promise.each

  • 同上

.map

  • 第一参数为判断函数；第二参数为设置并发数: {concurrency: Infinity};设置并行个数能加快处理但不能保证返回顺序;
  • 注意传递过来的必须是数组；

.reduce, .filter, .each

  • 同上

Promise.mapSeries/.mapSeries

  • 与Promise.map类似;区别在于没有并发设置参数,如果其中一个为rejected状态,则之后的值便不再处理;

Promise.race

  • 接受数组,返回第一个达到fulfilled状态的值;

Resource management

Promise.using

  • 接受多个参数,最后一个为处理前面参数的函数,在前面参数都为fulfilled状态时才会处理;

Promisification

Promise.promisify

Promise.promisifyAll

posted @ 2015-12-30 23:02  JinksPeng  阅读(724)  评论(0)  编辑  收藏  举报