$q
一个帮助处理异步执行函数的服务。当他们做完处理时,使用它们的返回值(或异常)。
受 Kris Kowa’s Q 的启发,这是一个实现promise/deferred对象的启用。
$q的两种方式---这是一个更类似于Kris Kowal Q或jQuery的递延实现,另一种在一定程度上类似的ES6承诺。
Deferred Api
一个被$q.defer()调用的deferred的新实例。
deferred对象的目的是暴露相关承诺实例,以及APIs被执行的成功或不成功情况,以及任务的状态。
方法:
resolve(value):根据value以解决派生的promise。如果值是通过$q.reject构造的rejection 对象,该promise将被拒绝。
reject(reason):根据reason以拒绝派生的promise。这相当通过 $q.reject构造的rejection 对象来解决。
notify(value):在 promise 被执行的过程中提供状态更新情况。这可能会被多次调用,在promise是被解决还是被拒绝之前。
属性:
promise:承诺,与这个延迟相关的承诺对象。
Promise Api
当一个deferred实例被创建时,一个promise实例被创建,并且可以通过调用deferred.promise检索。Promise对象的目的是当它完成后允许需要的地方获得延迟任务的结果。
方法:
then(successCallback,errorCallback,notifyCallback);
无论什么时候,promise是已经(将要)被解决或拒绝,只要结果是可用的,就调用一个成功/错误的回调异步。回调函数带着一个参数被调用:解决的结果或拒绝的原因。此外,在承诺被解决或被拒绝之前,通知回调可能被调用0或多次用来提供一个指示进度。
这个方法返回被successCallback/errorCallback的解决或拒绝的返回值作为一个新的承诺(除非返回值是个promise,在承诺链的承诺和值都被解决的情况下)。它还将通过notifycallback方法的返回值进行通知。promise 不能从notifyCallback方法得到解决或拒绝 。
catch(errorCallback);
promise.then(null, errorCallback) 的快捷方式。
finally(callback,notifyCallback);
允许你观察一个承诺的解决或拒绝,但这样做不能修改最后的值。这可用于promise不论是被解决或拒绝后释放资源或做一些清理。
链式承诺
因为调用本次promise的方法将会返回一个新的延生的promise,它很容易创建一个承诺链:
promise = promise.then(function(result){ return result+1; });
当一个承诺解决另一个承诺(这将推迟其进一步的解决)可能创建一个任何长度的链。它可能在链中的任何处暂停/推迟承诺。这使得它可以像$http的响应拦截这类强大的API。
使用:$q(resolver);
方法:
defer();
创建一个deferred对象,它代表一个将在将来完成的任务。返回一个deferred的新实例。
reject(reason);
创建一个由指定的理由拒绝的承诺。在承诺链中,这个api将被用于承诺的拒绝。如果你正在处理一个承诺链的最后一个承诺,那么你不需要担心它。
reason:常数,消息,异常或一个对象表示拒绝原因。
返回一个已经根据拒绝原因解决了的承诺。