/* Copyright 2018 Google Inc. All Rights Reserved. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ import {cacheNames} from 'workbox-core/_private/cacheNames.mjs'; import {fetchWrapper} from 'workbox-core/_private/fetchWrapper.mjs'; import {assert} from 'workbox-core/_private/assert.mjs'; import {logger} from 'workbox-core/_private/logger.mjs'; import messages from './utils/messages.mjs'; import './_version.mjs'; /** * 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}. * * @memberof 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 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._cacheName = cacheNames.getRuntimeName(options.cacheName); this._plugins = options.plugins || []; this._fetchOptions = options.fetchOptions || null; } /** * This method will perform a request strategy and follows an API that * will work with the * [Workbox Router]{@link workbox.routing.Router}. * * @param {Object} options * @param {FetchEvent} options.event The fetch event to run this strategy * against. * @return {Promise} */ async handle({event}) { if (process.env.NODE_ENV !== 'production') { assert.isInstance(event, FetchEvent, { moduleName: 'workbox-strategies', className: 'NetworkOnly', funcName: 'handle', paramName: 'event', }); } return this.makeRequest({ event, request: event.request, }); } /** * This method can be used to perform a make a standalone request outside the * context of the [Workbox Router]{@link workbox.routing.Router}. * * See "[Advanced Recipes](https://developers.google.com/web/tools/workbox/guides/advanced-recipes#make-requests)" * for more usage information. * * @param {Object} options * @param {Request|string} options.request Either a * [`Request`]{@link https://developer.mozilla.org/en-US/docs/Web/API/Request} * object, or a string URL, corresponding to the request to be made. * @param {FetchEvent} [options.event] If provided, `event.waitUntil()` will * be called automatically to extend the service worker's lifetime. * @return {Promise} */ async makeRequest({event, request}) { if (typeof request === 'string') { request = new Request(request); } if (process.env.NODE_ENV !== 'production') { assert.isInstance(request, Request, { moduleName: 'workbox-strategies', className: 'NetworkOnly', funcName: 'handle', paramName: 'request', }); } let error; let response; try { response = await fetchWrapper.fetch({ request, event, fetchOptions: this._fetchOptions, plugins: this._plugins, }); } catch (err) { error = err; } if (process.env.NODE_ENV !== 'production') { logger.groupCollapsed( messages.strategyStart('NetworkOnly', request)); if (response) { logger.log(`Got response from network.`); } else { logger.log(`Unable to get a response from the network.`); } messages.printFinalResponse(response); logger.groupEnd(); } // If there was an error thrown, re-throw it to ensure the Routers // catch handler is triggered. if (error) { throw error; } return response; } } export {NetworkOnly};