基础信息说明

功能概述：将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求，其中 Content-Type 为 multipart/form-data，并返回一个可监听上传进度、可中断的上传任务对象 UploadTask。

方法说明

qg.uploadFile 返回的 UploadTask支持以下方法：

参数说明

qg.uploadFile(Object object): UploadTask

success 回调函数的参数 Object res

UploadTask.onProgressUpdate(Function callback)

回调函数 callback(Object res)

UploadTask.offProgressUpdate(Function callback)

UploadTask.onHeadersReceived(Function callback)

回调函数 callback(Object res)

UploadTask.offHeadersReceived(Function callback)

返回值说明

qg.uploadFile(Object option): UploadTask：同步返回上传任务对象 UploadTask，不会通过返回值直接给出上传结果，结果需依赖：

• option.success / option.fail / option.complete 回调
• 或 UploadTask 上注册的事件监听（onProgressUpdate / onHeadersReceived）

回调结果说明

qg.uploadFile 的参数中定义的success回调函数具有参数 Object res属性如下：

UploadTask.onProgressUpdate的回调函数具有参数 Object res属性如下：

UploadTask.onHeadersReceived的回调函数具有参数 Object header说明如下：

示例代码

const uploadTask = qg.uploadFile({
  url: '',
  filePath:'',
  name:'test',
  success: function (res) {
    console.log('uploadTask success::', res)
  },
  fail: function () {
    console.log('uploadTask fail')
  },
  complete: function () {
    console.log('uploadTask complete')
  }
});

uploadTask.onProgressUpdate(function (res) {
  console.log('uploadTask::onProgressUpdate', res)
});

function handleProgressUpdate(res) {
  console.log('uploadTask::current progress:', res.progress)
}

uploadTask.onProgressUpdate(handleProgressUpdate);
uploadTask.offProgressUpdate(handleProgressUpdate);

function handleHeadersReceived(res) {
  console.log('uploadTask::Response Headers:', res.header);
}

uploadTask.onHeadersReceived(handleHeadersReceived);
uploadTask.offHeadersReceived(handleHeadersReceived);

uploadTask.abort();

注意事项

• Header 中禁止设置 Referer 字段，否则请求可能被宿主或服务器拒绝