pormise Q 使用文档简单描述
文章目录
关于 promise 介绍和使用方法 请点击浏览其他博客.
今天分享的是针对 Q 开源包 api 的简单白话版本.
- promise.then(onFulfilled, onRejected, onProgress)
then 回调接收 3个参数 ,分别是 成功时,失败时,持续读取状态时
前两个函数对应Promise的两种状态的回调函数fulfiled 和 rejected，第三个函数用于处理进度信息
- promise.catch(onRejected)
promise 遇到异常时执行
promise.then(undefined, onRejected)
当catch到异常时的执行 catch
- promise.progress(onProgress)
持续读取状态
类似：promise.then(undefined, undefined, onProgress)
- promise.finally(callback)
类似于 try catch finally 一样,会在 promise 执行完全后才执行的方法,即使遇到callback 一个 promise ,也会在 callback 之后执行 finally
- promise.done(onFulfilled, onRejected, onProgress)
当有一个未处理的rejection或者其onrejected未定义时,这时 done 方法就生效了,它可以终结一个 promise 调用链.
6.promise.get(propertyName)
获取一个 promise 返回对象的某个参数
类似于:
promise.then(function (object) {
return object[propertyName];
});
- promise.post(methodName, args)
给一个 promise 返回对象,设置一个 参数,参数名叫 methodName
类似于:
promise.then(function (o) {
return o[methodName].apply(o, args);
});
- promise.keys()
获取一个 promise 返回对象的 所有 键.
类似于:
promise.then(function (o) {
return Object.keys(o);
});
- promise.fapply(args)
promise 返回一个函数,然后接着调用这个函数
类似于:
promise.then(function (f) {
return f.apply(undefined, args);
});
// f 是一个函数
// apply 方法后 args 是参数数组
- promise.fcall(args)
和上面的相似.
promise 返回一个函数,同时调用这个函数
类似于:
promise.then(function (f) {
return f.call(undefined, args);
});
和上面 apply 唯一区别是 args
apply 的 args 是参数数组
call 是 args 是参数列
- promise.all()
其接受一个promise数组，只有当数组中的每个promise都执行成功，才会成功并将结果以数组的形式返回
当有一个promise失败，即失败
总之是为了确保数组中的promise都成功
关于promise 方法 all() 的使用实例 点击查看此博文.
- promise.delay(ms)
promise 的延迟方法
只有当ms毫秒后promise才执行完时才会正常的返回正常的值