上传

qq.uploadFile

UploadTask qq.uploadFile(Object object)

将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求,其中 content-typemultipart/form-data。使用前请注意阅读相关说明

参数

Object object
属性类型默认值必填说明
urlstring开发者服务器地址
filePathstring要上传文件资源的路径
namestring文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容
headerObjectHTTP 请求 Header,Header 中不能设置 Referer
formDataObjectHTTP 请求中其他额外的 form data
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
object.success 回调函数

参数

Object res

属性类型说明
datastring开发者服务器返回的数据
statusCodenumber开发者服务器返回的 HTTP 状态码

返回值

UploadTask

一个可以监听上传进度进度变化的事件和取消上传的对象

示例代码

  1. qq.chooseImage({
  2. success(res) {
  3. const tempFilePaths = res.tempFilePaths
  4. qq.uploadFile({
  5. url: 'https://example.q.qq.com/upload', // 仅为示例,非真实的接口地址
  6. filePath: tempFilePaths[0],
  7. name: 'file',
  8. formData: {
  9. user: 'test'
  10. },
  11. success(res) {
  12. const data = res.data
  13. // do something
  14. }
  15. })
  16. }
  17. })

UploadTask

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

方法

UploadTask.abort()

中断上传任务

UploadTask.onProgressUpdate(function callback)

监听上传进度变化事件

UploadTask.offProgressUpdate(function callback)

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

UploadTask.onHeadersReceived(function callback)

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

UploadTask.offHeadersReceived(function callback)

取消监听 HTTP Response Header 事件

示例代码

  1. const uploadTask = qq.uploadFile({
  2. url: 'https://example.q.qq.com/upload', // 仅为示例,非真实的接口地址
  3. filePath: tempFilePaths[0],
  4. name: 'file',
  5. formData: {
  6. user: 'test'
  7. },
  8. success(res) {
  9. const data = res.data
  10. // do something
  11. }
  12. })
  13. uploadTask.onProgressUpdate((res) => {
  14. console.log('上传进度', res.progress)
  15. console.log('已经上传的数据长度', res.totalBytesSent)
  16. console.log('预期需要上传的数据总长度', res.totalBytesExpectedToSend)
  17. })
  18. uploadTask.abort() // 取消上传任务

.abort

UploadTask.abort()

中断上传任务

.offHeadersReceived

UploadTask.offHeadersReceived(function callback)

取消监听 HTTP Response Header 事件

参数

function callback

HTTP Response Header 事件的回调函数

.offProgressUpdate

UploadTask.offProgressUpdate(function callback)

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

参数

function callback

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

.onHeadersReceived

UploadTask.onHeadersReceived(function callback)

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

参数

function callback

HTTP Response Header 事件的回调函数

参数

Object res

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

.onProgressUpdate

UploadTask.onProgressUpdate(function callback)

监听上传进度变化事件

参数

function callback

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

参数

Object res

属性类型说明
progressnumber上传进度百分比
totalBytesSentnumber已经上传的数据长度,单位 Bytes
totalBytesExpectedToSendnumber预期需要上传的数据总长度,单位 Bytes