wx.request · 微信小游戲開發API官方文檔

# wx.request ### RequestTask wx.request(Object object) 發起 HTTPS 網絡請求。使用前請注意閱讀[相關說明](https://developers.weixin.qq.com/minigame/dev/tutorial/ability/network.html)。 #### 參數 ##### Object object 屬性類型默認值是否必填說明支持版本urlstring是開發者服務器接口地址datastring/object/ArrayBuffer否請求的參數headerObject否設置請求的 header，header 中不能設置 Referer。`content-type` 默認為 `application/json`methodstringGET否HTTP 請求方法dataTypestringjson否返回的數據格式responseTypestringtext否響應的數據類型>= 1.7.0successfunction否接口調用成功的回調函數failfunction否接口調用失敗的回調函數completefunction否接口調用結束的回調函數（調用成功、失敗都會執行）**object.method 的合法值** 值說明OPTIONSHTTP 請求 OPTIONSGETHTTP 請求 GETHEADHTTP 請求 HEADPOSTHTTP 請求 POSTPUTHTTP 請求 PUTDELETEHTTP 請求 DELETETRACEHTTP 請求 TRACECONNECTHTTP 請求 CONNECT**object.dataType 的合法值** 值說明json返回的數據為 JSON，返回后會對返回的數據進行一次 JSON.parse其他不對返回的內容進行 JSON.parse**object.responseType 的合法值** 值說明text響應的數據為文本arraybuffer響應的數據為 ArrayBuffer###### object.success 回調函數 **參數** **Object res** 屬性類型說明支持版本datastring/Object/Arraybuffer開發者服務器返回的數據statusCodenumber開發者服務器返回的 HTTP 狀態碼headerObject開發者服務器返回的 HTTP Response Header>= 1.2.0#### 返回值 ##### RequestTask > 支持版本 >= 1.4.0 請求任務對象 #### data 參數說明最終發送給服務器的數據是 String 類型，如果傳入的 data 不是 String 類型，會被轉換成 String 。轉換規則如下： - 對于 GET 方法的數據，會將數據轉換成 query string（encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)…） - 對于 POST 方法且 header\['content-type'\] 為 application/json 的數據，會對數據進行 JSON 序列化 - 對于 POST 方法且 header\['content-type'\] 為 application/x-www-form-urlencoded 的數據，會將數據轉換成 query string （encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)…）#### 示例代碼 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">wx.request({</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> url: 'test.php', //僅為示例，并非真實的接口地址</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> data: {</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> x: '',</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> y: ''</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> },</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> header: {</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> 'content-type': 'application/json' // 默認值</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> },</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> success (res) {</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> console.log(res.data)</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> }</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">})</code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/network/request/wx.request.html>