1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
/*
Copyright 2017 Google Inc.
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
https://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 LOG_LEVELS from './models/LogLevels.mjs';
import {WorkboxError} from './_private/WorkboxError.mjs';
import {cacheNames} from './_private/cacheNames.mjs';
import {logger} from './_private/logger.mjs';
import {assert} from './_private/assert.mjs';
import {checkSWFileCacheHeaders} from './_private/checkSWFileCacheHeaders.mjs';
import {setLoggerLevel, getLoggerLevel} from './_private/logger.mjs';
import './_version.mjs';
/**
* This class is never exposed publicly. Inidividual methods are exposed
* using jsdoc alias commands.
*
* @memberof workbox.core
* @private
*/
class WorkboxCore {
/**
* You should not instantiate this object directly.
*
* @private
*/
constructor() {
// Give our version strings something to hang off of.
try {
self.workbox.v = self.workbox.v || {};
} catch (err) {
// NOOP
}
// A WorkboxCore instance must be exported before we can use the logger.
// This is so it can get the current log level.
if (process.env.NODE_ENV !== 'production') {
const padding = ' ';
logger.groupCollapsed('Welcome to Workbox!');
logger.unprefixed.log(`You are currently using a development build. ` +
`By default this will switch to prod builds when not on localhost. ` +
`You can force this with workbox.setConfig({debug: true|false}).`);
logger.unprefixed.log(
`📖 Read the guides and documentation\n` +
`${padding}https://developers.google.com/web/tools/workbox/`
);
logger.unprefixed.log(
`❓ Use the [workbox] tag on Stack Overflow to ask questions\n` +
`${padding}https://stackoverflow.com/questions/ask?tags=workbox`
);
logger.unprefixed.log(
`🐛 Found a bug? Report it on GitHub\n` +
`${padding}https://github.com/GoogleChrome/workbox/issues/new`
);
logger.groupEnd();
if (typeof checkSWFileCacheHeaders === 'function') {
checkSWFileCacheHeaders();
}
}
}
/**
* Get the current cache names used by Workbox.
*
* `cacheNames.precache` is used for precached assets,
* `cacheNames.googleAnalytics` is used by `workbox-google-analytics` to
* store `analytics.js`,
* and `cacheNames.runtime` is used for everything else.
*
* @return {Object} An object with `precache` and `runtime` cache names.
*
* @alias workbox.core.cacheNames
*/
get cacheNames() {
return {
googleAnalytics: cacheNames.getGoogleAnalyticsName(),
precache: cacheNames.getPrecacheName(),
runtime: cacheNames.getRuntimeName(),
};
}
/**
* You can alter the default cache names used by the Workbox modules by
* changing the cache name details.
*
* Cache names are generated as `<prefix>-<Cache Name>-<suffix>`.
*
* @param {Object} details
* @param {Object} details.prefix The string to add to the beginning of
* the precache and runtime cache names.
* @param {Object} details.suffix The string to add to the end of
* the precache and runtime cache names.
* @param {Object} details.precache The cache name to use for precache
* caching.
* @param {Object} details.runtime The cache name to use for runtime caching.
* @param {Object} details.googleAnalytics The cache name to use for
* `workbox-google-analytics` caching.
*
* @alias workbox.core.setCacheNameDetails
*/
setCacheNameDetails(details) {
if (process.env.NODE_ENV !== 'production') {
Object.keys(details).forEach((key) => {
assert.isType(details[key], 'string', {
moduleName: 'workbox-core',
className: 'WorkboxCore',
funcName: 'setCacheNameDetails',
paramName: `details.${key}`,
});
});
if ('precache' in details && details.precache.length === 0) {
throw new WorkboxError('invalid-cache-name', {
cacheNameId: 'precache',
value: details.precache,
});
}
if ('runtime' in details && details.runtime.length === 0) {
throw new WorkboxError('invalid-cache-name', {
cacheNameId: 'runtime',
value: details.runtime,
});
}
if ('googleAnalytics' in details &&
details.googleAnalytics.length === 0) {
throw new WorkboxError('invalid-cache-name', {
cacheNameId: 'googleAnalytics',
value: details.googleAnalytics,
});
}
}
cacheNames.updateDetails(details);
}
/**
* Get the current log level.
*
* @return {number}.
*
* @alias workbox.core.logLevel
*/
get logLevel() {
return getLoggerLevel();
}
/**
* Set the current log level passing in one of the values from
* [LOG_LEVELS]{@link module:workbox-core.LOG_LEVELS}.
*
* @param {number} newLevel The new log level to use.
*
* @alias workbox.core.setLogLevel
*/
setLogLevel(newLevel) {
if (process.env.NODE_ENV !== 'production') {
assert.isType(newLevel, 'number', {
moduleName: 'workbox-core',
className: 'WorkboxCore',
funcName: 'logLevel [setter]',
paramName: `logLevel`,
});
}
if (newLevel > LOG_LEVELS.silent ||
newLevel < LOG_LEVELS.debug) {
throw new WorkboxError('invalid-value', {
paramName: 'logLevel',
validValueDescription: `Please use a value from LOG_LEVELS, i.e ` +
`'logLevel = workbox.core.LOG_LEVELS.debug'.`,
value: newLevel,
});
}
setLoggerLevel(newLevel);
}
}
export default new WorkboxCore();
|
