this.workbox = this.workbox || {}; this.workbox.strategies = (function (exports, assert_js, cacheNames_js, cacheWrapper_js, fetchWrapper_js, getFriendlyURL_js, logger_js, WorkboxError_js) { 'use strict'; try { self['workbox:strategies:5.1.4'] && _(); } catch (e) {} /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ const messages = { strategyStart: (strategyName, request) => `Using ${strategyName} to respond to '${getFriendlyURL_js.getFriendlyURL(request.url)}'`, printFinalResponse: response => { if (response) { logger_js.logger.groupCollapsed(`View the final response here.`); logger_js.logger.log(response || '[No response returned]'); logger_js.logger.groupEnd(); } } }; /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ /** * An implementation of a [cache-first]{@link https://developers.google.com/web/fundamentals/instant-and-offline/offline-cookbook/#cache-falling-back-to-network} * request strategy. * * A cache first strategy is useful for assets that have been revisioned, * such as URLs like `/styles/example.a8f5f1.css`, since they * can be cached for long periods of time. * * If the network request fails, and there is no cache match, this will throw * a `WorkboxError` exception. * * @memberof module:workbox-strategies */ class CacheFirst { /** * @param {Object} options * @param {string} options.cacheName Cache name to store and retrieve * requests. Defaults to cache names provided by * [workbox-core]{@link module:workbox-core.cacheNames}. * @param {Array} options.plugins [Plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins} * to use in conjunction with this caching strategy. * @param {Object} options.fetchOptions Values passed along to the * [`init`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters) * of all fetch() requests made by this strategy. * @param {Object} options.matchOptions [`CacheQueryOptions`](https://w3c.github.io/ServiceWorker/#dictdef-cachequeryoptions) */ constructor(options = {}) { this._cacheName = cacheNames_js.cacheNames.getRuntimeName(options.cacheName); this._plugins = options.plugins || []; this._fetchOptions = options.fetchOptions; this._matchOptions = options.matchOptions; } /** * This method will perform a request strategy and follows an API that * will work with the * [Workbox Router]{@link module:workbox-routing.Router}. * * @param {Object} options * @param {Request|string} options.request A request to run this strategy for. * @param {Event} [options.event] The event that triggered the request. * @return {Promise} */ async handle({ event, request }) { const logs = []; if (typeof request === 'string') { request = new Request(request); } { assert_js.assert.isInstance(request, Request, { moduleName: 'workbox-strategies', className: 'CacheFirst', funcName: 'makeRequest', paramName: 'request' }); } let response = await cacheWrapper_js.cacheWrapper.match({ cacheName: this._cacheName, request, event, matchOptions: this._matchOptions, plugins: this._plugins }); let error; if (!response) { { logs.push(`No response found in the '${this._cacheName}' cache. ` + `Will respond with a network request.`); } try { response = await this._getFromNetwork(request, event); } catch (err) { error = err; } { if (response) { logs.push(`Got response from network.`); } else { logs.push(`Unable to get a response from the network.`); } } } else { { logs.push(`Found a cached response in the '${this._cacheName}' cache.`); } } { logger_js.logger.groupCollapsed(messages.strategyStart('CacheFirst', request)); for (const log of logs) { logger_js.logger.log(log); } messages.printFinalResponse(response); logger_js.logger.groupEnd(); } if (!response) { throw new WorkboxError_js.WorkboxError('no-response', { url: request.url, error }); } return response; } /** * Handles the network and cache part of CacheFirst. * * @param {Request} request * @param {Event} [event] * @return {Promise} * * @private */ async _getFromNetwork(request, event) { const response = await fetchWrapper_js.fetchWrapper.fetch({ request, event, fetchOptions: this._fetchOptions, plugins: this._plugins }); // Keep the service worker while we put the request to the cache const responseClone = response.clone(); const cachePutPromise = cacheWrapper_js.cacheWrapper.put({ cacheName: this._cacheName, request, response: responseClone, event, plugins: this._plugins }); if (event) { try { event.waitUntil(cachePutPromise); } catch (error) { { logger_js.logger.warn(`Unable to ensure service worker stays alive when ` + `updating cache for '${getFriendlyURL_js.getFriendlyURL(request.url)}'.`); } } } return response; } } /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ /** * An implementation of a * [cache-only]{@link https://developers.google.com/web/fundamentals/instant-and-offline/offline-cookbook/#cache-only} * request strategy. * * This class is useful if you want to take advantage of any * [Workbox plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins}. * * If there is no cache match, this will throw a `WorkboxError` exception. * * @memberof module:workbox-strategies */ class CacheOnly { /** * @param {Object} options * @param {string} options.cacheName Cache name to store and retrieve * requests. Defaults to cache names provided by * [workbox-core]{@link module:workbox-core.cacheNames}. * @param {Array} options.plugins [Plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins} * to use in conjunction with this caching strategy. * @param {Object} options.matchOptions [`CacheQueryOptions`](https://w3c.github.io/ServiceWorker/#dictdef-cachequeryoptions) */ constructor(options = {}) { this._cacheName = cacheNames_js.cacheNames.getRuntimeName(options.cacheName); this._plugins = options.plugins || []; this._matchOptions = options.matchOptions; } /** * This method will perform a request strategy and follows an API that * will work with the * [Workbox Router]{@link module:workbox-routing.Router}. * * @param {Object} options * @param {Request|string} options.request A request to run this strategy for. * @param {Event} [options.event] The event that triggered the request. * @return {Promise} */ async handle({ event, request }) { if (typeof request === 'string') { request = new Request(request); } { assert_js.assert.isInstance(request, Request, { moduleName: 'workbox-strategies', className: 'CacheOnly', funcName: 'makeRequest', paramName: 'request' }); } const response = await cacheWrapper_js.cacheWrapper.match({ cacheName: this._cacheName, request, event, matchOptions: this._matchOptions, plugins: this._plugins }); { logger_js.logger.groupCollapsed(messages.strategyStart('CacheOnly', request)); if (response) { logger_js.logger.log(`Found a cached response in the '${this._cacheName}'` + ` cache.`); messages.printFinalResponse(response); } else { logger_js.logger.log(`No response found in the '${this._cacheName}' cache.`); } logger_js.logger.groupEnd(); } if (!response) { throw new WorkboxError_js.WorkboxError('no-response', { url: request.url }); } return response; } } /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ const cacheOkAndOpaquePlugin = { /** * Returns a valid response (to allow caching) if the status is 200 (OK) or * 0 (opaque). * * @param {Object} options * @param {Response} options.response * @return {Response|null} * * @private */ cacheWillUpdate: async ({ response }) => { if (response.status === 200 || response.status === 0) { return response; } return null; } }; /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ /** * An implementation of a * [network first]{@link https://developers.google.com/web/fundamentals/instant-and-offline/offline-cookbook/#network-falling-back-to-cache} * request strategy. * * By default, this strategy will cache responses with a 200 status code as * well as [opaque responses]{@link https://developers.google.com/web/tools/workbox/guides/handle-third-party-requests}. * Opaque responses are are cross-origin requests where the response doesn't * support [CORS]{@link https://enable-cors.org/}. * * If the network request fails, and there is no cache match, this will throw * a `WorkboxError` exception. * * @memberof module:workbox-strategies */ class NetworkFirst { /** * @param {Object} options * @param {string} options.cacheName Cache name to store and retrieve * requests. Defaults to cache names provided by * [workbox-core]{@link module:workbox-core.cacheNames}. * @param {Array} options.plugins [Plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins} * to use in conjunction with this caching strategy. * @param {Object} options.fetchOptions Values passed along to the * [`init`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters) * of all fetch() requests made by this strategy. * @param {Object} options.matchOptions [`CacheQueryOptions`](https://w3c.github.io/ServiceWorker/#dictdef-cachequeryoptions) * @param {number} options.networkTimeoutSeconds If set, any network requests * that fail to respond within the timeout will fallback to the cache. * * This option can be used to combat * "[lie-fi]{@link https://developers.google.com/web/fundamentals/performance/poor-connectivity/#lie-fi}" * scenarios. */ constructor(options = {}) { this._cacheName = cacheNames_js.cacheNames.getRuntimeName(options.cacheName); if (options.plugins) { const isUsingCacheWillUpdate = options.plugins.some(plugin => !!plugin.cacheWillUpdate); this._plugins = isUsingCacheWillUpdate ? options.plugins : [cacheOkAndOpaquePlugin, ...options.plugins]; } else { // No plugins passed in, use the default plugin. this._plugins = [cacheOkAndOpaquePlugin]; } this._networkTimeoutSeconds = options.networkTimeoutSeconds || 0; { if (this._networkTimeoutSeconds) { assert_js.assert.isType(this._networkTimeoutSeconds, 'number', { moduleName: 'workbox-strategies', className: 'NetworkFirst', funcName: 'constructor', paramName: 'networkTimeoutSeconds' }); } } this._fetchOptions = options.fetchOptions; this._matchOptions = options.matchOptions; } /** * This method will perform a request strategy and follows an API that * will work with the * [Workbox Router]{@link module:workbox-routing.Router}. * * @param {Object} options * @param {Request|string} options.request A request to run this strategy for. * @param {Event} [options.event] The event that triggered the request. * @return {Promise} */ async handle({ event, request }) { const logs = []; if (typeof request === 'string') { request = new Request(request); } { assert_js.assert.isInstance(request, Request, { moduleName: 'workbox-strategies', className: 'NetworkFirst', funcName: 'handle', paramName: 'makeRequest' }); } const promises = []; let timeoutId; if (this._networkTimeoutSeconds) { const { id, promise } = this._getTimeoutPromise({ request, event, logs }); timeoutId = id; promises.push(promise); } const networkPromise = this._getNetworkPromise({ timeoutId, request, event, logs }); promises.push(networkPromise); // Promise.race() will resolve as soon as the first promise resolves. let response = await Promise.race(promises); // If Promise.race() resolved with null, it might be due to a network // timeout + a cache miss. If that were to happen, we'd rather wait until // the networkPromise resolves instead of returning null. // Note that it's fine to await an already-resolved promise, so we don't // have to check to see if it's still "in flight". if (!response) { response = await networkPromise; } { logger_js.logger.groupCollapsed(messages.strategyStart('NetworkFirst', request)); for (const log of logs) { logger_js.logger.log(log); } messages.printFinalResponse(response); logger_js.logger.groupEnd(); } if (!response) { throw new WorkboxError_js.WorkboxError('no-response', { url: request.url }); } return response; } /** * @param {Object} options * @param {Request} options.request * @param {Array} options.logs A reference to the logs array * @param {Event} [options.event] * @return {Promise} * * @private */ _getTimeoutPromise({ request, logs, event }) { let timeoutId; const timeoutPromise = new Promise(resolve => { const onNetworkTimeout = async () => { { logs.push(`Timing out the network response at ` + `${this._networkTimeoutSeconds} seconds.`); } resolve(await this._respondFromCache({ request, event })); }; timeoutId = setTimeout(onNetworkTimeout, this._networkTimeoutSeconds * 1000); }); return { promise: timeoutPromise, id: timeoutId }; } /** * @param {Object} options * @param {number|undefined} options.timeoutId * @param {Request} options.request * @param {Array} options.logs A reference to the logs Array. * @param {Event} [options.event] * @return {Promise} * * @private */ async _getNetworkPromise({ timeoutId, request, logs, event }) { let error; let response; try { response = await fetchWrapper_js.fetchWrapper.fetch({ request, event, fetchOptions: this._fetchOptions, plugins: this._plugins }); } catch (err) { error = err; } if (timeoutId) { clearTimeout(timeoutId); } { if (response) { logs.push(`Got response from network.`); } else { logs.push(`Unable to get a response from the network. Will respond ` + `with a cached response.`); } } if (error || !response) { response = await this._respondFromCache({ request, event }); { if (response) { logs.push(`Found a cached response in the '${this._cacheName}'` + ` cache.`); } else { logs.push(`No response found in the '${this._cacheName}' cache.`); } } } else { // Keep the service worker alive while we put the request in the cache const responseClone = response.clone(); const cachePut = cacheWrapper_js.cacheWrapper.put({ cacheName: this._cacheName, request, response: responseClone, event, plugins: this._plugins }); if (event) { try { // The event has been responded to so we can keep the SW alive to // respond to the request event.waitUntil(cachePut); } catch (err) { { logger_js.logger.warn(`Unable to ensure service worker stays alive when ` + `updating cache for '${getFriendlyURL_js.getFriendlyURL(request.url)}'.`); } } } } return response; } /** * Used if the network timeouts or fails to make the request. * * @param {Object} options * @param {Request} request The request to match in the cache * @param {Event} [options.event] * @return {Promise} * * @private */ _respondFromCache({ event, request }) { return cacheWrapper_js.cacheWrapper.match({ cacheName: this._cacheName, request, event, matchOptions: this._matchOptions, plugins: this._plugins }); } } /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ /** * An implementation of a * [network-only]{@link https://developers.google.com/web/fundamentals/instant-and-offline/offline-cookbook/#network-only} * request strategy. * * This class is useful if you want to take advantage of any * [Workbox plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins}. * * If the network request fails, this will throw a `WorkboxError` exception. * * @memberof module:workbox-strategies */ class NetworkOnly { /** * @param {Object} options * @param {string} options.cacheName Cache name to store and retrieve * requests. Defaults to cache names provided by * [workbox-core]{@link module:workbox-core.cacheNames}. * @param {Array} options.plugins [Plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins} * to use in conjunction with this caching strategy. * @param {Object} options.fetchOptions Values passed along to the * [`init`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters) * of all fetch() requests made by this strategy. */ constructor(options = {}) { this._plugins = options.plugins || []; this._fetchOptions = options.fetchOptions; } /** * This method will perform a request strategy and follows an API that * will work with the * [Workbox Router]{@link module:workbox-routing.Router}. * * @param {Object} options * @param {Request|string} options.request The request to run this strategy for. * @param {Event} [options.event] The event that triggered the request. * @return {Promise} */ async handle({ event, request }) { if (typeof request === 'string') { request = new Request(request); } { assert_js.assert.isInstance(request, Request, { moduleName: 'workbox-strategies', className: 'NetworkOnly', funcName: 'handle', paramName: 'request' }); } let error; let response; try { response = await fetchWrapper_js.fetchWrapper.fetch({ request, event, fetchOptions: this._fetchOptions, plugins: this._plugins }); } catch (err) { error = err; } { logger_js.logger.groupCollapsed(messages.strategyStart('NetworkOnly', request)); if (response) { logger_js.logger.log(`Got response from network.`); } else { logger_js.logger.log(`Unable to get a response from the network.`); } messages.printFinalResponse(response); logger_js.logger.groupEnd(); } if (!response) { throw new WorkboxError_js.WorkboxError('no-response', { url: request.url, error }); } return response; } } /* Copyright 2018 Google LLC Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT. */ /** * An implementation of a * [stale-while-revalidate]{@link https://developers.google.com/web/fundamentals/instant-and-offline/offline-cookbook/#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]{@link https://developers.google.com/web/tools/workbox/guides/handle-third-party-requests}. * Opaque responses are cross-origin requests where the response doesn't * support [CORS]{@link https://enable-cors.org/}. * * If the network request fails, and there is no cache match, this will throw * a `WorkboxError` exception. * * @memberof module:workbox-strategies */ class StaleWhileRevalidate { /** * @param {Object} options * @param {string} options.cacheName Cache name to store and retrieve * requests. Defaults to cache names provided by * [workbox-core]{@link module:workbox-core.cacheNames}. * @param {Array} options.plugins [Plugins]{@link https://developers.google.com/web/tools/workbox/guides/using-plugins} * to use in conjunction with this caching strategy. * @param {Object} options.fetchOptions Values passed along to the * [`init`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters) * of all fetch() requests made by this strategy. * @param {Object} options.matchOptions [`CacheQueryOptions`](https://w3c.github.io/ServiceWorker/#dictdef-cachequeryoptions) */ constructor(options = {}) { this._cacheName = cacheNames_js.cacheNames.getRuntimeName(options.cacheName); this._plugins = options.plugins || []; if (options.plugins) { const isUsingCacheWillUpdate = options.plugins.some(plugin => !!plugin.cacheWillUpdate); this._plugins = isUsingCacheWillUpdate ? options.plugins : [cacheOkAndOpaquePlugin, ...options.plugins]; } else { // No plugins passed in, use the default plugin. this._plugins = [cacheOkAndOpaquePlugin]; } this._fetchOptions = options.fetchOptions; this._matchOptions = options.matchOptions; } /** * This method will perform a request strategy and follows an API that * will work with the * [Workbox Router]{@link module:workbox-routing.Router}. * * @param {Object} options * @param {Request|string} options.request A request to run this strategy for. * @param {Event} [options.event] The event that triggered the request. * @return {Promise} */ async handle({ event, request }) { const logs = []; if (typeof request === 'string') { request = new Request(request); } { assert_js.assert.isInstance(request, Request, { moduleName: 'workbox-strategies', className: 'StaleWhileRevalidate', funcName: 'handle', paramName: 'request' }); } const fetchAndCachePromise = this._getFromNetwork({ request, event }); let response = await cacheWrapper_js.cacheWrapper.match({ cacheName: this._cacheName, request, event, matchOptions: this._matchOptions, plugins: this._plugins }); let error; if (response) { { logs.push(`Found a cached response in the '${this._cacheName}'` + ` cache. Will update with the network response in the background.`); } if (event) { try { event.waitUntil(fetchAndCachePromise); } catch (error) { { logger_js.logger.warn(`Unable to ensure service worker stays alive when ` + `updating cache for '${getFriendlyURL_js.getFriendlyURL(request.url)}'.`); } } } } else { { logs.push(`No response found in the '${this._cacheName}' cache. ` + `Will wait for the network response.`); } try { response = await fetchAndCachePromise; } catch (err) { error = err; } } { logger_js.logger.groupCollapsed(messages.strategyStart('StaleWhileRevalidate', request)); for (const log of logs) { logger_js.logger.log(log); } messages.printFinalResponse(response); logger_js.logger.groupEnd(); } if (!response) { throw new WorkboxError_js.WorkboxError('no-response', { url: request.url, error }); } return response; } /** * @param {Object} options * @param {Request} options.request * @param {Event} [options.event] * @return {Promise} * * @private */ async _getFromNetwork({ request, event }) { const response = await fetchWrapper_js.fetchWrapper.fetch({ request, event, fetchOptions: this._fetchOptions, plugins: this._plugins }); const cachePutPromise = cacheWrapper_js.cacheWrapper.put({ cacheName: this._cacheName, request, response: response.clone(), event, plugins: this._plugins }); if (event) { try { event.waitUntil(cachePutPromise); } catch (error) { { logger_js.logger.warn(`Unable to ensure service worker stays alive when ` + `updating cache for '${getFriendlyURL_js.getFriendlyURL(request.url)}'.`); } } } return response; } } exports.CacheFirst = CacheFirst; exports.CacheOnly = CacheOnly; exports.NetworkFirst = NetworkFirst; exports.NetworkOnly = NetworkOnly; exports.StaleWhileRevalidate = StaleWhileRevalidate; return exports; }({}, workbox.core._private, workbox.core._private, workbox.core._private, workbox.core._private, workbox.core._private, workbox.core._private, workbox.core._private));