UploadTask

title: UploadTask

sidebar_label: UploadTask

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

支持情况：

参考文档

方法

abort

中断上传任务

支持情况：

参考文档

() => void

onProgressUpdate

监听上传进度变化事件

支持情况：

参考文档

(callback: OnProgressUpdateCallback) => void

offProgressUpdate

取消监听上传进度变化事件

支持情况：

参考文档

(callback: OffProgressUpdateCallback) => void

onHeadersReceived

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

支持情况：

参考文档

(callback: OnHeadersReceivedCallback) => void

offHeadersReceived

取消监听 HTTP Response Header 事件

支持情况：

参考文档

(callback: OffHeadersReceivedCallback) => void

参数

OffHeadersReceivedCallback

HTTP Response Header 事件的回调函数

(res: TaroGeneral.CallbackResult) => void

OffProgressUpdateCallback

上传进度变化事件的回调函数

(res: TaroGeneral.CallbackResult) => void

OnHeadersReceivedCallback

HTTP Response Header 事件的回调函数

(result: OnHeadersReceivedCallbackResult) => void

OnProgressUpdateCallback

上传进度变化事件的回调函数

(result: OnProgressUpdateCallbackResult) => void

OnHeadersReceivedCallbackResult

OnProgressUpdateCallbackResult

UploadTaskPromise

示例代码

const uploadTask = Taro.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() // 取消上传任务

API 支持度