微信小程序API 發(fā)起請求

RequestTask wx.request(Object object)

發(fā)起 HTTPS 網(wǎng)絡(luò)請求。使用前請注意閱讀相關(guān)說明。

參數(shù)

Object object

object.method 的合法值

object.dataType 的合法值

object.responseType 的合法值

object.success 回調(diào)函數(shù)

參數(shù)

Object res

res.profile 的結(jié)構(gòu)

返回值

RequestTask

基礎(chǔ)庫 1.4.0 開始支持，低版本需做兼容處理。

請求任務(wù)對象

data 參數(shù)說明

最終發(fā)送給服務(wù)器的數(shù)據(jù)是 String 類型，如果傳入的 data 不是 String 類型，會被轉(zhuǎn)換成 String 。轉(zhuǎn)換規(guī)則如下：

• 對于 GET 方法的數(shù)據(jù)，會將數(shù)據(jù)轉(zhuǎn)換成 query string（encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...）
• 對于 POST 方法且 header['content-type'] 為 application/json 的數(shù)據(jù)，會對數(shù)據(jù)進行 JSON 序列化
• 對于 POST 方法且 header['content-type'] 為 application/x-www-form-urlencoded 的數(shù)據(jù)，會將數(shù)據(jù)轉(zhuǎn)換成 query string （encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...）

示例代碼

wx.request({
  url: 'test.php', //僅為示例，并非真實的接口地址
  data: {
    x: '',
    y: ''
  },
  header: {
    'content-type': 'application/json' // 默認值
  },
  success (res) {
    console.log(res.data)
  }
})

RequestTask

基礎(chǔ)庫 1.4.0 開始支持，低版本需做兼容處理。

網(wǎng)絡(luò)請求任務(wù)對象

方法

RequestTask.abort()

基礎(chǔ)庫 1.4.0 開始支持，低版本需做兼容處理。

中斷請求任務(wù)

RequestTask.offHeadersReceived(function callback)

基礎(chǔ)庫 2.1.0 開始支持，低版本需做兼容處理。

取消監(jiān)聽 HTTP Response Header 事件

參數(shù)

function callback

HTTP Response Header 事件的回調(diào)函數(shù)

RequestTask.onHeadersReceived(function callback)

基礎(chǔ)庫 2.1.0 開始支持，低版本需做兼容處理。

監(jiān)聽 HTTP Response Header 事件。會比請求完成事件更早

參數(shù)

function callback

HTTP Response Header 事件的回調(diào)函數(shù)

參數(shù)

Object res

示例代碼

const requestTask = wx.request({
  url: 'test.php', //僅為示例，并非真實的接口地址
  data: {
    x: '' ,
    y: ''
  },
  header: {
    'content-type': 'application/json'
  },
  success (res) {
    console.log(res.data)
  }
})
requestTask.abort() // 取消請求任務(wù)