4.3.1. 上传

wx.cloud.uploadFile({cloudPath, filePath[, header][, success][, complete][, success]})

将本地资源上传至云存储空间,如果上传至同一路径则是覆盖写

参数
  • cloudPath (string) – 云存储路径

  • filePath (string) – 要上传文件资源的路径

  • header (object) – HTTP 请求 Header, header 中不能设置 Referer

  • success(fileID, statusCode) (function) –

    成功回调

    • fileID (string) - 文件ID

    • statusCode (number) - 服务器返回的 HTTP 状态码

  • fail(errCode, errMsg) (function) –

    失败回调

    • errCode (number) - 错误码

    • errMsg (string) - 错误信息,格式 apiName:fail msg

  • complete (function) – 结束回调

返回类型

UploadTask

返回

如果请求参数中带有 success/fail/complete 回调中的任一个,则会返回一个 UploadTask 对象,通过 UploadTask 对象可监听上传进度变化事件,以及取消上传任务。

例(Callback)
wx.cloud.uploadFile({
  cloudPath: 'example.png',
  filePath: '', // 文件路径
  success: res => {
    // get resource ID
    console.log(res.fileID)
  },
  fail: err => {
    // handle error
  }
})
例(Promise)
wx.cloud.uploadFile({
  cloudPath: 'example.png',
  filePath: '', // 文件路径
}).then(res => {
  // get resource ID
  console.log(res.fileID)
}).catch(error => {
  // handle error
})