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-workerqui expose l'état des mises à jour disponibles (versionUpdates,unrecoverable) et deux méthodes pour agir (checkForUpdate(),activateUpdate()).- versionUpdates
Observable de
SwUpdatequi é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. ExposecurrentVersionetlatestVersion.- checkForUpdate()
Méthode de
SwUpdatequi force une vérification immédiate auprès du serveur. Retourne unePromise<boolean>indiquant si une mise à jour a été trouvée.- activateUpdate()
Méthode de
SwUpdatequi active la dernière version téléchargée, sans recharger la page. Retourne unePromise<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
SwUpdatequi émet unUnrecoverableStateEvent(avec un champreason) 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.
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.