antbridge

此项目只是本人对 Promises/A+规范 实践，由于我司 native 跟 webview 通信这块正在重构，采用回调方式会引发顺序性、捕获异常难等问题。遂将 AlipayJSBridge 进行 promise 重构试水，然后对公司 jsbridge 进行平缓迁移。

解决的问题：

• 解决调用时序，优化任务队列
• 统一使用异步调用的方式
• 对一些有可能超时 api (network\geolocation) 使用 Promise.race 来处理超时方案
• 编写多任务流时，代码清晰更可控

使用

api 范式跟 支付宝JSAPI 保持一致，所以代码迁移方面只需要关注 Promise/then 范式即可

ant.call('api', opts).then(result => console.log(result))

比如复杂场景: 需要获取地理位置来进行数据不同的展示

ant.geolocation.getCurrentPosition()
.then(function(result) {
  // 正确返回
  // some code: ajax
}, function(result) {
  // 调用超时
})

实现核心

利用 Promise 保证每次调用都是已异步方式进行，让开发者不必关心 AlipayJSBridge 注入时机问题，也不需要关心任务被漏掉等情况

const readyPromise = new Promise(resolve => {
  if (window.AlipayJSBridge && window.AlipayJSBridge.call) {
    resolve()
  } else {
    document.addEventListener('AlipayJSBridgeReady', resolve)
  }
})

关于 Unit Test

方案使用: karma + jasmine + phantomjs 全家桶对方式进行 Unit Test

由于 jasmine 断言环境，不是标准的 Nebula 容器。故测试时不会自动注入 AlipayJSBridge 对象，从而触发 AlipayJSBridgeReady 回调（细节是在 DOMContentLoaded 之后触发）。

那么在运行 Spec 时，我们可以利用 DOM Event(自定义事件) 来初始化

beforeEach(() => {
  var event = new Event('AlipayJSBridgeReady')
  document.dispatchEvent(event)
})

todo

• antLog 实现
• ios delay导致的hideLoading不一定能成功阻止被delay的showLoading的bug

你的 issue 跟 star 是我完善前进的动力 (๑´ڡ`๑)