AngularAtlaséd. 22.2

Chap. 15Temps réel et hors ligne66 / 75

Mises à jour optimistes et rollback

Une UI instantanée qui reste honnête : snapshot et rollback, réponses dans le désordre, clés d’idempotence.

architecture ~0 min de lecture

Attendre le serveur avant de changer l’écran, c’est honnête, mais lent : un like qui apparaît au bout de 400 ms donne l’impression d’être cassé. Une mise à jour optimiste change l’interface tout de suite, suppose que la requête réussira et annule le changement si ce n’est pas le cas.

L’idée tient en une phrase. C’est dans les détails que les applications cassent : ce que vous restaurez exactement en cas d’échec, ce qui se passe quand deux réponses arrivent dans le mauvais ordre, et comment le serveur évite d’appliquer deux fois la même action quand vous réessayez.

Pourquoi c’est important
Presque toutes les requêtes réussissent. Faire attendre tous les utilisateurs pour les rares échecs est un mauvais compromis — mais une interface optimiste qui ment quand un échec survient est pire : l’utilisateur repart en croyant que sa modification a été enregistrée.

Le schéma : mémoriser, appliquer, confirmer ou annuler

Trois étapes. Mémoriser la valeur actuelle, la changer localement, envoyer la requête. En cas de succès, la réponse du serveur remplace votre supposition — elle peut différer (un id, un horodatage, un texte nettoyé). En cas d’échec, restaurez ce que vous aviez mémorisé et dites-le à l’utilisateur : une valeur qui revient en arrière sans message ressemble à un bug.

import { Service, inject, signal } from '@angular/core';
import { firstValueFrom } from 'rxjs';
import { TodoApi, type Todo } from './todo-api';

@Service()
export class TodoStore {
  private readonly api = inject(TodoApi);
  readonly todos = signal<readonly Todo[]>([]);
  readonly error = signal<string | null>(null);

  async toggle(id: string): Promise<void> {
    const before = this.todos().find((t) => t.id === id);
    if (!before) return;

    this.patch(id, { done: !before.done }); // 1. l’écran change MAINTENANT
    try {
      const saved = await firstValueFrom(this.api.update(id, { done: !before.done }));
      this.patch(id, saved); // 2. la version du serveur l’emporte (horodatages, texte normalisé...)
    } catch {
      this.patch(id, { done: before.done }); // 3. annuler UNIQUEMENT cet élément...
      this.error.set(`Impossible d’enregistrer « ${before.title} ». Annulé.`); // ...et le dire
    }
  }

  private patch(id: string, change: Partial<Todo>): void {
    this.todos.update((list) => list.map((t) => (t.id === id ? { ...t, ...change } : t)));
  }
}
LiveOptimiste ou pessimiste, avec un serveur qui tombe

L’interface

Enregistré sur le serveur

  • Rédiger les notes de version
  • Relire la pull request
  • Mettre à jour les dépendances
  • Corriger le test instable
effet visible après
—
requêtes
0
échouées
0
interface ≠ serveur
0
Cochez des tâches dans les deux modes et comparez le délai avant de voir l’effet. Choisissez ensuite « toute la liste » et appuyez sur « Jouer le scénario ».

Annulez ce que vous avez changé, pas toute la liste

Enregistrer un snapshot de toute la liste est la version la plus tentante, et elle est fausse dès que deux requêtes sont en vol. Le snapshot pris par la première requête ne contient pas la seconde modification ; quand la première échoue, le restaurer efface aussi une modification que le serveur a déjà enregistrée. Le scénario de la démo fait exactement cela : l’interface et le serveur finissent par ne plus être d’accord, sans rien pour les réconcilier. Annulez par élément, ou appliquez l’opération inverse.

// ✗ Un snapshot de TOUTE la liste capture aussi les autres modifications encore en vol
async toggle(id: string) {
  const snapshot = this.todos(); // pris avant le prochain clic de l’utilisateur...
  this.patch(id, { done: !this.find(id).done });
  try {
    await firstValueFrom(this.api.update(id, ...));
  } catch {
    this.todos.set(snapshot); // ...donc ceci annule aussi une modification que le serveur a DÉJÀ enregistrée
  }
}

