# wx.uploadFile ### UploadTask wx.uploadFile(Object object) 將本地資源上傳到開發者服務器，客戶端發起一個 HTTPS POST 請求，其中 `content-type` 為 `multipart/form-data`。使用前請注意閱讀[相關說明](https://developers.weixin.qq.com/minigame/dev/tutorial/ability/network.html)。 #### 參數 ##### Object object 屬性類型默認值是否必填說明支持版本urlstring是開發者服務器地址filePathstring是要上傳文件資源的路徑namestring是文件對應的 key，開發者在服務端可以通過這個 key 獲取文件的二進制內容headerObject否HTTP 請求 Header，Header 中不能設置 RefererformDataObject否HTTP 請求中其他額外的 form datasuccessfunction否接口調用成功的回調函數failfunction否接口調用失敗的回調函數completefunction否接口調用結束的回調函數（調用成功、失敗都會執行）###### object.success 回調函數 **參數** **Object res** 屬性類型說明支持版本datastring開發者服務器返回的數據statusCodenumber開發者服務器返回的 HTTP 狀態碼#### 返回值 ##### UploadTask > 支持版本 >= 1.4.0 一個可以監聽上傳進度進度變化的事件和取消上傳的對象 #### 示例代碼 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">wx</span><span class="pun">.</span><span class="pln">chooseImage</span><span class="pun">({</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> success </span><span class="pun">(</span><span class="pln">res</span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="kwd">const</span><span class="pln"> tempFilePaths </span><span class="pun">=</span><span class="pln"> res</span><span class="pun">.</span><span class="pln">tempFilePaths</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> wx</span><span class="pun">.</span><span class="pln">uploadFile</span><span class="pun">({</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> url</span><span class="pun">:</span><span class="pln"> </span><span class="str">'https://example.weixin.qq.com/upload'</span><span class="pun">,</span><span class="pln"> </span><span class="com">//僅為示例，非真實的接口地址</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> filePath</span><span class="pun">:</span><span class="pln"> tempFilePaths</span><span class="pun">[</span><span class="lit">0</span><span class="pun">],</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> name</span><span class="pun">:</span><span class="pln"> </span><span class="str">'file'</span><span class="pun">,</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> formData</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">'user'</span><span class="pun">:</span><span class="pln"> </span><span class="str">'test'</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">},</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> success </span><span class="pun">(</span><span class="pln">res</span><span class="pun">){</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="kwd">const</span><span class="pln"> data </span><span class="pun">=</span><span class="pln"> res</span><span class="pun">.</span><span class="pln">data</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="com">//do something</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">}</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">})</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">}</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">})</span></code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/network/upload/wx.uploadFile.html>