mpvue-promise-pro v1.0.2
mpvuePromise
强大的、优雅的 小程序 Promise 库，mpvuePromise 不仅仅把微信小程序所有异步 API promise 化，还把许多优雅的解决方案封装成方法挂载到 mpvue.pro 对象下。所以在 mpvuePromise 中，pro 既有 promise 的含义又有扩展的意思。
使用
普通使用方法
将 mpvuePromise.min.js copy 到 utils 目录中，然后在 app.js 中引入： import './utils/mpvuePromise.min.js'。
本库分为两个部分，一部分是将微信小程序原有的API promise 化，一部分是我自己封装的常用方法。两部分的方法都是挂载在 mpvue.pro 对象下，使用的时候直接使用 mpvue.pro 对象调用即可。
如果想要支持 async 和 await，请仔细阅读 支持 async和await 这一节。
使用NPM
如果你在小程序项目中使用的 NPM 来作为包管理器，或者你使用 mpvue 开发小程序，那么可以直接使用 npm 来安装 mpvue-promise-pro
npm i mpvue-promise-pro然后使用 nodejs（require('mpvue-promise-pro')）或者 ES6 Moudle（import 'mpvue-promise-pro'） 的方式引入。
支持 async、await
由于 mpvuePromise 是直接内置了 regenerator-runtime，所以推荐使用压缩版，体积不到10k
页面引入 regeneratorRuntime: import regeneratorRuntime from '/utils/mpvuePromise.min.js'
注意：导入 regeneratorRuntime 和原本
mpvue.pro对象是不冲突的，你如果用不到 async 函数，那么可以不导入 regeneratorRuntime
点击 查看关于 async 的 demo，或者 点击 学习 async 的语法。
支持所有的微信小程序异步API
使用 mpvuePromise 开发者无需关心兼容与否，只要是 mpvue 支持的 api，mpvue.pro 全部支持。
示例代码：
// 演示 mpvuePromise 的能力
mpvue.showLoading({
title: '加载中',
mask: true
})
mpvue.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(() => {
mpvue.hideLoading()
})扩展的 API
- showTopTips(OBJECT,this)：顶部提示框
- match(type,str)：正则匹配方法
- initChart(option,echarts)：初始化 Echarts 的方法
- lazyInitChart(option,echarts,componentId,that)：echarts 延迟加载模式初始化
- updateChart(chart,option)：echats 没有提供 update 的方法，因此我们利用
clear()和setOption()api 组合实现了这个功能 - saveImageToPhotosAlbum(tempFilePath)：带有授权解决方案的保存图片到系统相册方法
- canvasToTempFilePath(canvasContext)：把当前画布指定区域的内容导出生成指定大小的图片，并返回文件路径
推荐一波
下面是推荐的库，本来是要集成到mpvuePromise的。但是考虑到主题相关性和包体积，我并不打算这么做了！！！
- donghaohao/vuefy
：让小程序支持 watch 和 computed - zhengjunxin/mpvue-queue-request
：控制微信小程序 mpvue.request 并发请求数量 - mengdu/validator.js
：一个简单的 JavaScript data 验证库
License
MIT License
Copyright (c) 2018 youngjuning
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.