جعبه کار - استراتژی ها

یک نمونه جدید از استراتژی ایجاد می کند و تمام ویژگی های گزینه مستند شده را به عنوان ویژگی های نمونه عمومی تنظیم می کند.

نکته: اگر یک کلاس استراتژی سفارشی کلاس Strategy پایه را گسترش دهد و به بیشتر از این ویژگی ها نیاز نداشته باشد، نیازی به تعریف سازنده خود ندارد.

تابع constructor به صورت زیر است:

(options?: StrategyOptions) => {...}

تابع _awaitComplete به شکل زیر است:

(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _getResponse به شکل زیر است:

(handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

یک استراتژی درخواست را اجرا کنید و یک Promise را برمی‌گرداند که با یک Response حل می‌شود و همه تماس‌های مربوط به افزونه را فراخوانی می‌کند.

هنگامی که یک نمونه استراتژی با Workbox workbox-routing.Route ثبت می شود، این روش به طور خودکار زمانی که مسیر مطابقت دارد فراخوانی می شود.

از طرف دیگر، این روش را می توان در یک شنونده مستقل FetchEvent با ارسال آن به event.respondWith() استفاده کرد.

تابع handle به نظر می رسد:

(options: FetchEvent | HandlerCallbackOptions) => {...}

مشابه workbox-strategies.Strategy~handle ، اما به جای اینکه فقط یک Promise برگرداند که به یک Response آن را حل می کند، چندین وعده [response, done] را برمی گرداند، که در آن ( response ) قبلی معادل چیزی است که handle() برمی گرداند. و دومی یک Promise است که پس از تکمیل هر وعده‌ای که به event.waitUntil() به عنوان بخشی از اجرای استراتژی تکمیل شد، برطرف می‌شود.

شما می توانید منتظر وعده done باشید تا مطمئن شوید که هر کار اضافی انجام شده توسط استراتژی (معمولاً پاسخ های حافظه پنهان) با موفقیت کامل می شود.

تابع handleAll به شکل زیر است:

(options: FetchEvent | HandlerCallbackOptions) => {...}

یک نمونه جدید از استراتژی ایجاد می کند و تمام ویژگی های گزینه مستند شده را به عنوان ویژگی های نمونه عمومی تنظیم می کند.

نکته: اگر یک کلاس استراتژی سفارشی کلاس Strategy پایه را گسترش دهد و به بیشتر از این ویژگی ها نیاز نداشته باشد، نیازی به تعریف سازنده خود ندارد.

تابع constructor به صورت زیر است:

(options?: StrategyOptions) => {...}

تابع _awaitComplete به شکل زیر است:

(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _getResponse به شکل زیر است:

(handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

یک استراتژی درخواست را اجرا کنید و یک Promise را برمی‌گرداند که با یک Response حل می‌شود و همه تماس‌های مربوط به افزونه را فراخوانی می‌کند.

هنگامی که یک نمونه استراتژی با Workbox workbox-routing.Route ثبت می شود، این روش به طور خودکار زمانی که مسیر مطابقت دارد فراخوانی می شود.

از طرف دیگر، این روش را می توان در یک شنونده مستقل FetchEvent با ارسال آن به event.respondWith() استفاده کرد.

تابع handle به نظر می رسد:

(options: FetchEvent | HandlerCallbackOptions) => {...}

مشابه workbox-strategies.Strategy~handle ، اما به جای اینکه فقط یک Promise برگرداند که به یک Response آن را حل می کند، چندین وعده [response, done] را برمی گرداند، که در آن ( response ) قبلی معادل چیزی است که handle() برمی گرداند. و دومی یک Promise است که پس از تکمیل هر وعده‌ای که به event.waitUntil() به عنوان بخشی از اجرای استراتژی تکمیل شد، برطرف می‌شود.

شما می توانید منتظر وعده done باشید تا مطمئن شوید که هر کار اضافی انجام شده توسط استراتژی (معمولاً پاسخ های حافظه پنهان) با موفقیت کامل می شود.

تابع handleAll به شکل زیر است:

(options: FetchEvent | HandlerCallbackOptions) => {...}

تابع constructor به صورت زیر است:

(options?: NetworkFirstOptions) => {...}

تابع _awaitComplete به شکل زیر است:

(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _getResponse به شکل زیر است:

(handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

یک استراتژی درخواست را اجرا کنید و یک Promise را برمی‌گرداند که با یک Response حل می‌شود و همه تماس‌های مربوط به افزونه را فراخوانی می‌کند.

هنگامی که یک نمونه استراتژی با Workbox workbox-routing.Route ثبت می شود، این روش به طور خودکار زمانی که مسیر مطابقت دارد فراخوانی می شود.

از طرف دیگر، این روش را می توان در یک شنونده مستقل FetchEvent با ارسال آن به event.respondWith() استفاده کرد.

تابع handle به نظر می رسد:

(options: FetchEvent | HandlerCallbackOptions) => {...}

مشابه workbox-strategies.Strategy~handle ، اما به جای اینکه فقط یک Promise برگرداند که به یک Response آن را حل می کند، چندین وعده [response, done] را برمی گرداند، که در آن ( response ) قبلی معادل چیزی است که handle() برمی گرداند. و دومی یک Promise است که پس از تکمیل هر وعده‌ای که به event.waitUntil() به عنوان بخشی از اجرای استراتژی تکمیل شد، برطرف می‌شود.

شما می توانید منتظر وعده done باشید تا مطمئن شوید که هر کار اضافی انجام شده توسط استراتژی (معمولاً پاسخ های حافظه پنهان) با موفقیت کامل می شود.

تابع handleAll به شکل زیر است:

(options: FetchEvent | HandlerCallbackOptions) => {...}

تابع constructor به صورت زیر است:

(options?: NetworkOnlyOptions) => {...}

تابع _awaitComplete به شکل زیر است:

(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _getResponse به شکل زیر است:

(handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

یک استراتژی درخواست را اجرا کنید و یک Promise را برمی‌گرداند که با یک Response حل می‌شود و همه تماس‌های مربوط به افزونه را فراخوانی می‌کند.

هنگامی که یک نمونه استراتژی با Workbox workbox-routing.Route ثبت می شود، این روش به طور خودکار زمانی که مسیر مطابقت دارد فراخوانی می شود.

از طرف دیگر، این روش را می توان در یک شنونده مستقل FetchEvent با ارسال آن به event.respondWith() استفاده کرد.

تابع handle به نظر می رسد:

(options: FetchEvent | HandlerCallbackOptions) => {...}

مشابه workbox-strategies.Strategy~handle ، اما به جای اینکه فقط یک Promise برگرداند که به یک Response آن را حل می کند، چندین وعده [response, done] را برمی گرداند، که در آن ( response ) قبلی معادل چیزی است که handle() برمی گرداند. و دومی یک Promise است که پس از تکمیل هر وعده‌ای که به event.waitUntil() به عنوان بخشی از اجرای استراتژی تکمیل شد، برطرف می‌شود.

شما می توانید منتظر وعده done باشید تا مطمئن شوید که هر کار اضافی انجام شده توسط استراتژی (معمولاً پاسخ های حافظه پنهان) با موفقیت کامل می شود.

تابع handleAll به شکل زیر است:

(options: FetchEvent | HandlerCallbackOptions) => {...}

تابع constructor به صورت زیر است:

(options?: StrategyOptions) => {...}

تابع _awaitComplete به شکل زیر است:

(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _getResponse به شکل زیر است:

(handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

یک استراتژی درخواست را اجرا کنید و یک Promise را برمی‌گرداند که با یک Response حل می‌شود و همه تماس‌های مربوط به افزونه را فراخوانی می‌کند.

هنگامی که یک نمونه استراتژی با Workbox workbox-routing.Route ثبت می شود، این روش به طور خودکار زمانی که مسیر مطابقت دارد فراخوانی می شود.

از طرف دیگر، این روش را می توان در یک شنونده مستقل FetchEvent با ارسال آن به event.respondWith() استفاده کرد.

تابع handle به نظر می رسد:

(options: FetchEvent | HandlerCallbackOptions) => {...}

مشابه workbox-strategies.Strategy~handle ، اما به جای اینکه فقط یک Promise برگرداند که به یک Response آن را حل می کند، چندین وعده [response, done] را برمی گرداند، که در آن ( response ) قبلی معادل چیزی است که handle() برمی گرداند. و دومی یک Promise است که پس از تکمیل هر وعده‌ای که به event.waitUntil() به عنوان بخشی از اجرای استراتژی تکمیل شد، برطرف می‌شود.

شما می توانید منتظر وعده done باشید تا مطمئن شوید که هر کار اضافی انجام شده توسط استراتژی (معمولاً پاسخ های حافظه پنهان) با موفقیت کامل می شود.

تابع handleAll به شکل زیر است:

(options: FetchEvent | HandlerCallbackOptions) => {...}

یک نمونه جدید از استراتژی ایجاد می کند و تمام ویژگی های گزینه مستند شده را به عنوان ویژگی های نمونه عمومی تنظیم می کند.

نکته: اگر یک کلاس استراتژی سفارشی کلاس Strategy پایه را گسترش دهد و به بیشتر از این ویژگی ها نیاز نداشته باشد، نیازی به تعریف سازنده خود ندارد.

تابع constructor به صورت زیر است:

(options?: StrategyOptions) => {...}

تابع _awaitComplete به شکل زیر است:

(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _getResponse به شکل زیر است:

(handler: StrategyHandler, request: Request, event: ExtendableEvent) => {...}

تابع _handle به شکل زیر است:

(request: Request, handler: StrategyHandler) => {...}

یک استراتژی درخواست را اجرا کنید و یک Promise را برمی‌گرداند که با یک Response حل می‌شود و همه تماس‌های مربوط به افزونه را فراخوانی می‌کند.

هنگامی که یک نمونه استراتژی با Workbox workbox-routing.Route ثبت می شود، این روش به طور خودکار زمانی که مسیر مطابقت دارد فراخوانی می شود.

از طرف دیگر، این روش را می توان در یک شنونده مستقل FetchEvent با ارسال آن به event.respondWith() استفاده کرد.

تابع handle به نظر می رسد:

(options: FetchEvent | HandlerCallbackOptions) => {...}

مشابه workbox-strategies.Strategy~handle ، اما به جای اینکه فقط یک Promise برگرداند که به یک Response آن را حل می کند، چندین وعده [response, done] را برمی گرداند، که در آن ( response ) قبلی معادل چیزی است که handle() برمی گرداند. و دومی یک Promise است که پس از تکمیل هر وعده‌ای که به event.waitUntil() به عنوان بخشی از اجرای استراتژی تکمیل شد، برطرف می‌شود.

شما می توانید منتظر وعده done باشید تا مطمئن شوید که هر کار اضافی انجام شده توسط استراتژی (معمولاً پاسخ های حافظه پنهان) با موفقیت کامل می شود.

تابع handleAll به شکل زیر است:

(options: FetchEvent | HandlerCallbackOptions) => {...}

یک نمونه جدید مرتبط با استراتژی و رویدادی که درخواست را مدیریت می کند ایجاد می کند.

سازنده همچنین حالتی را که به هر یک از پلاگین هایی که این درخواست را مدیریت می کنند ارسال می کند مقداردهی اولیه می کند.

تابع constructor به صورت زیر است:

(strategy: Strategy, options: HandlerCallbackOptions) => {...}

با استفاده از cacheName ، matchOptions و plugins تعریف‌شده روی شی استراتژی، درخواستی را از حافظه پنهان مطابقت می‌دهد (و همه روش‌های مربوط به تماس پلاگین را فراخوانی می‌کند).

روش‌های چرخه عمر افزونه زیر هنگام استفاده از این روش فراخوانی می‌شوند:

• cacheKeyWillBeUsed()
• cachedResponseWillBeUsed()

تابع cacheMatch به نظر می رسد:

(key: RequestInfo) => {...}

یک جفت درخواست/پاسخ را با استفاده از cacheName و plugins تعریف‌شده روی شی استراتژی، در حافظه پنهان قرار می‌دهد (و همه روش‌های برگشت تماس پلاگین قابل اجرا را فراخوانی می‌کند).

روش‌های چرخه عمر افزونه زیر هنگام استفاده از این روش فراخوانی می‌شوند:

• cacheKeyWillBeUsed()
• cacheWillUpdate()
• cacheDidUpdate()

تابع cachePut به نظر می رسد:

(key: RequestInfo, response: Response) => {...}

اجرای استراتژی را متوقف می‌کند و فوراً هرگونه وعده‌های منتظر مانده waitUntil() را حل می‌کند.

تابع destroy به صورت زیر است:

() => {...}

یک وعده را برمی‌گرداند که پس از ارسال همه وعده‌ها به workbox-strategies.StrategyHandler~waitUntil حل شود.

توجه: هر کاری که پس از تسویه doneWaiting() انجام می شود، باید به صورت دستی به متد waitUntil() رویداد منتقل شود (نه متد waitUntil() این handler)، در غیر این صورت تاپیک کارگر سرویس قبل از تکمیل کار شما کشته شود.

تابع doneWaiting به شکل زیر است:

() => {...}

با استفاده از fetchOptions (برای درخواست‌های غیر ناوبری) و plugins تعریف‌شده روی شی Strategy یک درخواست معین را واکشی می‌کند (و هر روش پاسخ به تماس پلاگین قابل اجرا را فراخوانی می‌کند).

روش‌های چرخه عمر افزونه زیر هنگام استفاده از این روش فراخوانی می‌شوند:

• requestWillFetch()
• fetchDidSucceed()
• fetchDidFail()

تابع fetch به نظر می رسد:

(input: RequestInfo) => {...}

this.fetch() را فراخوانی می کند و (در پس زمینه) this.cachePut() را روی پاسخ ایجاد شده توسط this.fetch() اجرا می کند.

فراخوانی به this.cachePut() به طور خودکار this.waitUntil() را فراخوانی می کند، بنابراین شما مجبور نیستید به صورت دستی waitUntil() در رویداد فراخوانی کنید.

تابع fetchAndCachePut به نظر می رسد:

(input: RequestInfo) => {...}

فهرست پلاگین‌ها را برای cacheKeyWillBeUsed بررسی می‌کند و هر یک از آن تماس‌های موجود را به ترتیب اجرا می‌کند. شیء Request نهایی که توسط آخرین افزونه برگردانده می شود به عنوان کلید کش برای خواندن و/یا نوشتن حافظه پنهان در نظر گرفته می شود. اگر هیچ پاسخ تماسی برای افزونه cacheKeyWillBeUsed ثبت نشده باشد، درخواست ارسال شده بدون تغییر بازگردانده می شود.

تابع getCacheKey به شکل زیر است:

(request: Request, mode: "read" 
  | "write" 
 ) => {...}

اگر استراتژی حداقل یک افزونه با پاسخ تماس داده شده داشته باشد، درست برمی گردد.

تابع hasCallback به نظر می رسد:

(name: C) => {...}

پاسخ به تماس را می‌پذیرد و تعداد تکرار تماس‌های پلاگین منطبق را برمی‌گرداند، که در آن هر تماس با وضعیت کنترل‌کننده فعلی قرار می‌گیرد (یعنی وقتی هر پاسخ تماسی را فراخوانی می‌کنید، هر پارامتر شی را که ارسال کنید، با وضعیت فعلی افزونه ادغام می‌شود).

تابع iterateCallbacks به نظر می رسد:

(name: C) => {...}

همه فراخوان‌های پلاگین مطابق با نام داده شده را به ترتیب اجرا می‌کند و شیء پارامتر داده شده (ادغام شده با وضعیت فعلی افزونه) را به عنوان تنها آرگومان ارسال می‌کند.

توجه: از آنجایی که این روش همه پلاگین ها را اجرا می کند، برای مواردی که باید قبل از فراخوانی تماس بعدی، مقدار برگشتی یک callback اعمال شود، مناسب نیست. برای نحوه رسیدگی به این مورد، workbox-strategies.StrategyHandler#iterateCallbacks در زیر ببینید.

تابع runCallbacks به نظر می رسد:

(name: C, param: Omit<indexedAccess"state" 
 >) => {...}

یک قول به [extend lifetime-promises] https://w3c.github.io/ServiceWorker/#extendableevent-extend-lifetime-promises رویداد رویداد مرتبط با درخواست در حال رسیدگی (معمولاً FetchEvent ) اضافه می کند.

توجه: می‌توانید منتظر workbox-strategies.StrategyHandler~doneWaiting برای دانستن اینکه چه زمانی تمام وعده‌های اضافه شده تسویه شده‌اند.

تابع waitUntil به نظر می رسد:

(promise: Promise<T>) => {...}