wx.cloud.uploadFile

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

请求参数

字段 说明 数据类型 默认值 必填
cloudPath 云存储路径 String - Y
filePath 要上传文件资源的路径 String - Y
header HTTP 请求 Header, header 中不能设置 Referer Object - N
success 成功回调
fail 失败回调
complete 结束回调

success 返回参数

字段 说明 数据类型
fileID 文件 ID String
statusCode 服务器返回的 HTTP 状态码 Number

fail 返回参数

字段 说明 数据类型
errCode 错误码 Number
errMsg 错误信息，格式 apiName:fail msg String

返回值

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

uploadTask 对象的方法列表：

方法 参数 说明
onProgressUpdate callback onProgressUpdate
abort 中断上传任务

onProgressUpdate 返回参数说明：

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

使用示例

Callback 风格

  1. wx.cloud.uploadFile({
  2.   cloudPath: '/example.png',
  3.   filePath: '', // 小程序临时文件路径
  4.   success: res => {
  5.     // get resource ID
  6.     console.log(res.fileID)
  7.   },
  8.   fail: err => {
  9.     // handle error
  10.   }
  11. })

Promise 风格

  1. wx.cloud.uploadFile({
  2.   cloudPath: '/example.png',
  3.   filePath: '', // 小程序临时文件路径
  4. }).then(res => {
  5.   // get resource ID
  6.   console.log(res.fileID)
  7. }).catch(error => {
  8.   // handle error
  9. })

原文: https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-client-api/storage/uploadFile.html