StaleWhileRevalidate

Class @vite-pwa/workbox-swkit/strategies

An implementation of a stale-while-revalidate request strategy.

Resources are requested from both the cache and the network in parallel. The strategy will respond with the cached version if available, otherwise wait for the network response. The cache is updated with the network response with each successful request.

By default, this strategy will cache responses with a 200 status code as well as opaque responses. Opaque responses are cross-origin requests where the response doesn't support CORS.

If the network request fails, and there is no cache match, this will throw a WorkboxError exception.

Constructor

new StaleWhileRevalidate(options?: StrategyOptions)

Properties

Property	Type	Default	Description
cacheName	string
fetchOptions?	RequestInit
matchOptions?	CacheQueryOptions
plugins	WorkboxPlugin[]

Methods

_awaitComplete()

_awaitComplete(responseDone: Promise<Response>, handler: StrategyHandler, request: Request, event: ExtendableEvent): Promise<void>

_getResponse()

_getResponse(handler: StrategyHandler, request: Request, event: ExtendableEvent): Promise<Response>

handle()

handle(options: HandlerCallbackOptions | FetchEvent): Promise<Response>

Perform a request strategy and returns a Promise that will resolve with a Response, invoking all relevant plugin callbacks.

When a strategy instance is registered with a Workbox workbox-routing.Route, this method is automatically called when the route matches.

Alternatively, this method can be used in a standalone FetchEvent listener by passing it to event.respondWith().

Parameters

• options – A FetchEvent or an object with the properties listed below.

handleAll()

handleAll(options: HandlerCallbackOptions | FetchEvent): [Promise<Response>, Promise<void>]

Similar to workbox-strategies.Strategy~handle, but instead of just returning a Promise that resolves to a Response it it will return an tuple of [response, done] promises, where the former (response) is equivalent to what handle() returns, and the latter is a Promise that will resolve once any promises that were added to event.waitUntil() as part of performing the strategy have completed.

You can await the done promise to ensure any extra work performed by the strategy (usually caching responses) completes successfully.

Parameters

• options – A FetchEvent or an object with the properties listed below.

Returns: A tuple of [response, done] promises that can be used to determine when the response resolves as well as when the handler has completed all its work.