saber-promise
吾王的移动端的 Promise/A+ 实现,兼容 node 环境,遵循 1.1 规范
Installation
移动端环境下通过 edp 引入模块:
$ edp import saber-promise
node 环境下通过 npm
引入模块:
$ npm install saber-promise --save
Usage
var Resolver = ; { var resolver = ; // 做一些异步操作 ; // 返回Promise对象 return resolver;} // 对异步结果进行处理 // 不管成功还是失败都提示操作成功 ;
About Exception
规范要求捕获并处理所有的异常(#2.2.7.2),在项目开发中可能会经常遇到非预期的异常被自动处理而导致无从跟踪,这些错误基本都是程序级别的书写错误而非可预期的业务逻辑错误,一般都不会有相应的 reject
处理。针对这种情况提供了全局事件:reject
与 resolve
来监控处理(需要先调用 Resolver.enableGlobalEvent() 启用全局事件),更暴力一些还可以在 开发环境 中使用 Resolver.disableExceptionCapture()
来直接关闭异常处理,方便查找问题。
警告 异常相关的 API 都是非标准的,只建议在调试阶段使用,这些 API 在未来某版本中可能会被废除
API
Methods
promise(fn)
创建Promise
对象
var promise = Resolver; promise;
fulfilled(data)
创建已经处于 fulfilled
状态的 Promise 对象
- data
{*}
数据 - return
{Promise}
Promise 对象
resolved(data)
创建已经处于 fulfilled
状态的 Promise 对象,与 fulfilled 完全相同,别名而已...
- data
{*}
数据 - return
{Promise}
Promise 对象
rejected(reason)
创建已经处于 rejected
状态的 Promise 对象
- reason
{*}
失败原因 - return
{Promise}
Promise 对象
all(promises)
关联多个 Promise 对象并返回一个新的 Promise
对象,返回的 Promise
在所有被关联的 Promise
对象都 fulfilled
时达到 fulfilled
状态,如果有任意 promise
对象 rejected
则立即达到 rejected
状态
- promises
{Array.<promise>|...promise}
待关联的Promise
对象,可以是数组参数或者多个Promise
对象 - return
{Promise}
Promise 对象
race(promises)
关联多个 Promise 对象并返回一个新的 Promise
对象,关联的 Promise
对象中有任意一个 Promise
被解决(fulfilled
)或拒绝(rejected
)后,新返回的 Promise
对象立刻以相同的解决值被解决或以相同的拒绝原因被拒绝。
- promises
{Array.<promise>|...promise}
待关联的Promise
对象,可以是数组参数或者多个Promise
对象 - return
{Promise}
Promise 对象
enableGlobalEvent(Emitter)
非标准API 启动全局事件
- Emitter
{Object}
事件发射器
全局事件是默认关闭的,saber-promise
不强依赖于 saber-emitter 或者任何其它事件发射器,所以在开启全局事件时需要传入一个事件发射器来启用自定义事件,建议使用 saber-emitter,如下:
var Emitter = ;Resolver; // resolved事件Resolver; // rejected事件Resolver;
disableExceptionCapture()
非标准 API
禁用异常处理,默认时启动的。如果全局事件都不想监控了,用这个可以直接关闭异常处理,方便调试,简单粗暴~
enableExceptionCapture()
非标准 API
启用异常处理
Events
注册任何全局事件前需要先启用全局事件,具体请参考 enableGlobalEvent(Emitter)
resolve
resolved事件 任何 Resolver 对象处于 fulfilled
时触发
- data
{*}
数据
reject
rejected事件 任何 Resolver 对象处于 rejected
时触发
- reason
{*}
失败原因
Classes
Test
使用Promises/A+规范的 Test Suite
$ npm install
$ npm test
基本性能测试请参考这里