Pustaka komponen permintaan jaringan berdasarkan ekstensi wx.request yang disediakan untuk applet WeChat.
npm install weapp.request -S
const request = require ( 'weapp.request' )
Kirim permintaan GET
request ( 'https://api.github.com' ) . then ( onFulfilled ) . catch ( onRejected )
Karena semua panggilan request
akan mengembalikan Promise
, Anda dapat then
untuk memproses lebih lanjut hasil permintaan, dan menggunakan catch
untuk menangkap kesalahan yang terjadi secara internal.
Kirim permintaan GET dan tulis ke cache
request ( 'https://api.github.com' , { } , {
cache : true
} )
Kirim permintaan POST
request . post ( 'https://api.github.com' , {
user : 'afishhhhh'
} )
Kecuali permintaan GET, semua metode lain harus dipanggil dalam bentuk request.method
.
Menurut dokumentasi resmi WeChat, metode POST di atas dan Content-Type
default adalah application/json
, dan datanya akan diserialkan JSON.
Jika Anda perlu mengirim data ke server dalam bentuk string kueri, Anda dapat menggunakan metode pemanggilan berikut. Anda tidak perlu menulis Content-Type
sebagai application/x-www-form-urlencoded
secara eksplisit:
request . post ( 'https://api.github.com' , {
form : {
user : 'afishhhhh'
}
} )
Konfigurasi global
Opsi konfigurasi | jenis | menjelaskan | Diperlukan | nilai bawaan |
---|---|---|---|---|
baseUrl | String/Undefined | Jalur permintaan dasar | TIDAK | |
cacheMaxAge | Number/Undefined | Masa berlaku cache, satuan waktu adalah detik | TIDAK | 1800 |
KodeStatus yang valid | Function/Undefined | rentang hukum kode status, fungsi ini menerima satu parameter dan mengembalikan Boolean | TIDAK | code => code >= 200 && code < 300 |
request . config ( {
baseUrl : 'https://api.github.com'
} )
Pencegat permintaan/tanggapan
// 添加请求拦截器
request.interceptors.req.use(function (request) {
request.header['X-Tag'] = 'weapp.request'
// return request 可以显式地返回一个 request,如果没有 return,则默认返回当前 request
})
Hal yang sama berlaku untuk pencegat respons.
// 移除请求拦截器
request.interceptors.req.remove()
request(url, params, options)
Buat permintaan GET.
params
: parameter permintaan, tipenya adalah Object
, opsional.
options
: item konfigurasi, tipenya adalah Object
, opsional, dapat memiliki nilai atribut berikut:
milik | jenis | Diperlukan | nilai bawaan | menjelaskan |
---|---|---|---|---|
cache | Boolean/Undefined | TIDAK | undefined | undefined artinya mendapatkan data terbaru dari server dan tidak menuliskannya ke dalam cache; true artinya mendapatkan data dari cache terlebih dahulu. Jika data tidak ada di cache atau cache sudah kadaluwarsa, maka data akan diperoleh server dan ditulis ke cache; false berarti mendapatkan data dari server terlebih dahulu |
tajuk | Sama seperti dokumen resmi WeChat | |||
tipe data | Sama seperti dokumen resmi WeChat | |||
tipe respons | Sama seperti dokumen resmi WeChat |
request.method(url, params, options)
method
bisa berupa get
, post
dll.
request.config(options)
options
: Item konfigurasi, tipenya adalah Object
.
Kode ini didistribusikan berdasarkan syarat dan ketentuan lisensi MIT.