{"version":3,"file":"index.mjs","names":[],"sources":["../src/messageSW.ts","../src/utils/SerwistEvent.ts","../src/utils/SerwistEventTarget.ts","../src/utils/urlsMatch.ts","../src/Serwist.ts"],"sourcesContent":["/*\n Copyright 2019 Google LLC\n\n Use of this source code is governed by an MIT-style\n license that can be found in the LICENSE file or at\n https://opensource.org/licenses/MIT.\n*/\n\n/**\n * Sends a data object to a service worker via `postMessage` and resolves with\n * a response (if any).\n *\n * A response can be sent by calling `event.ports[0].postMessage(...)`, which will\n * resolve the promise returned by `messageSW()`. If no response is sent, the promise\n * will never resolve.\n *\n * @param sw The service worker to send the message to.\n * @param data An object to send to the service worker.\n * @returns\n */\nexport const messageSW = (sw: ServiceWorker, data: any): Promise => {\n return new Promise((resolve) => {\n const messageChannel = new MessageChannel();\n messageChannel.port1.onmessage = (event: MessageEvent) => {\n resolve(event.data);\n };\n sw.postMessage(data, [messageChannel.port2]);\n });\n};\n","/*\n Copyright 2019 Google LLC\n\n Use of this source code is governed by an MIT-style\n license that can be found in the LICENSE file or at\n https://opensource.org/licenses/MIT.\n*/\n\nimport type { SerwistEventTarget } from \"./SerwistEventTarget.js\";\n\n/**\n * A minimal `Event` subclass shim.\n * This doesn't *actually* subclass `Event` because not all browsers support\n * constructable `EventTarget`, and using a real `Event` will error.\n * @private\n */\nexport class SerwistEvent {\n target?: SerwistEventTarget;\n sw?: ServiceWorker;\n originalEvent?: Event;\n isExternal?: boolean;\n\n constructor(\n public type: K,\n props: Omit,\n ) {\n Object.assign(this, props);\n }\n}\n\nexport interface SerwistMessageEvent extends SerwistEvent<\"message\"> {\n data: any;\n originalEvent: Event;\n ports: readonly MessagePort[];\n}\n\nexport interface SerwistLifecycleEvent extends SerwistEvent {\n isUpdate?: boolean;\n}\n\nexport interface SerwistLifecycleWaitingEvent extends SerwistLifecycleEvent {\n wasWaitingBeforeRegister?: boolean;\n}\n\nexport interface SerwistLifecycleEventMap {\n installing: SerwistLifecycleEvent;\n installed: SerwistLifecycleEvent;\n waiting: SerwistLifecycleWaitingEvent;\n activating: SerwistLifecycleEvent;\n activated: SerwistLifecycleEvent;\n controlling: SerwistLifecycleEvent;\n redundant: SerwistLifecycleEvent;\n}\n\nexport interface SerwistEventMap extends SerwistLifecycleEventMap {\n message: SerwistMessageEvent;\n}\n","/*\n Copyright 2019 Google LLC\n\n Use of this source code is governed by an MIT-style\n license that can be found in the LICENSE file or at\n https://opensource.org/licenses/MIT.\n*/\n\nimport type { SerwistEvent, SerwistEventMap } from \"./SerwistEvent.js\";\n\nexport type ListenerCallback = (event: SerwistEvent) => any;\n\n/**\n * A minimal `EventTarget` shim.\n * This is necessary because not all browsers support constructable\n * `EventTarget`, so using a real `EventTarget` will error.\n * @private\n */\nexport class SerwistEventTarget {\n private readonly _eventListenerRegistry: Map> = new Map();\n\n /**\n * @param type\n * @param listener\n * @private\n */\n addEventListener(type: K, listener: (event: SerwistEventMap[K]) => any): void {\n const foo = this._getEventListenersByType(type);\n foo.add(listener as ListenerCallback);\n }\n\n /**\n * @param type\n * @param listener\n * @private\n */\n removeEventListener(type: K, listener: (event: SerwistEventMap[K]) => any): void {\n this._getEventListenersByType(type).delete(listener as ListenerCallback);\n }\n\n /**\n * @param event\n * @private\n */\n dispatchEvent(event: SerwistEvent): void {\n event.target = this;\n\n const listeners = this._getEventListenersByType(event.type);\n for (const listener of listeners) {\n listener(event);\n }\n }\n\n /**\n * Returns a Set of listeners associated with the passed event type.\n * If no handlers have been registered, an empty Set is returned.\n *\n * @param type The event type.\n * @returns An array of handler functions.\n * @private\n */\n private _getEventListenersByType(type: keyof SerwistEventMap) {\n if (!this._eventListenerRegistry.has(type)) {\n this._eventListenerRegistry.set(type, new Set());\n }\n return this._eventListenerRegistry.get(type)!;\n }\n}\n","/*\n Copyright 2019 Google LLC\n\n Use of this source code is governed by an MIT-style\n license that can be found in the LICENSE file or at\n https://opensource.org/licenses/MIT.\n*/\n\n/**\n * Returns true if two URLs have the same `.href` property. The URLs can be\n * relative, and if they are the current location href is used to resolve URLs.\n *\n * @private\n * @param url1\n * @param url2\n * @returns\n */\nexport function urlsMatch(url1: string, url2: string): boolean {\n const { href } = location;\n return new URL(url1, href).href === new URL(url2, href).href;\n}\n","/*\n Copyright 2019 Google LLC\n\n Use of this source code is governed by an MIT-style\n license that can be found in the LICENSE file or at\n https://opensource.org/licenses/MIT.\n*/\n\nimport { Deferred, logger } from \"serwist/internal\";\n\nimport { messageSW } from \"./messageSW.js\";\nimport { isCurrentPageOutOfScope } from \"./utils/isCurrentPageOutOfScope.js\";\nimport type { SerwistLifecycleEventMap } from \"./utils/SerwistEvent.js\";\nimport { SerwistEvent } from \"./utils/SerwistEvent.js\";\nimport { SerwistEventTarget } from \"./utils/SerwistEventTarget.js\";\nimport { urlsMatch } from \"./utils/urlsMatch.js\";\n\n// The time a SW must be in the waiting phase before we can conclude\n// `skipWaiting()` wasn't called. This 200 amount wasn't scientifically\n// chosen, but it seems to avoid false positives in my testing.\nconst WAITING_TIMEOUT_DURATION = 200;\n\n// The amount of time after a registration that we can reasonably conclude\n// that the registration didn't trigger an update.\nconst REGISTRATION_TIMEOUT_DURATION = 60000;\n\n// The de facto standard message that a service worker should be listening for\n// to trigger a call to skipWaiting().\nconst SKIP_WAITING_MESSAGE = { type: \"SKIP_WAITING\" } as const;\n\n/**\n * A class to aid in handling service worker registration, updates, and\n * reacting to service worker lifecycle events.\n *\n * @fires `@serwist/window.Serwist.message`\n * @fires `@serwist/window.Serwist.installed`\n * @fires `@serwist/window.Serwist.waiting`\n * @fires `@serwist/window.Serwist.controlling`\n * @fires `@serwist/window.Serwist.activated`\n * @fires `@serwist/window.Serwist.redundant`\n */\nexport class Serwist extends SerwistEventTarget {\n private readonly _scriptURL: string | TrustedScriptURL;\n private readonly _registerOptions: RegistrationOptions = {};\n private _updateFoundCount = 0;\n\n // Deferreds we can resolve later.\n private readonly _swDeferred: Deferred = new Deferred();\n private readonly _activeDeferred: Deferred = new Deferred();\n private readonly _controllingDeferred: Deferred = new Deferred();\n\n private _registrationTime: DOMHighResTimeStamp = 0;\n private _isUpdate?: boolean;\n private _compatibleControllingSW?: ServiceWorker;\n private _registration?: ServiceWorkerRegistration;\n private _sw?: ServiceWorker;\n private readonly _ownSWs: Set = new Set();\n private _externalSW?: ServiceWorker;\n private _waitingTimeout?: number;\n\n /**\n * Creates a new Serwist instance with a script URL and service worker\n * options. The script URL and options are the same as those used when\n * calling [navigator.serviceWorker.register(scriptURL, options)](https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/register).\n *\n * @param scriptURL The service worker script associated with this instance. Using a\n * [`TrustedScriptURL`](https://developer.mozilla.org/en-US/docs/Web/API/TrustedScriptURL) is supported.\n * @param registerOptions The service worker options associated with this instance.\n */\n constructor(scriptURL: string | TrustedScriptURL, registerOptions: RegistrationOptions = {}) {\n super();\n\n this._scriptURL = scriptURL;\n this._registerOptions = registerOptions;\n\n // Add a message listener immediately since messages received during\n // page load are buffered only until the DOMContentLoaded event:\n // https://github.com/GoogleChrome/workbox/issues/2202\n navigator.serviceWorker.addEventListener(\"message\", this._onMessage);\n }\n\n /**\n * Registers a service worker for this instances script URL and service\n * worker options. By default this method delays registration until after\n * the window has loaded.\n *\n * @param options\n */\n async register({\n immediate = false,\n }: {\n /**\n * Setting this to true will register the service worker immediately,\n * even if the window has not loaded (not recommended).\n */\n immediate?: boolean;\n } = {}): Promise {\n if (process.env.NODE_ENV !== \"production\") {\n if (this._registrationTime) {\n logger.error(\"Cannot re-register a Serwist instance after it has been registered. Create a new instance instead.\");\n return;\n }\n }\n\n if (!immediate && document.readyState !== \"complete\") {\n await new Promise((res) => window.addEventListener(\"load\", res));\n }\n\n // Set this flag to true if any service worker was controlling the page\n // at registration time.\n this._isUpdate = Boolean(navigator.serviceWorker.controller);\n\n // Before registering, attempt to determine if a SW is already controlling\n // the page and if that SW script (and version, if specified) matches this\n // instance's script.\n this._compatibleControllingSW = this._getControllingSWIfCompatible();\n\n this._registration = await this._registerScript();\n\n // If we have a compatible controller, store the controller as the \"own\"\n // SW, resolve active/controlling deferreds and add necessary listeners.\n if (this._compatibleControllingSW) {\n this._sw = this._compatibleControllingSW;\n this._activeDeferred.resolve(this._compatibleControllingSW);\n this._controllingDeferred.resolve(this._compatibleControllingSW);\n\n this._compatibleControllingSW.addEventListener(\"statechange\", this._onStateChange, { once: true });\n }\n\n // If there's a waiting service worker with a matching URL before the\n // `updatefound` event fires, it likely means that this site is open\n // in another tab, or the user refreshed the page (and thus the previous\n // page wasn't fully unloaded before this page started loading).\n // https://developers.google.com/web/fundamentals/primers/service-workers/lifecycle#waiting\n const waitingSW = this._registration.waiting;\n if (waitingSW && urlsMatch(waitingSW.scriptURL, this._scriptURL.toString())) {\n // Store the waiting SW as the \"own\" SW, even if it means overwriting\n // a compatible controller.\n this._sw = waitingSW;\n\n // Run this in the next microtask, so any code that adds an event\n // listener after awaiting `register()` will get this event.\n void Promise.resolve().then(() => {\n this.dispatchEvent(\n new SerwistEvent(\"waiting\", {\n sw: waitingSW,\n wasWaitingBeforeRegister: true,\n }),\n );\n if (process.env.NODE_ENV !== \"production\") {\n logger.warn(\"A service worker was already waiting to activate before this script was registered...\");\n }\n });\n }\n\n // If an \"own\" SW is already set, resolve the deferred.\n if (this._sw) {\n this._swDeferred.resolve(this._sw);\n this._ownSWs.add(this._sw);\n }\n\n if (process.env.NODE_ENV !== \"production\") {\n logger.log(\"Successfully registered service worker.\", this._scriptURL.toString());\n\n if (navigator.serviceWorker.controller) {\n if (this._compatibleControllingSW) {\n logger.debug(\"A service worker with the same script URL is already controlling this page.\");\n } else {\n logger.debug(\n \"A service worker with a different script URL is currently controlling the page. The browser is now fetching the new script now...\",\n );\n }\n }\n\n if (isCurrentPageOutOfScope(this._registerOptions.scope || this._scriptURL.toString())) {\n logger.warn(\"The current page is not in scope for the registered service worker. Was this a mistake?\");\n }\n }\n\n this._registration.addEventListener(\"updatefound\", this._onUpdateFound);\n navigator.serviceWorker.addEventListener(\"controllerchange\", this._onControllerChange);\n\n return this._registration;\n }\n\n /**\n * Checks for updates of the registered service worker.\n */\n async update(): Promise {\n if (!this._registration) {\n if (process.env.NODE_ENV !== \"production\") {\n logger.error(\"Cannot update a Serwist instance without being registered. Register the Serwist instance first.\");\n }\n return;\n }\n\n // Try to update registration\n await this._registration.update();\n }\n\n /**\n * Resolves to the service worker registered by this instance as soon as it\n * is active. If a service worker was already controlling at registration\n * time then it will resolve to that if the script URLs (and optionally\n * script versions) match, otherwise it will wait until an update is found\n * and activates.\n *\n * @returns\n */\n get active(): Promise {\n return this._activeDeferred.promise;\n }\n\n /**\n * Resolves to the service worker registered by this instance as soon as it\n * is controlling the page. If a service worker was already controlling at\n * registration time then it will resolve to that if the script URLs (and\n * optionally script versions) match, otherwise it will wait until an update\n * is found and starts controlling the page.\n * Note: the first time a service worker is installed it will active but\n * not start controlling the page unless `clients.claim()` is called in the\n * service worker.\n *\n * @returns\n */\n get controlling(): Promise {\n return this._controllingDeferred.promise;\n }\n\n /**\n * Resolves with a reference to a service worker that matches the script URL\n * of this instance, as soon as it's available.\n *\n * If, at registration time, there's already an active or waiting service\n * worker with a matching script URL, it will be used (with the waiting\n * service worker taking precedence over the active service worker if both\n * match, since the waiting service worker would have been registered more\n * recently).\n * If there's no matching active or waiting service worker at registration\n * time then the promise will not resolve until an update is found and starts\n * installing, at which point the installing service worker is used.\n *\n * @returns\n */\n getSW(): Promise {\n // If `this._sw` is set, resolve with that as we want `getSW()` to\n // return the correct (new) service worker if an update is found.\n return this._sw !== undefined ? Promise.resolve(this._sw) : this._swDeferred.promise;\n }\n\n /**\n * Sends the passed data object to the service worker registered by this\n * instance (via `getSW`) and resolves with a response (if any).\n *\n * A response can be sent by calling `event.ports[0].postMessage(...)`, which will\n * resolve the promise returned by `messageSW()`. If no response is sent, the promise\n * will never resolve.\n *\n * @param data An object to send to the service worker\n * @returns\n */\n // We might be able to change the 'data' type to Record in the future.\n async messageSW(data: any): Promise {\n const sw = await this.getSW();\n return messageSW(sw, data);\n }\n\n /**\n * Sends a `{ type: \"SKIP_WAITING\" }` message to the service worker that is\n * currently waiting and associated with the current registration.\n *\n * If there is no current registration, or no service worker is waiting,\n * calling this will have no effect.\n */\n messageSkipWaiting(): void {\n if (this._registration?.waiting) {\n void messageSW(this._registration.waiting, SKIP_WAITING_MESSAGE);\n }\n }\n\n /**\n * Checks for a service worker already controlling the page and returns\n * it if its script URL matches.\n *\n * @private\n * @returns\n */\n private _getControllingSWIfCompatible() {\n const controller = navigator.serviceWorker.controller;\n if (controller && urlsMatch(controller.scriptURL, this._scriptURL.toString())) {\n return controller;\n }\n return undefined;\n }\n\n /**\n * Registers a service worker for this instances script URL and register\n * options and tracks the time registration was complete.\n *\n * @private\n */\n private async _registerScript() {\n try {\n // this._scriptURL may be a TrustedScriptURL, but there's no support for\n // passing that to register() in lib.dom right now.\n // https://github.com/GoogleChrome/workbox/issues/2855\n const reg = await navigator.serviceWorker.register(this._scriptURL as string, this._registerOptions);\n\n // Keep track of when registration happened, so it can be used in the\n // `this._onUpdateFound` heuristic. Also use the presence of this\n // property as a way to see if `.register()` has been called.\n this._registrationTime = performance.now();\n\n return reg;\n } catch (error) {\n if (process.env.NODE_ENV !== \"production\") {\n logger.error(error);\n }\n // Re-throw the error.\n throw error;\n }\n }\n\n /**\n * @private\n * @param originalEvent\n */\n private readonly _onUpdateFound = (originalEvent: Event) => {\n // `this._registration` will never be `undefined` after an update is found.\n const registration = this._registration!;\n const installingSW = registration.installing as ServiceWorker;\n\n // If the script URL passed to `navigator.serviceWorker.register()` is\n // different from the current controlling SW's script URL, we know any\n // successful registration calls will trigger an `updatefound` event.\n // But if the registered script URL is the same as the current controlling\n // SW's script URL, we'll only get an `updatefound` event if the file\n // changed since it was last registered. This can be a problem if the user\n // opens up the same page in a different tab, and that page registers\n // a SW that triggers an update. It's a problem because this page has no\n // good way of knowing whether the `updatefound` event came from the SW\n // script it registered or from a registration attempt made by a newer\n // version of the page running in another tab.\n // To minimize the possibility of a false positive, we use the logic here:\n const updateLikelyTriggeredExternally =\n // Since we enforce only calling `register()` once, and since we don't\n // add the `updatefound` event listener until the `register()` call, if\n // `_updateFoundCount` is > 0 then it means this method has already\n // been called, thus this SW must be external\n this._updateFoundCount > 0 ||\n // If the script URL of the installing SW is different from this\n // instance's script URL, we know it's definitely not from our\n // registration.\n !urlsMatch(installingSW.scriptURL, this._scriptURL.toString()) ||\n // If all of the above are false, then we use a time-based heuristic:\n // Any `updatefound` event that occurs long after our registration is\n // assumed to be external.\n performance.now() > this._registrationTime + REGISTRATION_TIMEOUT_DURATION;\n // If any of the above are not true, we assume the update was\n // triggered by this instance.\n\n if (updateLikelyTriggeredExternally) {\n this._externalSW = installingSW;\n registration.removeEventListener(\"updatefound\", this._onUpdateFound);\n } else {\n // If the update was not triggered externally we know the installing\n // SW is the one we registered, so we set it.\n this._sw = installingSW;\n this._ownSWs.add(installingSW);\n this._swDeferred.resolve(installingSW);\n\n if (process.env.NODE_ENV !== \"production\") {\n if (this._isUpdate) {\n logger.log(\"Updated service worker found. Installing now...\");\n } else {\n logger.log(\"Service worker is installing...\");\n }\n }\n }\n\n // Dispatch the `installing` event when the SW is installing.\n this.dispatchEvent(\n new SerwistEvent(\"installing\", {\n sw: installingSW,\n originalEvent,\n isExternal: updateLikelyTriggeredExternally,\n isUpdate: this._isUpdate,\n }),\n );\n\n // Increment the `updatefound` count, so future invocations of this\n // method can be sure they were triggered externally.\n ++this._updateFoundCount;\n\n // Add a `statechange` listener regardless of whether this update was\n // triggered externally, since we have callbacks for both.\n installingSW.addEventListener(\"statechange\", this._onStateChange);\n };\n\n /**\n * @private\n * @param originalEvent\n */\n private readonly _onStateChange = (originalEvent: Event) => {\n // `this._registration` will never be `undefined` after an update is found.\n const registration = this._registration!;\n const sw = originalEvent.target as ServiceWorker;\n const { state } = sw;\n const isExternal = sw === this._externalSW;\n\n const eventProps: {\n sw: ServiceWorker;\n originalEvent: Event;\n isUpdate?: boolean;\n isExternal: boolean;\n } = {\n sw,\n isExternal,\n originalEvent,\n };\n if (!isExternal && this._isUpdate) {\n eventProps.isUpdate = true;\n }\n\n this.dispatchEvent(new SerwistEvent(state as keyof SerwistLifecycleEventMap, eventProps));\n\n if (state === \"installed\") {\n // This timeout is used to ignore cases where the service worker calls\n // `skipWaiting()` in the install event, thus moving it directly in the\n // activating state. (Since all service workers *must* go through the\n // waiting phase, the only way to detect `skipWaiting()` called in the\n // install event is to observe that the time spent in the waiting phase\n // is very short.)\n // NOTE: we don't need separate timeouts for the own and external SWs\n // since they can't go through these phases at the same time.\n this._waitingTimeout = self.setTimeout(() => {\n // Ensure the SW is still waiting (it may now be redundant).\n if (state === \"installed\" && registration.waiting === sw) {\n this.dispatchEvent(new SerwistEvent(\"waiting\", eventProps));\n\n if (process.env.NODE_ENV !== \"production\") {\n if (isExternal) {\n logger.warn(\"An external service worker has installed but is \" + \"waiting for this client to close before activating...\");\n } else {\n logger.warn(\"The service worker has installed but is waiting \" + \"for existing clients to close before activating...\");\n }\n }\n }\n }, WAITING_TIMEOUT_DURATION);\n } else if (state === \"activating\") {\n clearTimeout(this._waitingTimeout);\n if (!isExternal) {\n this._activeDeferred.resolve(sw);\n }\n }\n\n if (process.env.NODE_ENV !== \"production\") {\n switch (state) {\n case \"installed\":\n if (isExternal) {\n logger.warn(\"An external service worker has installed. \" + \"You may want to suggest users reload this page.\");\n } else {\n logger.log(\"Registered service worker installed.\");\n }\n break;\n case \"activated\":\n if (isExternal) {\n logger.warn(\"An external service worker has activated.\");\n } else {\n logger.log(\"Registered service worker activated.\");\n if (sw !== navigator.serviceWorker.controller) {\n logger.warn(\n \"The registered service worker is active but \" +\n \"not yet controlling the page. Reload or run \" +\n \"`clients.claim()` in the service worker.\",\n );\n }\n }\n break;\n case \"redundant\":\n if (sw === this._compatibleControllingSW) {\n logger.log(\"Previously controlling service worker now redundant!\");\n } else if (!isExternal) {\n logger.log(\"Registered service worker now redundant!\");\n }\n break;\n }\n }\n };\n\n /**\n * @private\n * @param originalEvent\n */\n private readonly _onControllerChange = (originalEvent: Event) => {\n const sw = this._sw;\n const isExternal = sw !== navigator.serviceWorker.controller;\n\n // Unconditionally dispatch the controlling event, with isExternal set\n // to distinguish between controller changes due to the initial registration\n // vs. an update-check or other tab's registration.\n // See https://github.com/GoogleChrome/workbox/issues/2786\n this.dispatchEvent(\n new SerwistEvent(\"controlling\", {\n isExternal,\n originalEvent,\n sw,\n isUpdate: this._isUpdate,\n }),\n );\n\n if (!isExternal) {\n if (process.env.NODE_ENV !== \"production\") {\n logger.log(\"Registered service worker now controlling this page.\");\n }\n this._controllingDeferred.resolve(sw);\n }\n };\n\n /**\n * @private\n * @param originalEvent\n */\n private readonly _onMessage = async (originalEvent: MessageEvent) => {\n const { data, ports, source } = originalEvent;\n\n // Wait until there's an \"own\" service worker. This is used to buffer\n // `message` events that may be received prior to calling `register()`.\n await this.getSW();\n\n // If the service worker that sent the message is in the list of own\n // service workers for this instance, dispatch a `message` event.\n // NOTE: we check for all previously owned service workers rather than\n // just the current one because some messages (e.g. cache updates) use\n // a timeout when sent and may be delayed long enough for a service worker\n // update to be found.\n if (this._ownSWs.has(source as ServiceWorker)) {\n this.dispatchEvent(\n new SerwistEvent(\"message\", {\n data,\n originalEvent,\n ports,\n sw: source as ServiceWorker,\n }),\n );\n }\n };\n}\n\n// The jsdoc comments below outline the events this instance may dispatch:\n// -----------------------------------------------------------------------\n\n/**\n * The `message` event is dispatched any time a `postMessage` is received.\n *\n * @event workbox-window.Workbox#message\n * @type {SerwistEvent}\n * @property {*} data The `data` property from the original `message` event.\n * @property {Event} originalEvent The original [`message`]{@link https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent}\n * event.\n * @property {string} type `message`.\n * @property {MessagePort[]} ports The `ports` value from `originalEvent`.\n * @property {Workbox} target The `Workbox` instance.\n */\n\n/**\n * The `installed` event is dispatched if the state of a\n * {@link workbox-window.Workbox} instance's\n * {@link https://developers.google.com/web/tools/workbox/modules/workbox-precaching#def-registered-sw|registered service worker}\n * changes to `installed`.\n *\n * Then can happen either the very first time a service worker is installed,\n * or after an update to the current service worker is found. In the case\n * of an update being found, the event's `isUpdate` property will be `true`.\n *\n * @event workbox-window.Workbox#installed\n * @type {SerwistEvent}\n * @property {ServiceWorker} sw The service worker instance.\n * @property {Event} originalEvent The original [`statechange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/onstatechange}\n * event.\n * @property {boolean|undefined} isUpdate True if a service worker was already\n * controlling when this `Workbox` instance called `register()`.\n * @property {boolean|undefined} isExternal True if this event is associated\n * with an [external service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-window#when_an_unexpected_version_of_the_service_worker_is_found}.\n * @property {string} type `installed`.\n * @property {Workbox} target The `Workbox` instance.\n */\n\n/**\n * The `waiting` event is dispatched if the state of a\n * {@link workbox-window.Workbox} instance's\n * [registered service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-precaching#def-registered-sw}\n * changes to `installed` and then doesn't immediately change to `activating`.\n * It may also be dispatched if a service worker with the same\n * [`scriptURL`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/scriptURL}\n * was already waiting when the {@link workbox-window.Workbox#register}\n * method was called.\n *\n * @event workbox-window.Workbox#waiting\n * @type {SerwistEvent}\n * @property {ServiceWorker} sw The service worker instance.\n * @property {Event|undefined} originalEvent The original\n * [`statechange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/onstatechange}\n * event, or `undefined` in the case where the service worker was waiting\n * to before `.register()` was called.\n * @property {boolean|undefined} isUpdate True if a service worker was already\n * controlling when this `Workbox` instance called `register()`.\n * @property {boolean|undefined} isExternal True if this event is associated\n * with an [external service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-window#when_an_unexpected_version_of_the_service_worker_is_found}.\n * @property {boolean|undefined} wasWaitingBeforeRegister True if a service worker with\n * a matching `scriptURL` was already waiting when this `Workbox`\n * instance called `register()`.\n * @property {string} type `waiting`.\n * @property {Workbox} target The `Workbox` instance.\n */\n\n/**\n * The `controlling` event is dispatched if a\n * [`controllerchange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/oncontrollerchange}\n * fires on the service worker [container]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer}\n * and the [`scriptURL`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/scriptURL}\n * of the new [controller]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/controller}\n * matches the `scriptURL` of the `Workbox` instance's\n * [registered service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-precaching#def-registered-sw}.\n *\n * @event workbox-window.Workbox#controlling\n * @type {SerwistEvent}\n * @property {ServiceWorker} sw The service worker instance.\n * @property {Event} originalEvent The original [`controllerchange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/oncontrollerchange}\n * event.\n * @property {boolean|undefined} isUpdate True if a service worker was already\n * controlling when this service worker was registered.\n * @property {boolean|undefined} isExternal True if this event is associated\n * with an [external service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-window#when_an_unexpected_version_of_the_service_worker_is_found}.\n * @property {string} type `controlling`.\n * @property {Workbox} target The `Workbox` instance.\n */\n\n/**\n * The `activated` event is dispatched if the state of a\n * {@link workbox-window.Workbox} instance's\n * {@link https://developers.google.com/web/tools/workbox/modules/workbox-precaching#def-registered-sw|registered service worker}\n * changes to `activated`.\n *\n * @event workbox-window.Workbox#activated\n * @type {SerwistEvent}\n * @property {ServiceWorker} sw The service worker instance.\n * @property {Event} originalEvent The original [`statechange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/onstatechange}\n * event.\n * @property {boolean|undefined} isUpdate True if a service worker was already\n * controlling when this `Workbox` instance called `register()`.\n * @property {boolean|undefined} isExternal True if this event is associated\n * with an [external service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-window#when_an_unexpected_version_of_the_service_worker_is_found}.\n * @property {string} type `activated`.\n * @property {Workbox} target The `Workbox` instance.\n */\n\n/**\n * The `redundant` event is dispatched if the state of a\n * {@link workbox-window.Workbox} instance's\n * [registered service worker]{@link https://developers.google.com/web/tools/workbox/modules/workbox-precaching#def-registered-sw}\n * changes to `redundant`.\n *\n * @event workbox-window.Workbox#redundant\n * @type {SerwistEvent}\n * @property {ServiceWorker} sw The service worker instance.\n * @property {Event} originalEvent The original [`statechange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/onstatechange}\n * event.\n * @property {boolean|undefined} isUpdate True if a service worker was already\n * controlling when this `Workbox` instance called `register()`.\n * @property {string} type `redundant`.\n * @property {Workbox} target The `Workbox` instance.\n */\n\n/**\n * The `installing` event is dispatched if the service worker\n * finds the new version and starts installing.\n *\n * @event workbox-window.Workbox#installing\n * @type {SerwistEvent}\n * @property {ServiceWorker} sw The installing service worker instance.\n * @property {Event} originalEvent The original [`statechange`]{@link https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/onstatechange}\n * event.\n * @property {boolean|undefined} isUpdate True if a service worker was already\n * controlling when this `Workbox` instance called `register()`.\n * @property {string} type `installing`.\n * @property {Workbox} target The `Workbox` instance.\n */\n"],"mappings":"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"}