wretch middlewares

الوسيطة البائسة

مجموعة من البرامج الوسيطة لمكتبة Wretch.

إشعار الإهمال

️ تم الآن إهمال هذا المستودع، وتم دمج البرامج الوسيطة في الحزمة wretch الرئيسية بدءًا من الإصدار 2.0.0 من البائس

تثبيت

المتطلب السابق: تثبيت البائس

Npm

npm i wretch-middlewares

شبكة التنمية المستدامة

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

الوسيطة

إزالة التكرار	أعد المحاولة	اختناق ذاكرة التخزين المؤقت	تأخير

إزالة التكرار

يمنع وجود طلبات متطابقة متعددة على الطاير في نفس الوقت.

خيارات

• تخطي : (url, opts) => boolean

إذا أعاد التخطي القيمة true، فسيتم تخطي التحقق من إزالة البيانات المكررة.

• المفتاح : (url, opts) => string

إرجاع المفتاح الذي يستخدم لتحديد الطلب.

• المحلل : (response: Response) => Response

يتم استدعاء هذه الوظيفة عند حل استجابة الجلب من المكالمات المكررة. بشكل افتراضي، يقوم باستنساخ الاستجابة للسماح بقراءة النص من مصادر متعددة.

الاستخدام

 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 ( )
    } )
] ) . /* ... */ 

أعد المحاولة

إعادة محاولة الطلب عدة مرات في حالة حدوث خطأ (أو حتى يصبح الشرط المخصص صحيحًا).

خيارات

• تأخير الموقت : milliseconds

الموقت بين كل محاولة.

• DelayRamp : (delay, nbOfAttempts) => milliseconds

الوظيفة المخصصة المستخدمة لحساب التأخير الفعلي بناءً على المؤقت وعدد المحاولات.

• الحد الأقصى للمحاولات : number

الحد الأقصى لعدد مرات إعادة المحاولة قبل حل الوعد بالخطأ الأخير. تحديد 0 يعني عدد لا نهائي من المحاولات.

• حتى : (fetchResponse, error) => boolean | Promise<boolean>

ستتم إعادة محاولة الطلب حتى يتم استيفاء هذا الشرط.

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

رد الاتصال الذي سيتم تنفيذه قبل إعادة محاولة الطلب. إذا قامت هذه الوظيفة بإرجاع كائن له خصائص عنوان url و/أو خيارات، فسوف تتجاوز القيم الموجودة في الطلب المعاد محاولته. إذا أعاد وعدًا، فسيتم انتظاره قبل إعادة محاولة الطلب.

• خطأ إعادة المحاولة على الشبكة : boolean

إذا كان صحيحًا، فسيتم إعادة محاولة الطلب إذا حدث خطأ في الشبكة. سيوفر أيضًا وسيطة "خطأ" لطرق onRetry و until .

• المحلل : (response: Response) => Response

يتم استدعاء هذه الوظيفة عند حل استجابة الجلب من المكالمات المكررة. بشكل افتراضي، يقوم باستنساخ الاستجابة للسماح بقراءة النص من مصادر متعددة.

الاستخدام

 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'
            )
    } )
] ) 

اختناق ذاكرة التخزين المؤقت

ذاكرة تخزين مؤقت مخبأة تقوم بتخزين استجابات الخادم وتقديمها لفترة معينة من الوقت.

خيارات

• خنق : milliseconds

سيتم تخزين الاستجابة لهذا القدر من الوقت قبل حذفها من ذاكرة التخزين المؤقت.

• تخطي : (url, opts) => boolean

إذا أعاد التخطي القيمة true، فسيتم تخطي التحقق من إزالة البيانات المكررة.

• المفتاح : (url, opts) => string

إرجاع المفتاح الذي يستخدم لتحديد الطلب.

• واضح (url, opts) => boolean

يمسح ذاكرة التخزين المؤقت إذا كان صحيحا.

• إبطال (url, opts) => string | RegExp | Array<string | RegExp> | null

يزيل عنوان (عناوين) url المطابقة للسلسلة أو RegExp من ذاكرة التخزين المؤقت. يمكن استخدام مصفوفة لإبطال قيم متعددة.

• استجابة الشرط response => boolean

إذا كان خطأ، فلن تتم إضافة الاستجابة إلى ذاكرة التخزين المؤقت.

• string flagResponseOnCacheHit

إذا تم تعيينها، فسيتم وضع علامة على الاستجابة التي يتم إرجاعها من ذاكرة التخزين المؤقت باسم خاصية يساوي هذا الخيار.

الاستخدام

 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'
    } )
] ) . /* ... */ 

تأخير

- تأخير الطلب لفترة زمنية محددة.

خيارات

• الوقت : milliseconds

سيتم تأخير الطلب لهذه المدة.

الاستخدام

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

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