FengChuanHe / wx-promise-pro

:sparkles:强大、优雅的小程序异步库:rocket: 小程序promise

wx-promise-pro

强大的、优雅的 小程序 Promise 库，wx-promise-pro 不仅仅把微信小程序所有异步 API promise 化，还把许多优雅的解决方案封装成方法挂载到 wx.pro 对象下。所以在 wx-promise-pro 中，pro 既有 promise 的含义又有扩展的意思。

使用

普通使用方法

将 wxPromise.min.js copy 到 utils 目录中，然后在 app.js 中引入： import './utils/wxPromise.min.js'。

本库分为两个部分，一部分是将微信小程序原有的API promise 化，一部分是我自己封装的常用方法。两部分的方法都是挂载在 wx.pro 对象下，使用的时候直接使用 wx.pro 对象调用即可。

如果想要支持 async 和 await，请仔细阅读 支持 async和await 这一节。

使用NPM

如果你在小程序项目中使用的 NPM 来作为包管理器，或者你使用 mpvue 开发小程序，那么可以直接使用 npm 来安装 wx-promise-pro

npm i wx-promise-pro

然后使用 nodejs（require('wx-promise-pro')）或者 ES6 Moudle（import 'wx-promise-pro'） 的方式引入。

支持 async、await

由于 wx-promise-pro 是直接内置了 regenerator-runtime，所以推荐使用压缩版，体积不到10k

页面引入 regeneratorRuntime: import regeneratorRuntime from '/utils/wxPromise.min.js'

注意：导入 regeneratorRuntime 和原本 wx.pro 对象是不冲突的，你如果用不到 async 函数，那么可以不导入 regeneratorRuntime

点击 查看关于 async 的 demo，或者 点击 学习 async 的语法。

支持所有的微信小程序异步API

使用 wxPromise 开发者无需关心兼容与否，只要是 wx 支持的 api，wx.pro 全部支持。

示例代码：

// 演示 wxPromise 的能力
wx.pro.showLoading({
  title: '加载中',
  mask: true
})
wx.pro.request({
  url: 'https://cnodejs.org/api/v1/topics',
  data: {},
  method: 'GET',
  header: {'content-type': 'application/json'}
}).then(res => {
  console.log(res)
}).catch(err => {
  console.log(err)
}).finally(() => {
  wx.hideLoading()
})

推荐一波

下面是推荐的库，本来是要集成到wx-promise-pro的。但是考虑到主题相关性和包体积，我并不打算这么做了！！！

• donghaohao/vuefy ：让小程序支持 watch 和 computed
• zhengjunxin/wx-queue-request ：控制微信小程序 wx.request 并发请求数量
• mengdu/validator.js ：一个简单的 JavaScript data 验证库