UNPKG

1.89 kBJavaScriptView Raw
1/*
2 Copyright 2018 Google LLC
3
4 Use of this source code is governed by an MIT-style
5 license that can be found in the LICENSE file or at
6 https://opensource.org/licenses/MIT.
7*/
8import { WorkboxError } from 'workbox-core/_private/WorkboxError.js';
9import '../_version.js';
10// Name of the search parameter used to store revision info.
11const REVISION_SEARCH_PARAM = '__WB_REVISION__';
12/**
13 * Converts a manifest entry into a versioned URL suitable for precaching.
14 *
15 * @param {Object|string} entry
16 * @return {string} A URL with versioning info.
17 *
18 * @private
19 * @memberof workbox-precaching
20 */
21export function createCacheKey(entry) {
22 if (!entry) {
23 throw new WorkboxError('add-to-cache-list-unexpected-type', { entry });
24 }
25 // If a precache manifest entry is a string, it's assumed to be a versioned
26 // URL, like '/app.abcd1234.js'. Return as-is.
27 if (typeof entry === 'string') {
28 const urlObject = new URL(entry, location.href);
29 return {
30 cacheKey: urlObject.href,
31 url: urlObject.href,
32 };
33 }
34 const { revision, url } = entry;
35 if (!url) {
36 throw new WorkboxError('add-to-cache-list-unexpected-type', { entry });
37 }
38 // If there's just a URL and no revision, then it's also assumed to be a
39 // versioned URL.
40 if (!revision) {
41 const urlObject = new URL(url, location.href);
42 return {
43 cacheKey: urlObject.href,
44 url: urlObject.href,
45 };
46 }
47 // Otherwise, construct a properly versioned URL using the custom Workbox
48 // search parameter along with the revision info.
49 const cacheKeyURL = new URL(url, location.href);
50 const originalURL = new URL(url, location.href);
51 cacheKeyURL.searchParams.set(REVISION_SEARCH_PARAM, revision);
52 return {
53 cacheKey: cacheKeyURL.href,
54 url: originalURL.href,
55 };
56}