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
onMutateet reçue commecontextparonError. 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.
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.