La création optimiste demande une étape de plus. Le nouvel élément n’a pas encore de vrai id, donc on lui en donne un temporaire, remplacé quand le serveur répond. D’ici là, les modifications de cet élément doivent attendre ou utiliser l’id temporaire, que le serveur ne connaît pas.

async add(title: string): Promise<void> {
  const temp: Todo = { id: `tmp-${crypto.randomUUID()}`, title, done: false };
  this.todos.update((list) => [...list, temp]);
  try {
    const saved = await firstValueFrom(this.api.create({ title }));
    // l’id temporaire disparaît : toute modification ultérieure utilise le vrai
    this.todos.update((list) => list.map((t) => (t.id === temp.id ? saved : t)));
  } catch {
    this.todos.update((list) => list.filter((t) => t.id !== temp.id));
    this.error.set(`« ${title} » n’a pas été ajouté.`);
  }
}

Des réponses qui arrivent dans le mauvais ordre

Activez un réglage, désactivez-le, réactivez-le, rapidement. Trois requêtes partent, et rien ne garantit l’ordre dans lequel les réponses reviennent. Si chaque réponse écrase l’état, c’est la dernière réponse arrivée qui gagne — pas le dernier choix de l’utilisateur.

LiveTrois clics rapides, latence aléatoire

Chaque clic envoie une requête. Sa barre s’arrête quand la réponse arrive.

Votre choix
off
La dernière réponse gagne
off …
Seulement la plus récente
off …

« La dernière réponse gagne » s’est trompée 0 fois sur 0.

Appuyez plusieurs fois sur « Cliquer trois fois ». Chaque requête prend 0,3 à 2 s ; regardez l’ordre d’arrivée et le score en dessous.

Deux remèdes, pour deux problèmes différents. Seulement la plus récente : chaque requête reçoit un numéro et seule la réponse à la plus récente peut écrire — cela répare l’interface. Mais le serveur peut aussi avoir reçu les requêtes dans le désordre. Si l’état final sur le serveur compte, sérialisez les écritures avec concatMap (une requête à la fois, dans l’ordre des clics), ou envoyez une version que le serveur vérifie. Pour les recherches, où seule la dernière compte, switchMap annule les anciennes ; voir les opérateurs d’ordre supérieur.

private latest = 0;
readonly enabled = signal(false); // ce que voit l’utilisateur (optimiste)
private readonly confirmed = signal(false); // ce que le serveur a confirmé en dernier

async setNotifications(on: boolean): Promise<void> {
  const id = ++this.latest;
  this.enabled.set(on);
  try {
    const saved = await firstValueFrom(this.api.saveSettings({ notifications: on }));
    this.confirmed.set(saved.notifications);
    // une réponse plus ancienne qui arrive tard ne doit pas écraser un choix plus récent
    if (id === this.latest) this.enabled.set(saved.notifications);
  } catch {
    if (id === this.latest) this.enabled.set(this.confirmed());
  }
}

Idempotence : une action, appliquée une seule fois

Les interfaces optimistes réessaient, et voici le piège : la requête est arrivée au serveur, la commande a été créée, seule la réponse s’est perdue. Un nouvel essai crée une seconde commande. Le remède est une Idempotency-Key : un UUID généré une seule fois par action de l’utilisateur et envoyé à chaque nouvel essai. Le serveur retient les clés déjà traitées et, pour une répétition, renvoie le résultat d’origine au lieu de refaire le travail.

import { HttpClient, HttpContext, HttpContextToken, HttpInterceptorFn } from '@angular/common/http';
import { retry } from 'rxjs';

export const IDEMPOTENCY_KEY = new HttpContextToken<string | null>(() => null);

/** La clé voyage dans le contexte de la requête et devient un en-tête. */
export const idempotencyInterceptor: HttpInterceptorFn = (req, next) => {
  const key = req.context.get(IDEMPOTENCY_KEY);
  return next(key ? req.clone({ setHeaders: { 'Idempotency-Key': key } }) : req);
};

// Une clé par ACTION DE L’UTILISATEUR, réutilisée à chaque nouvel essai de cette action.
placeOrder(order: Order) {
  const key = crypto.randomUUID();
  return this.http
    .post<OrderConfirmation>('/api/orders', order, {
      context: new HttpContext().set(IDEMPOTENCY_KEY, key),
    })
    .pipe(retry({ count: 3, delay: 1000 })); // même observable → même contexte → même clé
}

