上传

qh.uploadFile()

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

  1. qh.uploadFile(opts)

参数值:

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

返回值:

Object 类型的对象:

属性类型描述
UploadTaskObjectUploadTask 实例对象

success 回调函数:

形如 function (res) {…},其中:

属性类型描述
res.datastring开发者服务器返回的数据
res.statusCodenumber开发者服务器返回的 HTTP 状态码

UploadTask

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

UploadTask.abort

中断上传任务。

UploadTask.onProgressUpdate

监听上传进度变化事件。

  1. UploadTask.onProgressUpdate(callback)

UploadTask.offProgressUpdate

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

  1. UploadTask.offProgressUpdate()

示例:

  1. qh.chooseImage({
  2. success (res) {
  3. const tempFilePaths = res.tempFilePaths
  4. qh.uploadFile({
  5. url: 'https://example.qihoo.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. })