$q in Angular [ngdoc service] 翻译

promise / deferred

promise

(action)

(action)

deferred

promise

try

catch

throw

// 在本例中，假设 `$q`, `scope` 以及 `okToGreet` 在当前执行环境中是可用的
// （如它们已经被注入，或者作为参数传递进来）.
function asyncGreet(name) {
var deferred = $q.defer();
setTimeout(function () {
deferred.notify('About to greet ' + name + '.');
if (okToGreet(name)) {
deferred.resolve('Hello, ' + name + '!');
} else {
deferred.reject('Greeting ' + name + ' is not allowed.');
}
}, 1000);
return deferred.promise;
}
var promise = asyncGreet('Robin Hood');
promise.then(function (greeting) {
alert('Success: ' + greeting);
}, function (reason) {
alert('Failed: ' + reason);
}, function (update) {
alert('Got notification: ' + update);
});

promise

deferred

promise api

Deferred API

$q.defer()

deffered

deffered

Promise

deffered 对象的方法

resolve(value)

value

promise

value

$q.reject

promise

reject(reason)

promise

$q.reject

resolve

notify(value)

promise

promise

deffered 对象的属性

promise

{Promise}

promise

Promise API

promise 对象的方法

then(successCallback, errorCallback, notifyCallback)

promise

then

promise

notify

0

promise

successCallback

errorCallback

notifyCallback

promise

notifyCallback

catch(errorCallback)

promise.then(null, errorCallback)

finally(callback)

promise

value

promise

finally

promise['finally'](callback)

Chaining promises | 创建promise链

promise

then

promise

promises链

promiseB = promiseA.then(function(result) {
return result + 1;
});

// promiseB 将会在处理完 promiseA 之后立即被处理,
// 并且其 value 值是 promiseA 的结果增加 1

promise链

promise

promise

promise链

阻塞/延迟(pause/defer)

$http

Kris Kowal's Q 与 \(q 之间的区别 主要区别有两点: Angular中的 `\)q

集成了 {@link ng.$rootScope.Scope}

Scope

模型观察机制，这意味着解决或拒绝的结果会以更快地传播速度反映在数据模型中(model)，避免不必要的浏览器重绘，因为重绘会导致UI闪烁.

Q

比

\(q` 拥有更多的功能特性，但也带来了代码字节数的增加。`\)q` 虽然是轻量级的，但包含了一般的异步任务所需的所有重要功能。

it('should simulate promise', inject(function($q, $rootScope) {
var deferred = $q.defer();
var promise = deferred.promise;
var resolvedValue;

promise.then(function(value) { resolvedValue = value; });
expect(resolvedValue).toBeUndefined();

// 模拟 promise 的 resolving
deferred.resolve(123);
// 注意 'then' function 不是同步调用的.
// 因为我们需要 promise API 一直是异步的(async),
// 不管是在同步调用还是异步调用中都是如此.
expect(resolvedValue).toBeUndefined();

// 使用 $apply()将 promise resolution 传递到 'then' functions .
$rootScope.$apply();
expect(resolvedValue).toEqual(123);
}));

Dependencies

Methods

递延(Deferred)对象

Deferred

promise

promises链

promise链

promise

deferreds/promises

try/catch/throw

reject

throw

promise

error

"catch"

promise

error

promise

rejection

error

promiseB = promiseA.then(function(result) {
// success: 此处可以执行某些操作,然后直接使用原有的result,
// 或者对result进行操作,来处理接下来的promiseB
return result;
}, function(reason) {
// error: handle the error if possible and
//        resolve promiseB with newPromiseOrValue,
//        否则转向拒绝 promiseB 的分支
if (canHandle(reason)) {
// 处理错误和恢复
return newPromiseOrValue;
}
return $q.reject(reason);
});

promises

promise

promise

promise