La clé appartient à l’action de l’utilisateur, pas à la requête HTTP : générez-la quand l’utilisateur appuie sur le bouton, pas dans un intercepteur qui en créerait une nouvelle à chaque essai. Les nouveaux essais eux-mêmes sont traités dans HttpClient et intercepteurs.

Quand OUI, quand NON

Quand OUI
  • Des actions fréquentes et peu coûteuses, qui réussissent presque toujours : likes, cases cochées, marquer comme lu.
  • Des modifications faciles à annuler : réordonner, renommer, la quantité dans un panier.
  • Des interfaces où la latence se sent à chaque clic : listes, tableaux, éditeurs.
Quand NON
  • Les paiements et tout ce qui touche à l’argent : l’utilisateur a besoin d’une vraie confirmation.
  • Les actions irréversibles : envoyer un e-mail, supprimer définitivement, publier.
  • Une validation qui échoue souvent côté serveur (un nom d’utilisateur déjà pris) : vous passeriez votre temps à annuler.

Pièges fréquents

  • Un rollback silencieux. La coche disparaît sans message ; l’utilisateur croit l’application cassée, ou ne remarque rien et passe à autre chose.
  • Un snapshot de toute la liste. Il annule aussi d’autres modifications en vol, y compris certaines que le serveur a déjà enregistrées.
  • La dernière réponse gagne. Une vieille réponse arrivée en retard écrase le choix le plus récent. Numérotez les requêtes.
  • Réessayer sans clé d’idempotence. Une réponse perdue devient une commande en double.
  • Ne jamais se réconcilier avec le serveur. Des ids temporaires jamais remplacés, un texte normalisé qui ne revient jamais : l’interface s’éloigne peu à peu des données.

Aide-mémoire

mise à jour optimiste  snapshot → appliquer tout de suite → envoyer → version serveur | rollback + message
rollback               seulement ce que cette requête a changé (l’élément / l’opération inverse)
pas toute la liste     un snapshot de la liste annule aussi les autres requêtes en vol
réponse du serveur     remplace la supposition locale (ids, horodatages, texte normalisé)
ids temporaires        tmp-uuid jusqu’à la réponse de « create », puis le vrai id
réponses désordonnées  un id par requête : seule la plus récente peut écrire (newest-only)
écritures dans l’ordre concatMap : une à la fois, dans l’ordre des clics
lectures               switchMap : annuler l’ancienne recherche, garder la nouvelle
nouveaux essais        Idempotency-Key = un UUID par action, le même à chaque essai
jamais optimiste       paiements, actions irréversibles, validation qui échoue souvent
rollback sans message = une UI qui a l’air cassée

Chap. 15 · 0 sur 3 terminées

Leçon terminée ?

Marquez-la : elle apparaîtra sur votre carte, dans le sommaire et sur la page d’accueil.

Se marque toute seule une fois la leçon lue en entier.

  1. WebSockets : un temps réel qui résiste au réseau
  2. Mises à jour optimistes et rollback
  3. Offline-first : Service Worker et cache
Voir toute votre carte

