# 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)
  }
})