/** * @license * Copyright Google Inc. All Rights Reserved. * * Use of this source code is governed by an MIT-style license that can be * found in the LICENSE file at https://angular.io/license */ import {isPlatformBrowser} from '@angular/common'; import {APP_INITIALIZER, ApplicationRef, InjectionToken, Injector, ModuleWithProviders, NgModule, PLATFORM_ID} from '@angular/core'; import {Observable, of } from 'rxjs'; import {delay, filter, take} from 'rxjs/operators'; import {NgswCommChannel} from './low_level'; import {SwPush} from './push'; import {SwUpdate} from './update'; /** * Token that can be used to provide options for `ServiceWorkerModule` outside of * `ServiceWorkerModule.register()`. * * You can use this token to define a provider that generates the registration options at runtime, * for example via a function call: * * {@example service-worker/registration-options/module.ts region="registration-options" * header="app.module.ts"} * * @publicApi */ export abstract class SwRegistrationOptions { /** * Whether the ServiceWorker will be registered and the related services (such as `SwPush` and * `SwUpdate`) will attempt to communicate and interact with it. * * Default: true */ enabled?: boolean; /** * A URL that defines the ServiceWorker's registration scope; that is, what range of URLs it can * control. It will be used when calling * [ServiceWorkerContainer#register()](https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/register). */ scope?: string; /** * Defines the ServiceWorker registration strategy, which determines when it will be registered * with the browser. * * The default behavior of registering once the application stabilizes (i.e. as soon as there are * no pending micro- and macro-tasks), is designed register the ServiceWorker as soon as possible * but without affecting the application's first time load. * * Still, there might be cases where you want more control over when the ServiceWorker is * registered (e.g. there might be a long-running timeout or polling interval, preventing the app * to stabilize). The available option are: * * - `registerWhenStable`: Register as soon as the application stabilizes (no pending * micro-/macro-tasks). * - `registerImmediately`: Register immediately. * - `registerWithDelay:`: Register with a delay of `` milliseconds. For * example, use `registerWithDelay:5000` to register the ServiceWorker after 5 seconds. If * `` is omitted, is defaults to `0`, which will register the ServiceWorker as soon * as possible but still asynchronously, once all pending micro-tasks are completed. * - An [Observable](guide/observables) factory function: A function that returns an `Observable`. * The function will be used at runtime to obtain and subscribe to the `Observable` and the * ServiceWorker will be registered as soon as the first value is emitted. * * Default: 'registerWhenStable' */ registrationStrategy?: string|(() => Observable); } export const SCRIPT = new InjectionToken('NGSW_REGISTER_SCRIPT'); export function ngswAppInitializer( injector: Injector, script: string, options: SwRegistrationOptions, platformId: string): Function { const initializer = () => { if (!(isPlatformBrowser(platformId) && ('serviceWorker' in navigator) && options.enabled !== false)) { return; } // Wait for service worker controller changes, and fire an INITIALIZE action when a new SW // becomes active. This allows the SW to initialize itself even if there is no application // traffic. navigator.serviceWorker.addEventListener('controllerchange', () => { if (navigator.serviceWorker.controller !== null) { navigator.serviceWorker.controller.postMessage({action: 'INITIALIZE'}); } }); let readyToRegister$: Observable; if (typeof options.registrationStrategy === 'function') { readyToRegister$ = options.registrationStrategy(); } else { const [strategy, ...args] = (options.registrationStrategy || 'registerWhenStable').split(':'); switch (strategy) { case 'registerImmediately': readyToRegister$ = of (null); break; case 'registerWithDelay': readyToRegister$ = of (null).pipe(delay(+args[0] || 0)); break; case 'registerWhenStable': const appRef = injector.get(ApplicationRef); readyToRegister$ = appRef.isStable.pipe(filter(stable => stable)); break; default: // Unknown strategy. throw new Error( `Unknown ServiceWorker registration strategy: ${options.registrationStrategy}`); } } // Don't return anything to avoid blocking the application until the SW is registered. // Catch and log the error if SW registration fails to avoid uncaught rejection warning. readyToRegister$.pipe(take(1)).subscribe( () => navigator.serviceWorker.register(script, {scope: options.scope}) .catch(err => console.error('Service worker registration failed with:', err))); }; return initializer; } export function ngswCommChannelFactory( opts: SwRegistrationOptions, platformId: string): NgswCommChannel { return new NgswCommChannel( isPlatformBrowser(platformId) && opts.enabled !== false ? navigator.serviceWorker : undefined); } /** * @publicApi */ @NgModule({ providers: [SwPush, SwUpdate], }) export class ServiceWorkerModule { /** * Register the given Angular Service Worker script. * * If `enabled` is set to `false` in the given options, the module will behave as if service * workers are not supported by the browser, and the service worker will not be registered. */ static register(script: string, opts: SwRegistrationOptions = {}): ModuleWithProviders { return { ngModule: ServiceWorkerModule, providers: [ {provide: SCRIPT, useValue: script}, {provide: SwRegistrationOptions, useValue: opts}, { provide: NgswCommChannel, useFactory: ngswCommChannelFactory, deps: [SwRegistrationOptions, PLATFORM_ID] }, { provide: APP_INITIALIZER, useFactory: ngswAppInitializer, deps: [Injector, SCRIPT, SwRegistrationOptions, PLATFORM_ID], multi: true, }, ], }; } }