微信小程序 5 网络api

wx.request   发起网络请求

wx.request({  url: 'test.php', //仅为示例，并非真实的接口地址  data: {     x: '' ,     y: ''  },  header: {      'content-type': 'application/json' // 默认值  },  success: function(res) {    console.log(res.data)  }})

data  最后一定是字符串的形式

header 请求头

success 成功后执行的回调函数

返回一个 requestTask 对象，通过 requestTask，可中断请求任务。

onst requestTask = wx.request({  url: 'test.php', //仅为示例，并非真实的接口地址  data: {     x: '' ,     y: ''  },  header: {      'content-type': 'application/json'  },  success: function(res) {    console.log(res.data)  }})requestTask.abort() // 取消请求任务

上传

wx.uploadFile

wx.chooseImage({  success: function(res) {    var tempFilePaths = res.tempFilePaths    wx.uploadFile({      url: 'https://example.weixin.qq.com/upload', //仅为示例，非真实的接口地址      filePath: tempFilePaths[0],      name: 'file',      formData:{        'user': 'test'      },      success: function(res){        var data = res.data        //do something      }    })  }})

file.path 上传路径

返回一个 uploadTask 对象，通过 uploadTask，可监听上传进度变化事件，以及取消上传任务。

const uploadTask = wx.uploadFile({    url: 'http://example.weixin.qq.com/upload', //仅为示例，非真实的接口地址    filePath: tempFilePaths[0],    name: 'file',    formData:{        'user': 'test'    },    success: function(res){        var data = res.data        //do something    }})uploadTask.onProgressUpdate((res) => {    console.log('上传进度', res.progress)    console.log('已经上传的数据长度', res.totalBytesSent)    console.log('预期需要上传的数据总长度', res.totalBytesExpectedToSend)})uploadTask.abort() // 取消上传任务

progress 上传进度百分比

totalBytesSent  上传的数据长度 单位为bytes

totalBytesExpectedToSend  预计要上传的数据长度 单位同上

uploadTask 对象的方法列表：

方法参数说明最低版本onProgressUpdatecallback监听上传进度变化1.4.0abort 中断上传任务1.4.0

.

wx.downloadFile下载文件到本地

wx.downloadFile({  url: 'https://example.com/audio/123', //仅为示例，并非真实的资源  success: function(res) {    wx.playVoice({      filePath: res.tempFilePath    })  }})

url 下载资源的地址

返回一个 downloadTask 对象，通过 downloadTask，可监听下载进度变化事件，以及取消下载任务。

const downloadTask = wx.downloadFile({    url: 'http://example.com/audio/123', //仅为示例，并非真实的资源    success: function(res) {        wx.playVoice({            filePath: res.tempFilePath        })    }})downloadTask.onProgressUpdate((res) => {    console.log('下载进度', res.progress)    console.log('已经下载的数据长度', res.totalBytesWritten)    console.log('预期需要下载的数据总长度', res.totalBytesExpectedToWrite)})downloadTask.abort() // 取消下载任务

属性同上传

websocket

网络上的两个程序通过一个双向的通信连接实现数据的交换，这个连接的一端称为一个socket。

一个微信小程序同时只能有一个 WebSocket 连接，如果当前已存在一个 WebSocket 连接，会自动关闭该连接，并重新创建一个 WebSocket 连接。

wx.connectSocket 创建一个socket连接

wx.connectSocket({  url: 'test.php',  data:{    x: '',    y: ''  },  header:{     'content-type': 'application/json'  },  protocols: ['protocol1'],  method:"GET"})

url 开发者服务器接口地址，必须是 wss 协议，且域名必须是后台配置的合法域名

header 请求头

protocols  子协议数组

method  get请求

wx.onSocketOpen

监听WebSocket连接打开事件。

wx.connectSocket({  url: 'test.php'})wx.onSocketOpen(function(res) {  console.log('WebSocket连接已打开！')})

wx.onSocketError

监听WebSocket错误。

wx.connectSocket({  url: 'test.php'})wx.onSocketOpen(function(res){  console.log('WebSocket连接已打开！')})wx.onSocketError(function(res){  console.log('WebSocket连接打开失败，请检查！')})

wx.sendSocketMessage

通过 WebSocket 连接发送数据，需要先 wx.connectSocket，并在 wx.onSocketOpen 回调之后才能发送。

var socketOpen = falsevar socketMsgQueue = []wx.connectSocket({  url: 'test.php'})wx.onSocketOpen(function(res) {  socketOpen = true  for (var i = 0; i < socketMsgQueue.length; i++){     sendSocketMessage(socketMsgQueue[i])  }  socketMsgQueue = []})function sendSocketMessage(msg) {  if (socketOpen) {    wx.sendSocketMessage({      data:msg    })  } else {     socketMsgQueue.push(msg)  }}

wx.onSocketMessage

wx.connectSocket({  url: 'test.php'})wx.onSocketMessage(function(res) {  console.log('收到服务器内容：' + res.data)})

wx.closeSocket

wx.onSocketClose

监听WebSocket关闭

wx.connectSocket({  url: 'test.php'})//注意这里有时序问题，//如果 wx.connectSocket 还没回调 wx.onSocketOpen，而先调用 wx.closeSocket，那么就做不到关闭 WebSocket 的目的。//必须在 WebSocket 打开期间调用 wx.closeSocket 才能关闭。wx.onSocketOpen(function() {  wx.closeSocket()})wx.onSocketClose(function(res) {  console.log('WebSocket 已关闭！')})