以 Promise 风格 调用:支持
发起网络请求。每个小程序都需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信。服务器域名请在 「GMU小程序开放平台-小程序开发-版本发布-域名管理」 中进行配置,配置时需要注意:域名只支持 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) } })
|
多平台支持
属性 |
平台支持 |
title |
支付宝 |
data |
支付宝 |
header |
支付宝 |
timeout |
支付宝 |
method |
支付宝 |
dataType |
支付宝 |
success |
支付宝 |
fail |
支付宝 |
complete |
支付宝 |