Les 75 pages · tapez pour filtrer

  • 01Nouveautés d’Angular 21 & 22Tous les changements importants de la v21 et de la v22, en bref, avec un lien vers la page qui explique chacun.Départ
  • 01Votre première application, pas à pasUne liste de lecture construite d’un composant vide jusqu’à une application terminée — signals, @for, inputs et outputs, un service et un formulaire, pas à pas.Départ
  • 01Décisions rapides« Où mettre ça ? », « Signal ou Observable ? », « Shared ou feature ? » — des réponses courtes aux questions de tous les jours.Départ
  • 01Questions d’entretien Angular60 vraies questions d’entretien pour profils junior, confirmé et senior, avec la réponse à donner, la relance et les signaux d’alerte. Plus un entretien blanc.Départ
  • 02Standalone et bootstrapComment une application démarre sans NgModule : bootstrapApplication, app.config.ts, imports dans le composant.Fondamentaux modernes
  • 02Data binding et événementsInterpolation, bindings de propriétés et d’attributs, événements avec $event et filtres de touches, et comment [( )] est construit — ce qui entre dans le DOM et ce qui en revient.Fondamentaux modernes
  • 02Control Flow : @if, @for, @switchLa syntaxe de blocs qui remplace *ngIf/*ngFor/ngSwitch, avec track, @empty et vérifications d’exhaustivité.Fondamentaux modernes
  • 02@let et les nouvelles expressions de templateVariables locales avec @let, fonctions fléchées, spread, regex, instanceof, commentaires dans les balises.Fondamentaux modernes
  • 02@defer — Lazy Loading dans les templatesChargez les composants lourds uniquement quand c’est nécessaire : triggers, prefetch, placeholder, loading, error.Fondamentaux modernes
  • 02Bindings de classe et de stylePourquoi [class.x] et [style.x] ont remplacé ngClass et ngStyle (avec migration automatique depuis la v21).Fondamentaux modernes
  • 02Styles des composants et encapsulation:host, les trois modes d’encapsulation, les thèmes avec des variables CSS, et pourquoi ::ng-deep est un dernier recours.Fondamentaux modernes
  • 02Pipes : quand et commentPipes pures vs impures, pipes personnalisées, et comment choisir entre une pipe, computed() et une méthode.Fondamentaux modernes
  • 03signal() et computed()Les primitives réactives : état modifiable, état dérivé, égalité, untracked et règles d’immutabilité.Signals et réactivité
  • 03effect() — quand OUI, quand NONEffets de bord synchronisés avec les Signals : localStorage, logs, API impératives. Et leurs pièges.Signals et réactivité
  • 03linkedSignal() — état dérivé modifiableUn signal qui se réinitialise quand sa source change, mais que vous pouvez aussi modifier à la main.Signals et réactivité
  • 03resource, rxResource, httpResourceDes données asynchrones sous forme de Signals : status, value, error, reload, annulation automatique. Stable depuis la v22.Signals et réactivité
  • 03debounced() — signals différésLa version « debounce » d’un signal, sans RxJS. Parfait pour la recherche.Signals et réactivité
  • 03Listes : rechercher, filtrer, trier, paginerUne chaîne de signals computed qui ne recalcule que ce qui a changé, avec les filtres dans l’URL pour qu’un lien rouvre la même vue.Signals et réactivité
  • 03Les Observables depuis zéroCe qu’est un Observable, subscribe et unsubscribe, les opérateurs que vous utilisez chaque semaine, froid ou chaud — et quand un signal suffit.Signals et réactivité
  • 03Signals ↔ RxJStoSignal, toObservable, takeUntilDestroyed, outputFromObservable — et quand RxJS reste le bon choix.Signals et réactivité
  • 04input() et output()Les inputs comme Signals (required, transform, alias) et les outputs typés. Les données descendent, les événements remontent.Composants : communication
  • 04model() — binding bidirectionnelLe « banana-in-a-box » [( )] avec une seule API. Quand l’utiliser, et quand input + output est préférable.Composants : communication
  • 04viewChild et contentChildLes queries comme Signals : viewChild, viewChildren, contentChild, contentChildren, l’option read.Composants : communication
  • 04Lifecycle et DestroyRefQuels hooks comptent encore à l’ère des Signals, afterNextRender, DestroyRef et ngOnChanges typé.Composants : communication
  • 04Projection de contenung-content avec select, plusieurs slots, contenu par défaut et le piège de la projection conditionnelle.Composants : communication
  • 04ng-template et ngTemplateOutletLes templates comme valeurs : les render props en Angular, contexte typé et personnalisation des composants.Composants : communication
  • 05Smart vs DumbContainer vs présentation : qui détient l’état, qui se contente d’afficher, et comment bien les séparer.Conception des composants
  • 05Composants génériques <T>Un DataTable<T> ou un Select<T> correctement typé, avec des templates pour les cellules.Conception des composants
  • 05Composants dynamiquesNgComponentOutlet, createComponent avec inputBinding/outputBinding, et un tableau de bord construit à partir d’une configuration.Conception des composants
  • 05Directives et composition d’hôteLes directives d’attribut, les métadonnées host: {} et la Directive Composition API (hostDirectives).Conception des composants
  • 05Contrôles de formulaire personnalisésFormValueControl (Signal Forms) vs ControlValueAccessor : une notation par étoiles, dans les deux variantes.Conception des composants
  • 05Change DetectionOnPush est la valeur par défaut depuis la v22, Zone.js a disparu depuis la v21. Ce qui déclenche le rendu et comment éviter les mauvaises surprises.Conception des composants
  • 06inject() et @Service()Le nouveau décorateur @Service() de la v22, inject() vs le constructeur, et le contexte d’injection.Dependency Injection
  • 06Providers et hiérarchie des injecteursRoot vs route vs composant, useClass/useValue/useFactory/useExisting, et les modificateurs optional/self/skipSelf.Dependency Injection
  • 06InjectionToken et provideX()Configuration typée, fonctions provideFeature(), makeEnvironmentProviders et initializers.Dependency Injection
  • 06injectAsync() — services en Lazy LoadingChargez un service lourd uniquement quand vous en avez besoin, avec prefetch à l’idle.Dependency Injection
  • 07Structure des dossierscore / shared / features, ce que contient chacun, et à quoi ressemble l’intérieur d’une feature.Architecture d’application
  • 07Shared vs featureQuand déplacer un composant dans shared et (surtout) quand NE PAS le faire. Une checklist concrète.Architecture d’application
  • 07Interfaces et modèlesInterface en ligne ou fichier séparé ? DTO vs modèle de domaine, type vs interface, où les ranger.Architecture d’application
  • 07State Management avec les SignalsStores simples à base de Signals, facades, état local vs global, et quand NgRx devient nécessaire.Architecture d’application
  • 07Guide de style et nommageLes conventions officielles actuelles : noms de fichiers sans suffixes, protected, readonly, ordre des membres.Architecture d’application
  • 07Barrels, alias et frontièresindex.ts, alias de chemins, API publique d’une feature et règles de dépendances vérifiables automatiquement.Architecture d’application
  • 07Erreurs : @boundary et ErrorHandlerLe nouveau bloc @boundary de la v22.2, l’ErrorHandler global, les erreurs HTTP et les erreurs de resource.Architecture d’application
  • 08Routing moderne et Lazy LoadingloadComponent, routes enfants, paramètres comme inputs et héritage des paramètres (le nouveau comportement par défaut de la v22).Routing
  • 08Guards et resolverscanActivate, canMatch, canDeactivate et resolve sous forme de fonctions, avec redirections via UrlTree / RedirectCommand.Routing
  • 09Signal Forms — les basesDes formulaires bâtis sur les Signals : form(), [formField], validation par schéma. Stable depuis la v22.Formulaires
  • 09Signal Forms — avancéValidation personnalisée et inter-champs, async/HTTP avec debounce, listes dynamiques, désactivé/masqué, schémas réutilisables.Formulaires
  • 09Reactive Forms typésFormGroup typé, nonNullable, FormArray — et leur cohabitation avec les Signal Forms.Formulaires
  • 10HttpClient, interceptors et couche d’APIHttpClient sans configuration (v21), Fetch par défaut (v22), interceptors fonctionnels et une couche d’API avec mapping des DTO.HTTP et données
  • 11Performance — une checklistCe qui compte vraiment : OnPush + Signals, track, @defer, routes en Lazy Loading, images, bundles et Hydration.Qualité et performance
  • 11Tests avec VitestVitest est le runner par défaut depuis la v21. TestBed, composants avec Signals, services, HTTP et harnesses.Qualité et performance
  • 11DevTools : regarder dans votre applicationChrome DevTools et Angular DevTools pas à pas : ce que montre chaque panneau, avec des exercices qui fonctionnent sur ce site.Qualité et performance
  • 11Angular AriaDes composants headless et accessibles que vous stylez comme vous voulez : tabs, accordion, menu, listbox...Qualité et performance
  • 12SSR, Prerendering et modes de renduQuand rendre sur le serveur, quand au build et quand uniquement dans le navigateur : RenderMode par route, app.routes.server.ts et les coûts réels.SSR et Hydration
  • 12Hydration : event replay et incrémentaleComment le navigateur reprend le HTML du serveur sans le re-rendre : Hydration complète, event replay, @defer (hydrate on …) et erreurs de mismatch.SSR et Hydration
  • 12Code compatible serveurwindow n’existe pas sur le serveur : PLATFORM_ID, afterNextRender, DOCUMENT, TransferState, le cache HTTP et PendingTasks.SSR et Hydration
  • 13Micro frontendsQuand découper une application en plusieurs déploiements vaut le coup, et quand c’est juste de la complexité : Native Federation, Module Federation, iframes, Web Components.Architecture à grande échelle
  • 13Web Components avec Angular ElementscreateCustomElement : un composant Angular utilisé comme balise HTML n’importe où, plus la communication entre applications via des événements et BroadcastChannel.Architecture à grande échelle
  • 13Monorepo, bibliothèques et frontièresUn workspace avec plusieurs applications et bibliothèques : ng generate library, Nx, points d’entrée secondaires, publication et règles de dépendances.Architecture à grande échelle
  • 13Architecture hexagonale (ports et adapters)Un domaine sans Angular, des ports sous forme de classes abstraites et des adapters interchangeables : HTTP, localStorage ou en mémoire, sans toucher à l’UI.Architecture à grande échelle
  • 14Les Signals sous le capotLe graphe réactif : producteurs et consommateurs, push-pull, pourquoi computed est lazy et sans glitch, le problème du diamant et quand les effects s’exécutent.Réactivité avancée
  • 14RxJS avancé : opérateurs d’ordre supérieurswitchMap, mergeMap, concatMap et exhaustMap sur un diagramme interactif, plus retry avec backoff, shareReplay et comment éviter les fuites.Réactivité avancée
  • 14NgRx SignalStoreState Management à grande échelle sur les Signals : withState, withComputed, withMethods, rxMethod, entités et hooks — et quand un store simple suffit.Réactivité avancée
  • 14Machines à états avec les signalsFini les états impossibles : une machine typée sur des signals, avec transitions, gardes et un diagramme d’états en direct.Réactivité avancée
  • 15WebSockets : un temps réel qui résiste au réseauUn socket typé sous forme de signals : reconnexion avec backoff et jitter, heartbeat, file d’attente hors ligne et sécurité SSR.Temps réel et hors ligne
  • 15Mises à jour optimistes et rollbackUne UI instantanée qui reste honnête : snapshot et rollback, réponses dans le désordre, clés d’idempotence.Temps réel et hors ligne
  • 15Offline-first : Service Worker et cacheLe Service Worker d’Angular : stratégies de cache, annonce des nouvelles versions et file d’attente pour les modifications faites hors ligne.Temps réel et hors ligne
  • 16Web WorkersDes calculs lourds sans bloquer l’UI : un vrai worker dans la page, l’échange de messages et quand ça n’en vaut pas la peine.UI avancée et performance
  • 16Listes géantes : virtual scroll100 000 lignes sans latence : le virtual scroll du CDK, itemSize, trackBy et les alternatives (pagination, scroll infini).UI avancée et performance
  • 16Animations modernes et View Transitionsanimate.enter et animate.leave à la place de @angular/animations (déprécié), transitions CSS et View Transitions à la navigation.UI avancée et performance
  • 16Fuites mémoire : les trouver et les corrigerAbonnements, timers et listeners qui survivent à leur composant — comment les repérer dans les DevTools et les fermer.UI avancée et performance
  • 17Sécurité : XSS, sanitisation et CSPCe qu’Angular fait automatiquement contre le XSS, quand bypassSecurityTrust devient dangereux, plus la CSP avec nonce, Trusted Types et XSRF.Sécurité et internationalisation
  • 17Authentification : tokens et refreshUn interceptor qui ajoute le token, le renouvelle une seule fois sur une 401 et rejoue les requêtes en attente — plus où conserver le token.Sécurité et internationalisation
  • 17OAuth 2.1 et OpenID Connect avec PKCELe flux authorization code avec PKCE, pas à pas : verifier et challenge, state et nonce, l’ID token, et pourquoi un BFF est plus sûr.Sécurité et internationalisation
  • 17Internationalisation (i18n)$localize, l’attribut i18n, ICU plural/select, un build par langue vs des traductions à l’exécution, et le formatage selon la locale.Sécurité et internationalisation