jd.request(OBJECT)

发起网络请求。

OBJECT参数说明：

参数名类型必填默认值说明
urlString是开发者服务器接口地址
dataObject/String/ArrayBuffer否请求的参数
headerObject否设置请求的 header，header 中不能设置 Referer。
methodString否GET（需大写）有效值： GET, POST
dataTypeString否json如果设为json，会尝试对返回的数据做一次 JSON.parse
responseTypeString否text设置响应的数据类型。合法值：text、arraybuffer
successFunction否收到开发者服务成功返回的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数类型说明
dataObject/String/ArrayBuffer开发者服务器返回的数据
statusCodeNumber开发者服务器返回的 HTTP 状态码
headerObject开发者服务器返回的 HTTP Response Header

data 数据说明：最终发送给服务器的数据是 String 类型，如果传入的 data 不是 String 类型，会被转换成 String 。转换规则如下：

  • 对于 GET 方法的数据，会将数据转换成 query string（encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)…）
  • 对于 POST 方法且 header['content-type'] 为 application/json 的数据，会对数据进行 JSON 序列化
  • 对于 POST 方法且 header['content-type'] 为 application/x-www-form-urlencoded 的数据，会将数据转换成 query string （encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)…）
示例代码

  1. jd.request({
  2.   url: 'test.php', //仅为示例，并非真实的接口地址
  3.   data: {
  4.      x: '' ,
  5.      y: ''
  6.   },
  7.   header: {
  8.       'content-type': 'application/json' // 默认值
  9.   },
  10.   success: function(res) {
  11.     console.log(res.data)
  12.   }
  13. })

返回值：

返回一个 requestTask 对象，通过 requestTask，可中断请求任务。

requestTask 对象的方法列表：

方法参数说明
abort中断请求任务

示例代码

  1. const requestTask = jd.request({
  2.   url: 'test.php', //仅为示例，并非真实的接口地址
  3.   data: {
  4.      name: 'cortana' ,
  5.      age: '18'
  6.   },
  7.   header: {
  8.       'content-type': 'application/json'
  9.   },
  10.   success: function(res) {
  11.     console.log(res.data)
  12.   }
  13. })
  15. requestTask.abort() // 取消请求任务
Tip

  1. tip: content-type 默认为 'application/json';
  2. 请求 header 说明：请求header 中如果要设置cookie字段，cookie中的中文，需要开发者进行 url encode。