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>