《微信小程序开发从入门到实战》学习六十八

6.6?网络API

6.6.1?网络API

使用wx.request接口可以发起网络请求。该接口接受一个Object参，参数支持属性如下所示：

url(必填)：开发者服务器地址

data：请求的参数，类型为string/object/ArrayBuffer

header：设置请求的header。header不能设置Referer。

method：HTTP请求方法，支持OPTIONS/GET(默认值)/HEAD/POST/PUT/DELETE/TRACE/CONNECT

dataType：返回的数据格式，如设置为json,会对返回数据进行一次JSON.parse解析

responseType：响应的数据类型，支持text和Arraybuffer

success

fail

complete

data属性是最终发送给服务器的数据，如果传入的数据不是string类型，会先被转换为string类型，然后再发送。转换规则如下：

（1）.对于GET方法，会将数据转换成query string

url?encodeURIComponent(key1)=encodeURIComponent(value1)&encodeURIComponent(key2)=encodeURIComponent(value2)...

（2）.对于POST方法，当header['content-type']为application/x-www-form-urlencoded的数据，会将数据转换成query string

? 当header['content-type']为application/json的数据，会对数据进行JSON序列化

????????调用网络请求API，只要成功接收到服务器返回，就会进入success回调。success回调的Object参数支持三属性，data、statusCode和header。statucCode正常情况下该值为200，header为服务器返回的HTTP报文的头部。

? ? ? ? 网络请求API会返回一个RequestTask对象，可以通过该对象，监听服务断返回Header的事件（比请求完成的回调事件更早），或中断网络请求，示例代码如下：

const?requestTask?=?wx.request({

??????url:?'https://somewebsite.com/test',?//?仅为示例，并非真实的接口地址

??????data:?{

????????x:?'123',

????????y:?true

??????},

??????header:?{

????????'content-type':?'application/json'?//默认值

??????},

??????success(res){

????????if?(res.statusCode?===?200)?{

??????????console.log(res.data)

????????}

??????}

????})

????//监听HTTP?Response?Header事件

????requestTask.onHeadersReceived(function(res){

??????console.log(res.header)?//?服务器返回的?HTTP?Response?Header，类型为Object

????})

????//?取消监听?HTTP?Response?Header?事件

????requestTask.offHeadersReceived()

????//?取消请求任务?

????requestTask.abort()