Version: 3.x

UploadTask

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

参考文档

方法#

abort#

中断上传任务

参考文档

() => void

API 支持度#

API	微信小程序	H5	React Native
UploadTask.abort	✔️

offHeadersReceived#

取消监听 HTTP Response Header 事件

参考文档

(callback: OffHeadersReceivedCallback) => void

参数	类型	说明
callback	`OffHeadersReceivedCallback`	HTTP Response Header 事件的回调函数

API 支持度#

API	微信小程序	H5	React Native
UploadTask.offHeadersReceived	✔️

offProgressUpdate#

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

参考文档

(callback: OffProgressUpdateCallback) => void

参数	类型	说明
callback	`OffProgressUpdateCallback`	上传进度变化事件的回调函数

API 支持度#

API	微信小程序	H5	React Native
UploadTask.offProgressUpdate	✔️

onHeadersReceived#

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

参考文档

(callback: OnHeadersReceivedCallback) => void

参数	类型	说明
callback	`OnHeadersReceivedCallback`	HTTP Response Header 事件的回调函数

API 支持度#

API	微信小程序	H5	React Native
UploadTask.onHeadersReceived	✔️

headersReceived#

(callback: OnHeadersReceivedCallback) => void

参数	类型	说明
callback	`OnHeadersReceivedCallback`	HTTP Response Header 事件的回调函数

onProgressUpdate#

监听上传进度变化事件

参考文档

(callback: OnProgressUpdateCallback) => void

参数	类型	说明
callback	`OnProgressUpdateCallback`	上传进度变化事件的回调函数

API 支持度#

API	微信小程序	H5	React Native
UploadTask.onProgressUpdate	✔️

progress#

(callback: OnProgressUpdateCallback) => void

参数	类型	说明
callback	`OnProgressUpdateCallback`	上传进度变化事件的回调函数

参数#

OffHeadersReceivedCallback#

HTTP Response Header 事件的回调函数

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OffProgressUpdateCallback#

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

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OnHeadersReceivedCallback#

HTTP Response Header 事件的回调函数

(result: OnHeadersReceivedCallbackResult) => void

参数	类型
result	`OnHeadersReceivedCallbackResult`

OnProgressUpdateCallback#

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

(result: OnProgressUpdateCallbackResult) => void

参数	类型
result	`OnProgressUpdateCallbackResult`

OnHeadersReceivedCallbackResult#

参数	类型	说明
header	`Record<string, any>`	开发者服务器返回的 HTTP Response Header

OnProgressUpdateCallbackResult#

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

API 支持度#

API	微信小程序	H5	React Native
UploadTask.abort	✔️
UploadTask.offHeadersReceived	✔️
UploadTask.offProgressUpdate	✔️
UploadTask.onHeadersReceived	✔️
UploadTask.onProgressUpdate	✔️