wretch middlewares

Peralatan tengah yang malang

Koleksi middleware untuk perpustakaan Wretch.

Pemberitahuan Penghentian

️ Repositori ini sekarang sudah tidak digunakan lagi, middleware telah diintegrasikan ke dalam paket utama wretch mulai dari celaka v2.0.0

Instalasi

Prasyarat: instal Wretch

Npm

npm i wretch-middlewares

CDN

 <!-- Global variable name : window.wretchMiddlewares -->
< script src =" https://unpkg.com/wretch-middlewares " > </ script >

perangkat tengah

Dedupe	Mencoba kembali	Pembatasan cache	Menunda

Dedupe

Mencegah beberapa permintaan identik dengan cepat pada saat yang bersamaan.

Pilihan

• lewati : (url, opts) => boolean

Jika skip menghasilkan nilai true, maka pemeriksaan dedupe dilewati.

• kunci : (url, opts) => string

Mengembalikan kunci yang digunakan untuk mengidentifikasi permintaan.

• penyelesai : (response: Response) => Response

Fungsi ini dipanggil ketika menyelesaikan respons pengambilan dari panggilan duplikat. Secara default, ini mengkloning respons untuk memungkinkan pembacaan isi dari berbagai sumber.

Penggunaan

 import wretch from 'wretch'
import { dedupe } from 'wretch-middlewares'

wretch ( ) . middlewares ( [
    dedupe ( {
        /* Options - defaults below */
        skip : ( url , opts ) => opts . skipDedupe || opts . method !== 'GET' ,
        key : ( url , opts ) => opts . method + '@' + url ,
        resolver : response => response . clone ( )
    } )
] ) . /* ... */ 

Mencoba kembali

Mencoba kembali permintaan beberapa kali jika terjadi kesalahan (atau hingga kondisi khusus benar).

Pilihan

• delayTimer : milliseconds

Pengatur waktu di antara setiap upaya.

• delayRamp : (delay, nbOfAttempts) => milliseconds

Fungsi khusus yang digunakan untuk menghitung penundaan sebenarnya berdasarkan pengatur waktu & jumlah upaya.

• maxAttempts : number

Jumlah maksimum percobaan ulang sebelum menyelesaikan janji dengan kesalahan terakhir. Menentukan 0 berarti percobaan ulang tanpa batas.

• sampai : (fetchResponse, error) => boolean | Promise<boolean>

Permintaan akan dicoba ulang hingga kondisi tersebut terpenuhi.

• onRetry : ({ response, error, url, options }) => { url?, options? } || Promise<{url?, options?}>

Panggilan balik yang akan dieksekusi sebelum mencoba kembali permintaan tersebut. Jika fungsi ini mengembalikan objek yang memiliki properti url dan/atau opsi, mereka akan mengganti nilai yang ada dalam permintaan yang dicoba ulang. Jika mengembalikan Janji, maka akan ditunggu sebelum mencoba kembali permintaan tersebut.

• coba lagiOnNetworkError : boolean

Jika benar, akan mencoba ulang permintaan jika terjadi kesalahan jaringan. Juga akan memberikan argumen 'kesalahan' pada metode onRetry dan until .

• penyelesai : (response: Response) => Response

Fungsi ini dipanggil ketika menyelesaikan respons pengambilan dari panggilan duplikat. Secara default, ini mengkloning respons untuk memungkinkan pembacaan isi dari berbagai sumber.

Penggunaan

 import wretch from 'wretch'
import { retry } from 'wretch-middlewares'

wretch ( ) . middlewares ( [
    retry ( {
        /* Options - defaults below */
        delayTimer : 500 ,
        delayRamp : ( delay , nbOfAttempts ) => delay * nbOfAttempts ,
        maxAttempts : 10 ,
        until : ( response , error ) => response && response . ok ,
        onRetry : null ,
        retryOnNetworkError : false ,
        resolver : response => response . clone ( )
    } )
] ) . /* ... */

// You can also return a Promise, which is useful if you want to inspect the body:
wretch ( ) . middlewares ( [
    retry ( {
        until : response =>
            response . json ( ) . then ( body =>
                body . field === 'something'
            )
    } )
] ) 

Pembatasan cache

Cache pembatasan yang menyimpan dan menyajikan respons server selama jangka waktu tertentu.

Pilihan

• throttle : milliseconds

Responsnya akan disimpan selama jangka waktu tersebut sebelum dihapus dari cache.

• lewati : (url, opts) => boolean

Jika skip menghasilkan nilai true, maka pemeriksaan dedupe dilewati.

• kunci : (url, opts) => string

Mengembalikan kunci yang digunakan untuk mengidentifikasi permintaan.

• hapus (url, opts) => boolean

Menghapus cache jika benar.

• tidak valid (url, opts) => string | RegExp | Array<string | RegExp> | null

Menghapus url yang cocok dengan string atau RegExp dari cache. Dapat menggunakan array untuk membatalkan beberapa nilai.

• respon kondisi response => boolean

Jika salah maka respon tidak akan ditambahkan ke cache.

• string flagResponseOnCacheHit

Jika disetel, Respons yang dikembalikan dari cache akan ditandai dengan nama properti yang sama dengan opsi ini.

Penggunaan

 import wretch from 'wretch'
import { throttlingCache } from 'wretch-middlewares'

wretch ( ) . middlewares ( [
    throttlingCache ( {
        /* Options - defaults below */
        throttle : 1000 ,
        skip : ( url , opts ) => opts . skipCache || opts . method !== 'GET' ,
        key : ( url , opts ) => opts . method + '@' + url ,
        clear : ( url , opts ) => false ,
        invalidate : ( url , opts ) => null ,
        condition : response => response . ok ,
        flagResponseOnCacheHit : '__cached'
    } )
] ) . /* ... */ 

Menunda

Menunda permintaan selama jangka waktu tertentu.

Pilihan

• waktu : milliseconds

Permintaan akan tertunda selama jangka waktu tersebut.

Penggunaan

 import wretch from 'wretch'
import { delay } from 'wretch-middlewares'

wretch ( ) . middlewares ( [
    delay ( 1000 )
] ) . /* ... */