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

專注于為中小企業(yè)提供網(wǎng)站設(shè)計(jì)、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)永嘉免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都,凝聚了一批互聯(lián)網(wǎng)行業(yè)人才,有力地推動(dòng)了成百上千家企業(yè)的穩(wěn)健成長(zhǎng),幫助中小企業(yè)通過網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。
參數(shù)
Object object
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 | 最低版本 |
|---|---|---|---|---|---|
| url | string | 是 | 開發(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í)間,單位為毫秒 | 2.10.0 | |
| method | string | GET | 否 | HTTP 請(qǐng)求方法 | |
| dataType | string | json | 否 | 返回的數(shù)據(jù)格式 | |
| responseType | string | text | 否 | 響應(yīng)的數(shù)據(jù)類型 | 1.7.0 |
| enableHttp2 | boolean | false | 否 | 開啟 http2 | 2.10.4 |
| enableQuic | boolean | false | 否 | 開啟 quic | 2.10.4 |
| enableCache | boolean | false | 否 | 開啟 cache | 2.10.4 |
| 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.method 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 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 |
object.dataType 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| json | 返回的數(shù)據(jù)為 JSON,返回后會(huì)對(duì)返回的數(shù)據(jù)進(jìn)行一次 JSON.parse | |
| 其他 | 不對(duì)返回的內(nèi)容進(jìn)行 JSON.parse |
object.responseType 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| text | 響應(yīng)的數(shù)據(jù)為文本 | |
| arraybuffer | 響應(yīng)的數(shù)據(jù)為 ArrayBuffer |
object.success 回調(diào)函數(shù)
參數(shù)
Object res
| 屬性 | 類型 | 說明 | 最低版本 |
|---|---|---|---|
| data | string/Object/Arraybuffer | 開發(fā)者服務(wù)器返回的數(shù)據(jù) | |
| statusCode | number | 開發(fā)者服務(wù)器返回的 HTTP 狀態(tài)碼 | |
| header | Object | 開發(fā)者服務(wù)器返回的 HTTP Response Header | 1.2.0 |
| cookies | Array. |
開發(fā)者服務(wù)器返回的 cookies,格式為字符串?dāng)?shù)組 | 2.10.0 |
| profile | Object | 網(wǎng)絡(luò)請(qǐng)求過程中一些調(diào)試信息 | 2.10.4 |
res.profile 的結(jié)構(gòu)
| 屬性 | 類型 | 說明 |
|---|---|---|
| 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 域名查詢開始的時(shí)間,如果使用了本地緩存(即無 DNS 查詢)或持久連接,則與 fetchStart 值相等 |
| domainLookupEnd | number | DNS 域名查詢完成的時(shí)間,如果使用了本地緩存(即無 DNS 查詢)或持久連接,則與 fetchStart 值相等 |
| connectStart | number | HTTP(TCP) 開始建立連接的時(shí)間,如果是持久連接,則與 fetchStart 值相等。注意如果在傳輸層發(fā)生了錯(cuò)誤且重新建立連接,則這里顯示的是新建立的連接開始的時(shí)間 |
| connectEnd | number | HTTP(TCP) 完成建立連接的時(shí)間(完成握手),如果是持久連接,則與 fetchStart 值相等。注意如果在傳輸層發(fā)生了錯(cuò)誤且重新建立連接,則這里顯示的是新建立的連接完成的時(shí)間。注意這里握手結(jié)束,包括安全連接建立完成、SOCKS 授權(quán)通過 |
| SSLconnectionStart | number | SSL建立連接的時(shí)間,如果不是安全連接,則值為 0 |
| SSLconnectionEnd | number | SSL建立完成的時(shí)間,如果不是安全連接,則值為 0 |
| requestStart | number | HTTP請(qǐng)求讀取真實(shí)文檔開始的時(shí)間(完成建立連接),包括從本地讀取緩存。連接錯(cuò)誤重連時(shí),這里顯示的也是新建立連接的時(shí)間 |
| requestEnd | number | HTTP請(qǐng)求讀取真實(shí)文檔結(jié)束的時(shí)間 |
| responseStart | number | HTTP 開始接收響應(yīng)的時(shí)間(獲取到第一個(gè)字節(jié)),包括從本地讀取緩存 |
| responseEnd | number | HTTP 響應(yīng)全部接收完成的時(shí)間(獲取到最后一個(gè)字節(jié)),包括從本地讀取緩存 |
| rtt | number | 當(dāng)次請(qǐng)求連接過程中實(shí)時(shí) rtt |
| estimate_nettype | string | 評(píng)估的網(wǎng)絡(luò)狀態(tài) slow 2g/2g/3g/4g |
| 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ù) |
返回值
RequestTask
基礎(chǔ)庫(kù) 1.4.0 開始支持,低版本需做兼容處理。
請(qǐng)求任務(wù)對(duì)象
data 參數(shù)說明
最終發(fā)送給服務(wù)器的數(shù)據(jù)是 String 類型,如果傳入的 data 不是 String 類型,會(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: 'test.php', //僅為示例,并非真實(shí)的接口地址
data: {
x: '',
y: ''
},
header: {
'content-type': 'application/json' // 默認(rèn)值
},
success (res) {
console.log(res.data)
}
})
RequestTask
基礎(chǔ)庫(kù) 1.4.0 開始支持,低版本需做兼容處理。
網(wǎng)絡(luò)請(qǐng)求任務(wù)對(duì)象
方法
RequestTask.abort()
基礎(chǔ)庫(kù) 1.4.0 開始支持,低版本需做兼容處理。
基礎(chǔ)庫(kù) 1.4.0 開始支持,低版本需做兼容處理。
中斷請(qǐng)求任務(wù)
RequestTask.offHeadersReceived(function callback)
基礎(chǔ)庫(kù) 2.1.0 開始支持,低版本需做兼容處理。
基礎(chǔ)庫(kù) 2.1.0 開始支持,低版本需做兼容處理。
取消監(jiān)聽 HTTP Response Header 事件
參數(shù)
function callback
HTTP Response Header 事件的回調(diào)函數(shù)
RequestTask.onHeadersReceived(function callback)
基礎(chǔ)庫(kù) 2.1.0 開始支持,低版本需做兼容處理。
監(jiān)聽 HTTP Response Header 事件。會(huì)比請(qǐng)求完成事件更早
參數(shù)
function callback
HTTP Response Header 事件的回調(diào)函數(shù)
參數(shù)
Object res
| 屬性 | 類型 | 說明 |
|---|---|---|
| header | Object | 開發(fā)者服務(wù)器返回的 HTTP Response Header |
示例代碼
const requestTask = wx.request({
url: 'test.php', //僅為示例,并非真實(shí)的接口地址
data: {
x: '' ,
y: ''
},
header: {
'content-type': 'application/json'
},
success (res) {
console.log(res.data)
}
})
requestTask.abort() // 取消請(qǐng)求任務(wù)
網(wǎng)頁(yè)標(biāo)題:創(chuàng)新互聯(lián)小程序教程:微信小程序API發(fā)起請(qǐng)求
URL網(wǎng)址:http://www.dlmjj.cn/article/cdioieo.html


咨詢
建站咨詢
