wx.uploadFile(OBJECT)

將本地資源上傳到開發者服務器。如頁面通過 wx.chooseImage 等接口獲取到一個本地資源的臨時文件路徑后，可通過此接口將本地資源上傳到指定服務器。客戶端發起一個HTTPS POST請求，其中Content-Type為multipart/form-data。

OBJECT參數說明：

success返回參數說明：

示例代碼：

wx.chooseImage({
  success:function(res){
    var tempFilePaths = res.tempFilePaths
    wx.uploadFile({
      url: 'http://example.weixin.qq.com/upload', //僅為示例，非真實的接口地址
      filePath: tempFilePaths[0],
      name:"file",
      formData:{
        "user":"test"
      }      success: function(res){        var data = res.data        //do something      }
    })
  }
})

返回值：

基礎庫 1.4.0 開始支持，低版本需做兼容處理

返回一個uploadTask對象，通過uploadTask，可監聽上傳進度變化事件，以及取消上傳任務。

uploadTask

uploadTask 對象的方法列表：

onProgressUpdate 返回參數說明：

示例代碼：

const uploadTask = wx.uploadFile({
    url: 'http://example.weixin.qq.com/upload', //僅為示例，非真實的接口地址
    filePath: tempFilePaths[0],
    name: 'file',
    formData:{
        'user': 'test'
    },
    success: function(res){
        var data = res.data
        //do something
    }
})

uploadTask.onProgressUpdate((res) => {
    console.log('上傳進度', res.progress)
    console.log('已經上傳的數據長度', res.totalBytesSent)
    console.log('預期需要上傳的數據總長度', res.totalBytesExpectedToSend)
})

uploadTask.abort() // 取消上傳任務

Bug & Tip

1. tip: 最大并發限制是 10 個
2. tip: 默認超時時間和最大超時時間都是 60s

wx.downloadFile(OBJECT)

下載文件資源到本地。客戶端直接發起一個HTTP GET請求，返回文件的本地臨時路徑。

OBJECT參數說明：

注：文件的臨時路徑，在小程序本次啟動期間可以正常使用，如需持久保存，需在主動調用 wx.saveFile，在小程序下次啟動時才能訪問得到。

示例代碼:

wx.downloadFile({
  url: 'http://example.com/audio/123', //僅為示例，并非真實的資源
  success: function(res) {
    wx.playVoice({
      filePath: res.tempFilePath
    })
  }
})

返回值：

基礎庫 1.4.0 開始支持，低版本需做兼容處理

返回一個downloadTask對象，通過downloadTask，可監聽下載進度變化事件，以及取消下載任務。

downloadTask

downloadTask 對象的方法列表：

onProgressUpdate 返回參數說明：

示例代碼：

const downloadTask = wx.downloadFile({
    url: 'http://example.com/audio/123', //僅為示例，并非真實的資源
    success: function(res) {
        wx.playVoice({
            filePath: res.tempFilePath
        })
    }
})

downloadTask.onProgressUpdate((res) => {
    console.log('下載進度', res.progress)
    console.log('已經下載的數據長度', res.totalBytesWritten)
    console.log('預期需要下載的數據總長度', res.totalBytesExpectedToWrite)
})

downloadTask.abort() // 取消下載任務

Bug & Tip

1. tip: 最大并發限制是 10 個
2. tip: 默認超時時間和最大超時時間都是 60s
3. tip: 網絡請求的 referer 是不可以設置的，格式固定為 https://servicewechat.com/{appid}/{version}/page-frame.html，其中{appid}為小程序的 appid，{version}為小程序的版本號，版本號為 0 表示為開發版。
4. tip: 6.5.3 以及之前版本的 iOS 微信客戶端header設置無效