小程序文件上传wx.uploadFile

UploadTask wx.uploadFile(Object object)

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

参数

Object object

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

object.success 回调函数

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

返回值

UploadTask

基础库 1.4.0 开始支持,低版本需做兼容处理。

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

示例代码

wx.chooseImage({
  success (res) {
    const tempFilePaths = res.tempFilePaths
    wx.uploadFile({
      url: 'https://example.weixin.qq.com/upload', //仅为示例,非真实的接口地址
      filePath: tempFilePaths[0],
      name: 'file',
      formData: {
        'user': 'test'
      },
      success (res){
        const data = res.data
        //do something
      }
    })
  }
})

分类小程序网络请求相关推荐:

小程序网路请求wx.request 小程序网络请求任务对象RequestTask 小程序中断请求任务RequestTask.abort() 小程序取消监听 Transfer-Encoding Chunk Received 事件 小程序取消监听 HTTP Response Header 事件offHeadersReceived 小程序网络监听RequestTask.onChunkReceived 小程序网络监听头RequestTask.onHeadersReceived 小程序文件下载wx.downloadFile 小程序下载任务的对象DownloadTask 小程序中断下载任务DownloadTask.abort() 小程序下载取消头部监听offHeadersReceived 小程序取消下载进度监听offProgressUpdate 小程序下载头部监听onHeadersReceived 小程序下载监听下载进度onProgressUpdate 小程序文件上传wx.uploadFile 小程序上传任务对象UploadTask 小程序中断上传任务UploadTask.abort() 小程序取消监听响应头 小程序取消监听头部进度offProgressUpdate 小程序文件上传监听头部事件onHeadersReceived 小程序监听上传进度变化事件onProgressUpdate