wxutil开源工具封装官方API接口,提高小程序开发效率
wxutil
这是一款在公司上班无聊时写的小工具,希望能帮到那些小程序圈内的朋友们,使用该工具能在很大程度上提高开发效率
wxutil工具使用promise语法封装了微信小程序官方的高频API,以及常用的开发方法。项目地址: https://github.com/YYJeffrey/wxutil/
快速上手
方法一:在需要使用的位置引入wxutil(下方示例调用代码均以该方法引入)
[代码]const wxutil = require("../../utils/wxutil.js")
[代码]
方法二:通过导入自己所需模块来引入wxutil
[代码]import { request } from "../../utils/wxutil.js"
[代码]
工具模块
网络请求
文件请求
socket通信
图片操作
提示
showToast
showModal
showLoading
showActionSheet
缓存
setStorage
getStorage
授权
getLocation
getUserInfo
requestPayment
其他工具
网络请求
封装微信小程序wx.request()方法实现五大http请求方法
get
使用promise语法异步获取请求数据或捕获请求异常信息
[代码]const handler = {
url: url,
data: data,
header: header
}
wxutil.request.get(handler).then((data) => {
console.log(data) // 业务处理
}).catch((error) => {
console.log(error) // 异常处理
})
[代码]
亦可用更快速的方法请求
[代码]wxutil.request.get(url).then((data) => {
console.log(data)
})
[代码]
post
[代码]const handler = {
url: url,
data: {},
header: {}
}
wxutil.request.post(handler).then((data) => {
console.log(data)
})
[代码]
亦可用直接传递参数的方式请求
[代码]wxutil.request.post({url: url, data: data}).then((data) => {
console.log(data)
})
[代码]
put
[代码]wxutil.request.put({url: url, data: data}).then((data) => {
console.log(data)
})
[代码]
patch
[代码]wxutil.request.patch({url: url, data: data}).then((data) => {
console.log(data)
})
[代码]
delete
[代码]wxutil.request.delete({url: url, data: data}).then((data) => {
console.log(data)
})
[代码]
文件请求
封装微信小程序wx.downloadFile()和wx.uploadFile()方法
download
[代码]wxutil.file.download({url}).then((data) => {
console.log(data)
})
[代码]
upload
[代码]wxutil.file.upload({
url: url,
fileKey: fileKey,
filePath: filePath,
data: {},
header: {}
}).then((data) => {
console.log(data)
})
[代码]
socket通信
封装微信小程序的websocket部分方法,实现整个socket流程如下
[代码]let socketOpen = false // socket连接标识
wxutil.socket.connect(url)
// 监听socket通信
wx.onSocketMessage((res) => {
console.log(res)
}
wx.onSocketOpen((res) => {
socketOpen = true
if (socketOpen) {
// 发送socket消息
wxutil.socket.send("hello wxutil").then((data) => {
console.log(data)
})
}
// 关闭socket连接
wxutil.socket.close(url)
})
[代码]
图片操作
封装微信小程序的wx.saveImageToPhotosAlbum()、wx.previewImage()、wx.chooseImage()方法,用于保存图片到本机相册、预览图片以及从相机或相册选择图片
save
[代码]wxutil.image.save(path).then((data) => {
console.log(data)
})
[代码]
preview
[代码]wxutil.image.preview(["img/1.png"])
[代码]
choose
参数:count, sourceType
[代码]wxutil.image.choose(1).then((data) => {
console.log(data)
})
[代码]
提示
封装微信小程序的wx.showToast()、wx.showModal()、wx.showLoading()和wx.showActionSheet()方法,用于给用户友好提示
showToast
[代码]wxutil.showToast("hello")
[代码]
showModal
[代码]wxutil.showModal("提示", "这是一个模态弹窗")
[代码]
亦可传入参数并在回调函数中处理自己的业务
[代码]wxutil.showModal(title: title, content: content, handler = {
showCancel: showCancel,
cancelText: cancelText,
confirmText: confirmText,
cancelColor: cancelColor,
confirmColor: confirmColor
}).then((data) => {
console.log(data)
})
[代码]
showLoading
[代码]wxutil.showLoading("加载中")
[代码]
showActionSheet
[代码]wxutil.showActionSheet(['A', 'B', 'C']).then((data) => {
console.log(data)
})
[代码]
缓存
封装微信小程序的wx.setStorageSync()和wx.getStorageSync()方法,异步设置缓存和获取缓存内容,并可以设置缓存过期时间
setStorage
[代码]wxutil.setStorage("userInfo", userInfo)
[代码]
亦可为缓存设置过期时间,单位:秒
[代码]wxutil.setStorage("userInfo", userInfo, 86400)
[代码]
getStorage
[代码]wxutil.getStorage("userInfo")
[代码]
授权
封装了需要用户授权微信小程序的方法
getLocation
获取用户的地理位置
[代码]wxutil.getLocation().then((data) => {
console.log(data)
})
[代码]
亦可通过传入可选参数打开微信小程序的地图
[代码]wxutil.getLocation("gcj02", true).then((data) => {
console.log(data)
})
[代码]
getUserInfo
获取用户信息,可传递两个参数:login和lang,login为true可返回wx.login获取到的code,lang默认为中文,该方法需要使用button触发
[代码]wxutil.getUserInfo().then((data) => {
console.log(data)
})
[代码]
requestPayment
封装了微信小程序的requestPayment方法,需要传递后端的timeStamp、nonceStr、packageValue、paySign这几个参数,加密方式默认为“MD5”
[代码]wxutil.requestPayment({
timeStamp: timeStamp,
nonceStr: nonceStr,
packageValue: packageValue,
paySign: paySign
}).then((data) => {
console.log(data)
})
[代码]
其他工具
封装了常用的微信小程序方法,便于高效开发,也可以增加自己的工具方法在下方
autoUpdate
在app.js中引用该方法,可以在微信小程序发布新版本后自动更新
[代码]wxutil.autoUpdate()
[代码]
isNotNull
判断字符串是否为空、空格回车等,不为空返回true
[代码]wxutil.isNotNull("text")
[代码]
getDateTime
获取当前日期时间,格式:yy-mm-dd hh:MM:ss
[代码]const datetime = wxutil.getDateTime()
console.log(datetime)
[代码]
getTimestamp
获取当前时间戳
[代码]const timestamp = wxutil.getTimestamp()
console.log(timestamp)
[代码]