分类： UploadTask

UploadTask.onProgressUpdate(function listener)

基础库 1.4.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

相关文档: 网络使用说明、局域网通信

功能描述

监听上传进度变化事件

参数

function listener

上传进度变化事件的监听函数

参数

Object res
属性 类型 说明
progress number 上传进度百分比
totalBytesSent number 已经上传的数据长度，单位 Bytes
totalBytesExpectedToSend number 预期需要上传的数据总长度，单位 Bytes

UploadTask.onHeadersReceived(function listener)

基础库 2.1.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

相关文档: 网络使用说明、局域网通信

功能描述

监听 HTTP Response Header 事件。会比请求完成事件更早

参数

function listener

HTTP Response Header 事件的监听函数

参数

Object res
属性 类型 说明
header Object 开发者服务器返回的 HTTP Response Header

UploadTask.offProgressUpdate(function listener)

基础库 2.1.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

相关文档: 网络使用说明、局域网通信

功能描述

移除上传进度变化事件的监听函数

参数

function listener

onProgressUpdate 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

UploadTask.onProgressUpdate(listener)
UploadTask.offProgressUpdate(listener) // 需传入与监听时同一个的函数对象

UploadTask.offHeadersReceived(function listener)

基础库 2.1.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

相关文档: 网络使用说明、局域网通信

功能描述

移除 HTTP Response Header 事件的监听函数

参数

function listener

onHeadersReceived 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

UploadTask.onHeadersReceived(listener)
UploadTask.offHeadersReceived(listener) // 需传入与监听时同一个的函数对象

UploadTask

基础库 1.4.0 开始支持，低版本需做兼容处理。

相关文档: 网络使用说明、局域网通信

一个可以监听上传进度变化事件，以及取消上传任务的对象

方法

UploadTask.abort()

中断上传任务

UploadTask.onProgressUpdate(function listener)

监听上传进度变化事件

UploadTask.offProgressUpdate(function listener)

移除上传进度变化事件的监听函数

UploadTask.onHeadersReceived(function listener)

监听 HTTP Response Header 事件。会比请求完成事件更早

UploadTask.offHeadersReceived(function listener)

移除 HTTP Response Header 事件的监听函数

示例代码

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

uploadTask.onProgressUpdate((res) => {
  console.log('上传进度', res.progress)
  console.log('已经上传的数据长度', res.totalBytesSent)
  console.log('预期需要上传的数据总长度', res.totalBytesExpectedToSend)
})

uploadTask.abort() // 取消上传任务