Accueil › Angular › Fonctionner hors-ligne
Fonctionner hors-ligne
PWA et mode hors-ligneavance
Le hors-ligne d'une PWA n'est jamais « tout ou rien » : seules les ressources déjà demandées au moins une fois en ligne — et couvertes par un assetGroup ou un dataGroup du service worker — restent disponibles sans réseau. Une fiche produit jamais consultée ne peut pas apparaître par magie. Il faut donc distinguer ce que l'utilisateur peut raisonnablement faire hors-ligne (consulter un catalogue déjà chargé, revoir son panier) de ce qui reste impossible (une recherche jamais faite, un paiement).
navigator.onLine donne un premier signal, mais imparfait : il reflète l'état de l'interface réseau du système, pas la joignabilité réelle d'un serveur (un Wi-Fi connecté à un portail captif reste true).
import { signal } from '@angular/core';
const enLigne = signal(navigator.onLine);
window.addEventListener('online', () => enLigne.set(true));
window.addEventListener('offline', () => enLigne.set(false));
Pour stocker des données consultables hors-ligne, localStorage convient à de petites préférences (synchrone, quelques Ko, chaînes uniquement), tandis qu'IndexedDB convient à un volume plus important de données structurées — comme un catalogue produits entier. Une file d'actions en attente permet d'enregistrer localement ce que l'utilisateur fait hors-ligne (ajout au panier) pour le rejouer au retour du réseau, en acceptant qu'un conflit soit possible (le produit n'existe plus).
Les termes à connaître
- navigator.onLine
Propriété du navigateur qui indique si une interface réseau est active. Elle ne garantit pas qu'un serveur précis est réellement joignable (faux positif classique : connecté à un Wi-Fi sans accès Internet réel, portail captif). À compléter par la détection des échecs de requêtes réelles.
- IndexedDB
Base de données du navigateur, asynchrone, orientée objets, avec une capacité largement supérieure à
localStorage. Adaptée pour stocker un volume de données structurées à consulter hors-ligne, comme un catalogue produits.- File d'actions en attente
Liste d'actions effectuées hors-ligne (ajout au panier, modification), stockée localement et rejouée vers le serveur au retour du réseau. Nécessite de gérer les conflits (la donnée a changé côté serveur entre-temps).
- manifest.webmanifest
Fichier JSON décrivant l'application installable : nom, icônes, couleur de thème, et surtout
display(standalone,fullscreen,minimal-ui,browser), qui détermine si l'app s'ouvre comme une application autonome ou dans un onglet de navigateur classique.- beforeinstallprompt
Événement du navigateur (non standardisé sur toutes les plateformes) permettant de proposer un bouton d'installation personnalisé au lieu de la bannière automatique. Absent sur Safari/iOS, qui n'offre que l'installation manuelle via le menu de partage.
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.