uni-app 發起網絡請求（二）

uni.request(OBJECT)
發起網絡請求。

OBJECT 參數說明

參數名 類型 必填 默認值 說明
url String 是   開發者服務器接口地址
data Object/String/ArrayBuffer 否   請求的參數
header Object 否   設置請求的 header，header 中不能設置 Referer。
method String 否 GET （需大寫）有效值：OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataType String 否 json 若是設爲 json，會嘗試對返回的數據作一次 JSON.parse
responseType String 否 text 設置響應的數據類型。合法值：text、arraybuffer
success Function 否   收到開發者服務成功返回的回調函數
fail Function 否   接口調用失敗的回調函數
complete Function 否   接口調用結束的回調函數（調用成功、失敗都會執行）
success 返回參數說明

參數 類型 說明
data Object/String/ArrayBuffer 開發者服務器返回的數據
statusCode Number 開發者服務器返回的 HTTP 狀態碼
header Object 開發者服務器返回的 HTTP Response Header
data 數聽說明

最終發送給服務器的數據是 String 類型，若是傳入的 data 不是 String 類型，會被轉換成 String。轉換規則以下：

對於 GET 方法，會將數據轉換爲 query string。例如 { name: 'name', age: 18 } 轉換後的結果是 name=name&age=18。
對於 POST 方法且 header['content-type'] 爲 application/json 的數據，會進行 JSON 序列化。
對於 POST 方法且 header['content-type'] 爲 application/x-www-form-urlencoded 的數據，會將數據轉換爲 query string。
示例

uni.request({

url: 'https://www.example.com/request', //僅爲示例，並不是真實接口地址。
data: {
    name: 'name',
    age: 18
},
header: {
    'custom-header': 'hello' //自定義請求頭信息
},
success: function (res) {
    console.log(res.data);
}

});
返回值

返回一個 requestTask 對象，經過 requestTask，可中斷請求任務。

requestTask 對象的方法列表

方法 參數 說明
abort   中斷請求任務
示例

const requestTask = uni.request({

url: 'https://www.example.com/request', //僅爲示例，並不是真實接口地址。
data: {
    name: 'name',
    age: 18
},
success: function (res) {
    console.log(res.data);
}

});

// 中斷請求任務
requestTask.abort();
Tips

請求的 header 中 content-type 默認爲 application/json。