Accueil › Angular › Le service worker Angular
Le service worker Angular
PWA et mode hors-ligneavance
Un service worker est un script que le navigateur exécute à part de la page, capable d'intercepter chaque requête réseau qu'elle émet. Contrairement au code de l'application, il continue de tourner même onglet fermé, et sert de proxy entre l'application et le réseau : c'est ce qui permet de répondre depuis un cache quand le réseau est absent. Il a un cycle de vie propre (install → activate → fetch) et exige HTTPS, sauf en local (localhost est une exception explicite du navigateur).
ng add @angular/pwa installe et configure tout le nécessaire : ajout de la dépendance @angular/service-worker, enregistrement via provideServiceWorker('ngsw-worker.js', ...) dans les providers, modification de index.html (lien vers manifest.webmanifest, balise theme-color), icônes par défaut, et création d'un ngsw-config.json de base.
// app.config.ts
import { ApplicationConfig, isDevMode } from '@angular/core';
import { provideServiceWorker } from '@angular/service-worker';
export const appConfig: ApplicationConfig = {
providers: [
provideServiceWorker('ngsw-worker.js', {
enabled: !isDevMode(),
registrationStrategy: 'registerWhenStable:30000',
}),
],
};
enabled: !isDevMode() est essentiel : un service worker actif en développement complique le débogage (cache masquant les changements de code). ngsw-config.json décrit ensuite quoi mettre en cache : assetGroups pour les fichiers statiques du build, dataGroups pour les appels d'API.
Les termes à connaître
- Service worker
Script exécuté par le navigateur en dehors de la page, capable d'intercepter toutes les requêtes réseau qu'elle émet. Il a son propre cycle de vie (
install,activate,fetch) et survit à la fermeture d'un onglet — c'est lui qui rend le cache hors-ligne possible. Nécessite HTTPS, sauf surlocalhost.- ngsw-worker.js
Service worker générique fourni par
@angular/service-workeret généré au build. Il litngsw.json(le manifeste compilé à partir dengsw-config.json) pour savoir quoi mettre en cache et comment.- ngsw-config.json
Fichier de configuration, écrit à la main, qui décrit la stratégie de cache de l'application :
assetGroupspour les fichiers statiques,dataGroupspour les appels réseau (API).- assetGroups
Groupes de ressources statiques (JS, CSS, images, polices…) dans
ngsw-config.json, chacun avec uninstallMode(prefetchoulazy) et unupdateMode.- dataGroups
Groupes d'URLs d'API dans
ngsw-config.json, avec une stratégie de cache (freshnessouperformance) distincte de celle des fichiers statiques, car une réponse d'API change plus souvent qu'un bundle JS versionné.- provideServiceWorker()
Fonction de
@angular/service-workerà ajouter aux providers de l'application pour enregistrerngsw-worker.js. Accepte une optionenabled(à mettre à!isDevMode(), jamais actif en développement) etregistrationStrategy(moment d'enregistrement du service worker).
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.