Formations — 1 037 leçons en français

Accueil › React › Mises à jour optimistes

Mises à jour optimistes

État serveur et cacheavance

Les quatre temps, et le troisième est obligatoire

1. relever l'instantané du cache
2. écrire la valeur devinée      → l'interface réagit tout de suite
3. si le serveur refuse : remettre l'instantané ET le dire
4. réconcilier avec ce que le serveur a vraiment enregistré

Une mise à jour optimiste sans l'étape 3 n'est pas une optimisation : c'est un bogue qui mentira à l'utilisateur. Il a vu la case cochée, l'écran le lui confirme, et le serveur n'a rien enregistré. L'erreur sera découverte le lendemain, par quelqu'un d'autre.

La forme complète

useMutation({
  mutationFn: (tache) => enregistrer(tache),

  onMutate: async (nouvelle) => {
    await queryClient.cancelQueries({ queryKey: ["tache", nouvelle.id] });
    const instantane = queryClient.getQueryData(["tache", nouvelle.id]);
    queryClient.setQueryData(["tache", nouvelle.id], (ancien) => ({ ...ancien, ...nouvelle }));
    return { instantane };
  },

  onError: (erreur, nouvelle, contexte) => {
    queryClient.setQueryData(["tache", nouvelle.id], contexte.instantane);
    signaler("Enregistrement impossible, la modification a été annulée");
  },

  onSettled: (donnees, erreur, nouvelle) => {
    queryClient.invalidateQueries({ queryKey: ["tache", nouvelle.id] });
  },
});

Chaque ligne répond à un scénario précis :

Ligne Sans elle
cancelQueries une revalidation en vol écrase la valeur optimiste
getQueryData aucun retour en arrière possible
{ ...ancien, ...nouvelle } la référence ne change pas, le rendu non plus
setQueryData dans onError l'écran garde un changement qui n'a pas eu lieu
signaler(…) le retour en arrière passe pour un bogue d'affichage
invalidateQueries la valeur devinée reste, à la place de la vraie

Les termes à connaître

onMutate

Le rappel exécuté avant l'envoi de la mutation. C'est là qu'on écrit le changement dans le cache, et là qu'on prend l'instantané qui servira au retour en arrière.

Instantané

La valeur du cache relevée avant modification, renvoyée par onMutate et reçue comme context par onError. Sans elle, aucun retour en arrière n'est possible.

Retour en arrière

La remise en place de l'instantané quand le serveur refuse. C'est l'étape qu'on oublie, et son absence transforme un échec en mensonge durable.

Réconciliation

Le remplacement de la valeur devinée par celle que le serveur renvoie. Ce qu'on avait supposé n'est jamais exactement ce qui a été enregistré.

cancelQueries

L'annulation des rechargements en vol avant d'écrire dans le cache, pour qu'une réponse partie avant la mutation n'écrase pas la valeur optimiste.

onSettled

Le rappel exécuté après succès comme après échec. L'endroit où invalider, pour que la vérité du serveur ait le dernier mot dans les deux cas.

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.