Question

saber-promise

吾王的移动端的Promise/A+实现，遵循1.1规范

Usage

通过edp引入模块

$ edp import saber-promise

var Resolver = require('saber-promise');

function doSomeThing() {
    var resolver = new Resolver();
    doSync(
        function (result) {
            resolver.fulfill(result);
        },
        function () {
            resolver.reject('connect error');
        }
    );
    return resolver.promise();
}

doSomeThing().then(
    function (result) {
        alert(result);
    },
    function (reason) {
        alert(reason);
    }
);

About Exception

规范要求捕获并处理所有的异常#2.2.7.2，在项目开发中可能会经常遇到非预期的异常被自动处理而导致无从跟踪，这些错误基本都是程序级别的书写错误而非可预期的业务逻辑错误，一般都不会有相应的reject处理。针对这种情况提供了全局事件：reject与resolve来监控处理（需要先调用Resolver.enableGlobalEvent()启用全局事件），更暴力一些还可以在debug过程中使用Resolver.disableExceptionCapture()来直接关闭异常处理，方便查找问题。

警告 异常相关的API都是非标准的，只建议在调试阶段使用，这些API在未来某版本中可能会被废除

API

Resolver 实例

有三种状态：pending、fulfilled、rejected。只能从pending变为fulfilled或者从pending变为rejected，并且状态只能变更一次

创建Resolver实例

var resolver = new Resolver();

resolver.fulfill( data )

将状态由pending变更为fulfilled，并将data作为第一个参数触发所有已注册的onFulfilled回调函数

var resolver = new Resolver();
resolver.fulfill(100);

多次调用处于非pending状态的Resolver实例的fulfill方法是无效的

resolver.resolve( data )

完全等同于 Resolver.fulfill，改个比较通用的名字…(>_<)…

resolver.reject( reason )

将状态由pending变更为rejected，并将reason作为第一个参数触发所有已注册的onRejected回调函数

var resolver = new Resolver();
resolver.reject('找不到对象');

多次调用处于非pending状态的Resolver实例的reject方法是无效的

resolver.promise()

返回对应的Promise对象

Promise 实例

promise.then( onFulfilled, onRejected )

注册fulfilled和rejected状态的回调

• onFulfilled fulfilled状态回调
• onRejected rejected状态回调

返回Promise实例

Resolver

Resolver.promise( fn )

同步创建Promise对象

• fn function(resolver) 处理函数

var promise = Resolver.promise(function (resolver) {
        setTimeout(function () {
            resolver.resolve();
        }, 0);
    });

promise.then(function () {
    ...
});

Resolver.fulfilled( data )

创建已经处于fulfilled状态的Promise对象

• data *

Resolver.resolved( data )

与.fulfilled() 完全相同

Resolver.rejected( reason )

创建已经处于rejected状态的Promise对象

• reason *

Resolver.all( promises )

关联多个promise对象，返回的promise在所有Promise对象参数都fulfilled时达到fulfilled状态，如果参数中的有任意promise对象rejected则立即达到rejected状态

• promises Array.<promise> | ...promise 可以是数组参数或者多个promise对象

Resolver.enableGlobalEvent( Emitter )

非标准API 启动全局事件

• Emitter {Object} 事件发射器

全局事件是默认关闭的，saber-promise不强依赖于saber-emitter或者任何事件发射器，所以在开启全局事件时需要传入一个事件发射器来启用自定义事件，建议使用saber-emitter，如下：

var Emitter = require('saber-emitter');
Resolver.enableGlobalEvent(Emitter);

// resolved事件
Resolver.on('resolve', function (data) {
    ...
});

// rejected事件
Resolver.on('reject', function (reason) {
    ...
});

Resolver.disableExceptionCapture()

非标准API 禁用异常处理，默认时启动的。如果全局事件都不想监控了，用这个可以直接关闭异常处理，方便调试，简单粗暴～

Resolver.enableExceptionCapture()

非标准API 启用异常处理

Test

使用Promises/A+规范的Test Suite

$ npm install
$ npm test

===