# wx.request
以 Promise 风格 调用:支持
发起网络请求。每个小程序都需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信。服务器域名请在 「GMU小程序开放平台-小程序开发-版本发布-域名管理」 (opens new window) 中进行配置,配置时需要注意:域名只支持 https 协议。
在页面添加以下代码可以在移动端 vConsole 的 Network 面板查看请求信息,由于在微信开发者工具中无法找到 __base__
对象,您可能需要为以下配置项添加 try...catch 写法方能正常在微信开发者工具中运行项目代码。
try {
__base__.DEBUG_MODE = true;
__base__.DEBUG_SHOW_NETWORK_INFO = true;
} catch(err) {
// ...
}
# 参数
# Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
url | string | 无 | 是 | 开发者服务器接口地址 |
data | string/object | 无 | 否 | 请求的参数 |
header | Object | 无 | 否 | 设置请求的 header,header 中不能设置 Referer。content-type 默认为 application/json。 |
timeout | number | 30000ms | 否 | 超时时间,单位为毫秒 |
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 |
jsonp | 可获取到jsonp格式的数据,无需指定jsonp方法,返回的数据为JSON字符串 |
text | 返回的数据为字符串 |
# 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)
}
})