pormise Q 使用文档简单描述

promise.jpg

关于 promise 介绍和使用方法 请点击浏览其他博客.

今天分享的是针对 Q 开源包 api 的简单白话版本.

  1. promise.then(onFulfilled, onRejected, onProgress)

then 回调接收 3个参数 ,分别是 成功时,失败时,持续读取状态时


前两个函数对应Promise的两种状态的回调函数fulfiled 和 rejected,第三个函数用于处理进度信息


  1. promise.catch(onRejected)

promise 遇到异常时执行


promise.then(undefined, onRejected) 当catch到异常时的执行 catch


  1. promise.progress(onProgress)

持续读取状态


类似:promise.then(undefined, undefined, onProgress)


  1. promise.finally(callback)

类似于 try catch finally 一样,会在 promise 执行完全后才执行的方法,即使遇到callback 一个 promise ,也会在 callback 之后执行 finally

  1. promise.done(onFulfilled, onRejected, onProgress)

当有一个未处理的rejection或者其onrejected未定义时,这时 done 方法就生效了,它可以终结一个 promise 调用链.

6.promise.get(propertyName)

获取一个 promise 返回对象的某个参数

类似于:


promise.then(function (object) { return object[propertyName]; });


  1. promise.post(methodName, args)

给一个 promise 返回对象,设置一个 参数,参数名叫 methodName

类似于:


promise.then(function (o) { return o[methodName].apply(o, args); });


  1. promise.keys()

获取一个 promise 返回对象的 所有 键.

类似于:


promise.then(function (o) { return Object.keys(o); });


  1. promise.fapply(args)

promise 返回一个函数,然后接着调用这个函数

类似于:


promise.then(function (f) { return f.apply(undefined, args); });

// f 是一个函数 // apply 方法后 args 是参数数组


  1. promise.fcall(args)

和上面的相似. promise 返回一个函数,同时调用这个函数

类似于:


promise.then(function (f) { return f.call(undefined, args); });

和上面 apply 唯一区别是 args apply 的 args 是参数数组 call 是 args 是参数列


  1. promise.all()

其接受一个promise数组,只有当数组中的每个promise都执行成功,才会成功并将结果以数组的形式返回 当有一个promise失败,即失败 总之是为了确保数组中的promise都成功

关于promise 方法 all() 的使用实例 点击查看此博文.

  1. promise.delay(ms)

promise 的延迟方法 只有当ms毫秒后promise才执行完时才会正常的返回正常的值

出自:pormise Q 使用文档简单描述



回到顶部