wx.request(Object object)

发起网络请求。每个小程序都需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信。服务器域名请在 「GMU小程序开放平台-小程序开发-版本发布-域名管理」 中进行配置,配置时需要注意:域名只支持 https 协议。

在页面添加以下代码可以在移动端 vConsole 的 Network 面板查看请求信息,如果你是在桌面版开发工具中查看效果,请忽略。

__base__.DEBUG_MODE = true;
__base__.DEBUG_SHOW_NETWORK_INFO = true;

参数

Object object

属性 类型 默认值 必填 说明
url string 无 是 开发者服务器接口地址
data string/object 无 否 请求的参数
header Object 无 否 设置请求的 header,header 中不能设置 Referer。content-type 默认为 application/json。
timeout number 无 否 超时时间,单位为毫秒
method string GET 否 HTTP 请求方法
dataType string json 否 返回的数据格式
success function 无 否 接口调用成功的回调函数
fail function 无 否 接口调用失败的回调函数
complete function 无 否 接口调用结束的回调函数(调用成功、失败都会执行)

object.method 的合法值

值 说明
GET HTTP 请求 GET
POST HTTP 请求 POST

object.dataType 的合法值

值 说明
json 返回的数据为 JSON,返回后会对返回的数据进行一次 JSON.parse
其他 不对返回的内容进行 JSON.parse

object.success 回调函数

参数

Object res

属性 类型 说明
data string/Object 开发者服务器返回的数据
statusCode number 开发者服务器返回的 HTTP 状态码
header Object 开发者服务器返回的 HTTP Response Header

示例代码

wx.request({
url: 'test.php', //仅为示例,并非真实的接口地址
data: {
x: '',
y: ''
},
header: {
'content-type': 'application/json' // 默认值
},
success (res) {
console.log(res.data)
}
})

多平台支持

属性 平台支持
title 支付宝
data 支付宝
header 支付宝
timeout 支付宝
method 支付宝
dataType 支付宝
success 支付宝
fail 支付宝
complete 支付宝