Formations — 1 037 leçons en français

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 sur localhost.

ngsw-worker.js

Service worker générique fourni par @angular/service-worker et généré au build. Il lit ngsw.json (le manifeste compilé à partir de ngsw-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 : assetGroups pour les fichiers statiques, dataGroups pour les appels réseau (API).

assetGroups

Groupes de ressources statiques (JS, CSS, images, polices…) dans ngsw-config.json, chacun avec un installMode (prefetch ou lazy) et un updateMode.

dataGroups

Groupes d'URLs d'API dans ngsw-config.json, avec une stratégie de cache (freshness ou performance) 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 enregistrer ngsw-worker.js. Accepte une option enabled (à mettre à !isDevMode(), jamais actif en développement) et registrationStrategy (moment d'enregistrement du service worker).

Lire l'explication détaillée et faire le quiz →

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.