Formations — 1 037 leçons en français

Accueil › Angular › Gérer les mises à jour d'une PWA

Gérer les mises à jour d'une PWA

PWA et mode hors-ligneavance

Un service worker télécharge une nouvelle version de l'application en tâche de fond, sans jamais l'imposer de lui-même : sans code applicatif dédié, un utilisateur peut rester sur une ancienne version indéfiniment, tant qu'il garde un onglet ouvert ou revient régulièrement avant que le cycle naturel ne rafraîchisse tout. Le service SwUpdate (de @angular/service-worker) donne accès à ce cycle.

import { Injectable, inject } from '@angular/core';
import { SwUpdate, VersionReadyEvent } from '@angular/service-worker';
import { filter } from 'rxjs';

@Injectable({ providedIn: 'root' })
export class MiseAJourService {
  private swUpdate = inject(SwUpdate);

  constructor() {
    this.swUpdate.versionUpdates
      .pipe(filter((e): e is VersionReadyEvent => e.type === 'VERSION_READY'))
      .subscribe(() => {
        if (confirm('Une nouvelle version du catalogue est disponible. Recharger maintenant ?')) {
          document.location.reload();
        }
      });
  }
}

activateUpdate() bascule le service worker sur la nouvelle version sans recharger la page — le code JavaScript déjà en mémoire dans l'onglet reste l'ancien. Sans rechargement explicite ensuite, un chargement différé ultérieur (route lazy, @defer) peut récupérer un fragment de la nouvelle version incompatible avec l'app shell encore ancienne. Proposer la mise à jour à l'utilisateur (une bannière, une confirmation) reste préférable à l'imposer brutalement en pleine saisie d'un formulaire de commande.

Les termes à connaître

SwUpdate

Service injectable de @angular/service-worker qui expose l'état des mises à jour disponibles (versionUpdates, unrecoverable) et deux méthodes pour agir (checkForUpdate(), activateUpdate()).

versionUpdates

Observable de SwUpdate qui émet un événement à chaque étape du cycle de mise à jour : détection d'une nouvelle version, absence de nouvelle version, version prête, échec d'installation, échec critique.

VersionReadyEvent

Événement émis par versionUpdates (type: 'VERSION_READY') quand une nouvelle version a été téléchargée et validée : elle peut être activée. Expose currentVersion et latestVersion.

checkForUpdate()

Méthode de SwUpdate qui force une vérification immédiate auprès du serveur. Retourne une Promise<boolean> indiquant si une mise à jour a été trouvée.

activateUpdate()

Méthode de SwUpdate qui active la dernière version téléchargée, sans recharger la page. Retourne une Promise<boolean>. À utiliser avec précaution : sans rechargement explicite ensuite, l'app shell et des ressources chargées à la demande (lazy chunks) peuvent provenir de deux versions différentes.

unrecoverable

Observable de SwUpdate qui émet un UnrecoverableStateEvent (avec un champ reason) quand le service worker se trouve dans un état dont il ne peut pas se sortir seul — typiquement une ressource attendue (un chunk chargé à la demande) qui a disparu du cache du navigateur. Seule solution : recharger complètement la page.

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.