runtime-caching-converter.js 6.38 KB
"use strict";
/*
  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.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.runtimeCachingConverter = void 0;
const common_tags_1 = require("common-tags");
const errors_1 = require("./errors");
const stringify_without_comments_1 = require("./stringify-without-comments");
/**
 * Given a set of options that configures runtime caching behavior, convert it
 * to the equivalent Workbox method calls.
 *
 * @param {ModuleRegistry} moduleRegistry
 * @param {Object} options See
 *        https://developers.google.com/web/tools/workbox/modules/workbox-build#generateSW-runtimeCaching
 * @return {string} A JSON string representing the equivalent options.
 *
 * @private
 */
function getOptionsString(moduleRegistry, options = {}) {
    const plugins = [];
    const handlerOptions = {};
    for (const optionName of Object.keys(options)) {
        if (options[optionName] === undefined) {
            continue;
        }
        switch (optionName) {
            // Using a library here because JSON.stringify won't handle functions.
            case 'plugins': {
                plugins.push(...options.plugins.map(stringify_without_comments_1.stringifyWithoutComments));
                break;
            }
            // These are the option properties that we want to pull out, so that
            // they're passed to the handler constructor.
            case 'cacheName':
            case 'networkTimeoutSeconds':
            case 'fetchOptions':
            case 'matchOptions': {
                handlerOptions[optionName] = options[optionName];
                break;
            }
            // The following cases are all shorthands for creating a plugin with a
            // given configuration.
            case 'backgroundSync': {
                const name = options.backgroundSync.name;
                const plugin = moduleRegistry.use('workbox-background-sync', 'BackgroundSyncPlugin');
                let pluginCode = `new ${plugin}(${JSON.stringify(name)}`;
                if (options.backgroundSync.options) {
                    pluginCode += `, ${(0, stringify_without_comments_1.stringifyWithoutComments)(options.backgroundSync.options)}`;
                }
                pluginCode += `)`;
                plugins.push(pluginCode);
                break;
            }
            case 'broadcastUpdate': {
                const channelName = options.broadcastUpdate.channelName;
                const opts = Object.assign({ channelName }, options.broadcastUpdate.options);
                const plugin = moduleRegistry.use('workbox-broadcast-update', 'BroadcastUpdatePlugin');
                plugins.push(`new ${plugin}(${(0, stringify_without_comments_1.stringifyWithoutComments)(opts)})`);
                break;
            }
            case 'cacheableResponse': {
                const plugin = moduleRegistry.use('workbox-cacheable-response', 'CacheableResponsePlugin');
                plugins.push(`new ${plugin}(${(0, stringify_without_comments_1.stringifyWithoutComments)(options.cacheableResponse)})`);
                break;
            }
            case 'expiration': {
                const plugin = moduleRegistry.use('workbox-expiration', 'ExpirationPlugin');
                plugins.push(`new ${plugin}(${(0, stringify_without_comments_1.stringifyWithoutComments)(options.expiration)})`);
                break;
            }
            case 'precacheFallback': {
                const plugin = moduleRegistry.use('workbox-precaching', 'PrecacheFallbackPlugin');
                plugins.push(`new ${plugin}(${(0, stringify_without_comments_1.stringifyWithoutComments)(options.precacheFallback)})`);
                break;
            }
            case 'rangeRequests': {
                const plugin = moduleRegistry.use('workbox-range-requests', 'RangeRequestsPlugin');
                // There are no configuration options for the constructor.
                plugins.push(`new ${plugin}()`);
                break;
            }
            default: {
                throw new Error(
                // In the default case optionName is typed as 'never'.
                // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
                `${errors_1.errors['bad-runtime-caching-config']} ${optionName}`);
            }
        }
    }
    if (Object.keys(handlerOptions).length > 0 || plugins.length > 0) {
        const optionsString = JSON.stringify(handlerOptions).slice(1, -1);
        return (0, common_tags_1.oneLine) `{
      ${optionsString ? optionsString + ',' : ''}
      plugins: [${plugins.join(', ')}]
    }`;
    }
    else {
        return '';
    }
}
function runtimeCachingConverter(moduleRegistry, runtimeCaching) {
    return runtimeCaching
        .map((entry) => {
        const method = entry.method || 'GET';
        if (!entry.urlPattern) {
            throw new Error(errors_1.errors['urlPattern-is-required']);
        }
        if (!entry.handler) {
            throw new Error(errors_1.errors['handler-is-required']);
        }
        if (entry.options &&
            entry.options.networkTimeoutSeconds &&
            entry.handler !== 'NetworkFirst') {
            throw new Error(errors_1.errors['invalid-network-timeout-seconds']);
        }
        // urlPattern might be a string, a RegExp object, or a function.
        // If it's a string, it needs to be quoted.
        const matcher = typeof entry.urlPattern === 'string'
            ? JSON.stringify(entry.urlPattern)
            : entry.urlPattern;
        const registerRoute = moduleRegistry.use('workbox-routing', 'registerRoute');
        if (typeof entry.handler === 'string') {
            const optionsString = getOptionsString(moduleRegistry, entry.options);
            const handler = moduleRegistry.use('workbox-strategies', entry.handler);
            const strategyString = `new ${handler}(${optionsString})`;
            return `${registerRoute}(${matcher.toString()}, ${strategyString}, '${method}');\n`;
        }
        else if (typeof entry.handler === 'function') {
            return `${registerRoute}(${matcher.toString()}, ${entry.handler.toString()}, '${method}');\n`;
        }
        // '' will be filtered out.
        return '';
    })
        .filter((entry) => Boolean(entry));
}
exports.runtimeCachingConverter = runtimeCachingConverter;