populate-sw-template.js 3.18 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.
*/
const template = require('lodash.template');

const swTemplate = require('../templates/sw-template');

const errors = require('./errors');

const ModuleRegistry = require('./module-registry');

const runtimeCachingConverter = require('./runtime-caching-converter');

const stringifyWithoutComments = require('./stringify-without-comments');

module.exports = ({
  cacheId,
  cleanupOutdatedCaches,
  clientsClaim,
  directoryIndex,
  disableDevLogs,
  ignoreURLParametersMatching,
  importScripts,
  manifestEntries = [],
  navigateFallback,
  navigateFallbackDenylist,
  navigateFallbackAllowlist,
  navigationPreload,
  offlineGoogleAnalytics,
  runtimeCaching = [],
  skipWaiting
}) => {
  // There needs to be at least something to precache, or else runtime caching.
  if (!(manifestEntries.length > 0 || runtimeCaching.length > 0)) {
    throw new Error(errors['no-manifest-entries-or-runtime-caching']);
  } // These are all options that can be passed to the precacheAndRoute() method.


  const precacheOptions = {
    directoryIndex,
    // An array of RegExp objects can't be serialized by JSON.stringify()'s
    // default behavior, so if it's given, convert it manually.
    ignoreURLParametersMatching: ignoreURLParametersMatching ? [] : undefined
  };
  let precacheOptionsString = JSON.stringify(precacheOptions, null, 2);

  if (ignoreURLParametersMatching) {
    precacheOptionsString = precacheOptionsString.replace(`"ignoreURLParametersMatching": []`, `"ignoreURLParametersMatching": [` + `${ignoreURLParametersMatching.join(', ')}]`);
  }

  let offlineAnalyticsConfigString;

  if (offlineGoogleAnalytics) {
    // If offlineGoogleAnalytics is a truthy value, we need to convert it to the
    // format expected by the template.
    offlineAnalyticsConfigString = offlineGoogleAnalytics === true ? // If it's the literal value true, then use an empty config string.
    '{}' : // Otherwise, convert the config object into a more complex string, taking
    // into account the fact that functions might need to be stringified.
    stringifyWithoutComments(offlineGoogleAnalytics);
  }

  const moduleRegistry = new ModuleRegistry();

  try {
    const populatedTemplate = template(swTemplate)({
      cacheId,
      cleanupOutdatedCaches,
      clientsClaim,
      disableDevLogs,
      importScripts,
      manifestEntries,
      navigateFallback,
      navigateFallbackDenylist,
      navigateFallbackAllowlist,
      navigationPreload,
      offlineAnalyticsConfigString,
      precacheOptionsString,
      runtimeCaching: runtimeCachingConverter(moduleRegistry, runtimeCaching),
      skipWaiting,
      use: moduleRegistry.use.bind(moduleRegistry)
    });
    const workboxImportStatements = moduleRegistry.getImportStatements(); // We need the import statements for all of the Workbox runtime modules
    // prepended, so that the correct bundle can be created.

    return workboxImportStatements.join('\n') + populatedTemplate;
  } catch (error) {
    throw new Error(`${errors['populating-sw-tmpl-failed']} '${error.message}'`);
  }
};