RequestTask wx.request(Object object)
發(fā)起 HTTPS 網(wǎng)絡(luò)請(qǐng)求。使用前請(qǐng)注意閱讀相關(guān)說(shuō)明。

參數(shù)
Object object
屬性    類(lèi)型    默認(rèn)值    必填    說(shuō)明    最低版本
url    string        是    開(kāi)發(fā)者服務(wù)器接口地址    
data    string/object/ArrayBuffer        否    請(qǐng)求的參數(shù)    
header    Object        否    設(shè)置請(qǐng)求的 header，header 中不能設(shè)置 Referer。
`content-type` 默認(rèn)為 `application/json`    
timeout    number        否    超時(shí)時(shí)間，單位為毫秒。默認(rèn)值為 60000    2.10.0
method    string    GET    否    HTTP 請(qǐng)求方法    
合法值    說(shuō)明
OPTIONS    HTTP 請(qǐng)求 OPTIONS
GET    HTTP 請(qǐng)求 GET
HEAD    HTTP 請(qǐng)求 HEAD
POST    HTTP 請(qǐng)求 POST
PUT    HTTP 請(qǐng)求 PUT
DELETE    HTTP 請(qǐng)求 DELETE
TRACE    HTTP 請(qǐng)求 TRACE
CONNECT    HTTP 請(qǐng)求 CONNECT
dataType    string    json    否    返回的數(shù)據(jù)格式    
合法值    說(shuō)明
json    返回的數(shù)據(jù)為 JSON，返回后會(huì)對(duì)返回的數(shù)據(jù)進(jìn)行一次 JSON.parse
其他    不對(duì)返回的內(nèi)容進(jìn)行 JSON.parse
responseType    string    text    否    響應(yīng)的數(shù)據(jù)類(lèi)型    1.7.0
合法值    說(shuō)明
text    響應(yīng)的數(shù)據(jù)為文本
arraybuffer    響應(yīng)的數(shù)據(jù)為 ArrayBuffer
enableHttp2    boolean    false    否    開(kāi)啟 http2    2.10.4
enableQuic    boolean    false    否    開(kāi)啟 quic    2.10.4
enableCache    boolean    false    否    開(kāi)啟 cache    2.10.4
enableHttpDNS    boolean    false    否    是否開(kāi)啟 HttpDNS 服務(wù)。如開(kāi)啟，需要同時(shí)填入 httpDNSServiceId 。 HttpDNS 用法詳見(jiàn) 移動(dòng)解析HttpDNS    2.19.1
httpDNSServiceId    string        否    HttpDNS 服務(wù)商 Id。 HttpDNS 用法詳見(jiàn) 移動(dòng)解析HttpDNS    2.19.1
enableChunked    boolean    false    否    開(kāi)啟 transfer-encoding chunked。    2.20.2
forceCellularNetwork    boolean    false    否    wifi下使用移動(dòng)網(wǎng)絡(luò)發(fā)送請(qǐng)求    2.21.0
success    function        否    接口調(diào)用成功的回調(diào)函數(shù)    
fail    function        否    接口調(diào)用失敗的回調(diào)函數(shù)    
complete    function        否    接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）    
object.success 回調(diào)函數(shù)
參數(shù)
Object res
屬性    類(lèi)型    說(shuō)明    最低版本
data    string/Object/Arraybuffer    開(kāi)發(fā)者服務(wù)器返回的數(shù)據(jù)    
statusCode    number    開(kāi)發(fā)者服務(wù)器返回的 HTTP 狀態(tài)碼    
header    Object    開(kāi)發(fā)者服務(wù)器返回的 HTTP Response Header    1.2.0
cookies    Array.<string>    開(kāi)發(fā)者服務(wù)器返回的 cookies，格式為字符串?dāng)?shù)組    2.10.0
profile    Object    網(wǎng)絡(luò)請(qǐng)求過(guò)程中一些調(diào)試信息，查看詳細(xì)說(shuō)明    2.10.4
結(jié)構(gòu)屬性    類(lèi)型    說(shuō)明
redirectStart    number    第一個(gè) HTTP 重定向發(fā)生時(shí)的時(shí)間。有跳轉(zhuǎn)且是同域名內(nèi)的重定向才算，否則值為 0
redirectEnd    number    最后一個(gè) HTTP 重定向完成時(shí)的時(shí)間。有跳轉(zhuǎn)且是同域名內(nèi)部的重定向才算，否則值為 0
fetchStart    number    組件準(zhǔn)備好使用 HTTP 請(qǐng)求抓取資源的時(shí)間，這發(fā)生在檢查本地緩存之前
domainLookupStart    number    DNS 域名查詢(xún)開(kāi)始的時(shí)間，如果使用了本地緩存（即無(wú) DNS 查詢(xún)）或持久連接，則與 fetchStart 值相等
domainLookupEnd    number    DNS 域名查詢(xún)完成的時(shí)間，如果使用了本地緩存（即無(wú) DNS 查詢(xún)）或持久連接，則與 fetchStart 值相等
connectStart    number    HTTP（TCP） 開(kāi)始建立連接的時(shí)間，如果是持久連接，則與 fetchStart 值相等。注意如果在傳輸層發(fā)生了錯(cuò)誤且重新建立連接，則這里顯示的是新建立的連接開(kāi)始的時(shí)間
connectEnd    number    HTTP（TCP） 完成建立連接的時(shí)間（完成握手），如果是持久連接，則與 fetchStart 值相等。注意如果在傳輸層發(fā)生了錯(cuò)誤且重新建立連接，則這里顯示的是新建立的連接完成的時(shí)間。注意這里握手結(jié)束，包括安全連接建立完成、SOCKS 授權(quán)通過(guò)
SSLconnectionStart    number    SSL建立連接的時(shí)間,如果不是安全連接,則值為 0
SSLconnectionEnd    number    SSL建立完成的時(shí)間,如果不是安全連接,則值為 0
requestStart    number    HTTP請(qǐng)求讀取真實(shí)文檔開(kāi)始的時(shí)間（完成建立連接），包括從本地讀取緩存。連接錯(cuò)誤重連時(shí)，這里顯示的也是新建立連接的時(shí)間
requestEnd    number    HTTP請(qǐng)求讀取真實(shí)文檔結(jié)束的時(shí)間
responseStart    number    HTTP 開(kāi)始接收響應(yīng)的時(shí)間（獲取到第一個(gè)字節(jié)），包括從本地讀取緩存
responseEnd    number    HTTP 響應(yīng)全部接收完成的時(shí)間（獲取到最后一個(gè)字節(jié)），包括從本地讀取緩存
rtt    number    當(dāng)次請(qǐng)求連接過(guò)程中實(shí)時(shí) rtt
estimate_nettype    number    評(píng)估的網(wǎng)絡(luò)狀態(tài) unknown, offline, slow 2g, 2g, 3g, 4g, last/0, 1, 2, 3, 4, 5, 6
httpRttEstimate    number    協(xié)議層根據(jù)多個(gè)請(qǐng)求評(píng)估當(dāng)前網(wǎng)絡(luò)的 rtt（僅供參考）
transportRttEstimate    number    傳輸層根據(jù)多個(gè)請(qǐng)求評(píng)估的當(dāng)前網(wǎng)絡(luò)的 rtt（僅供參考）
downstreamThroughputKbpsEstimate    number    評(píng)估當(dāng)前網(wǎng)絡(luò)下載的kbps
throughputKbps    number    當(dāng)前網(wǎng)絡(luò)的實(shí)際下載kbps
peerIP    string    當(dāng)前請(qǐng)求的IP
port    number    當(dāng)前請(qǐng)求的端口
socketReused    boolean    是否復(fù)用連接
sendBytesCount    number    發(fā)送的字節(jié)數(shù)
receivedBytedCount    number    收到字節(jié)數(shù)
protocol    string    使用協(xié)議類(lèi)型，有效值：http1.1, h2, quic, unknown
object.fail 回調(diào)函數(shù)
參數(shù)
Object err
屬性    類(lèi)型    說(shuō)明    最低版本
errMsg    String    錯(cuò)誤信息    
errno    Number    errno 錯(cuò)誤碼，錯(cuò)誤碼的詳細(xì)說(shuō)明參考 Errno錯(cuò)誤碼    2.24.0
返回值

RequestTask
請(qǐng)求任務(wù)對(duì)象

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

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

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