Accueil › React › Péremption et invalidation
Péremption et invalidation
État serveur et cacheavance
Deux horloges indépendantes
useQuery({
queryKey: ["clients"],
queryFn: chargerClients,
staleTime: 60_000, // fraîche pendant une minute
gcTime: 300_000, // libérée cinq minutes après le dernier observateur
});
| Option | Mesure | Défaut | Ce qui se passe à l'échéance |
|---|---|---|---|
staleTime |
la confiance | 0 |
la donnée devient périmée, et sera rechargée au prochain déclencheur |
gcTime |
la place | 5 min | l'entrée est supprimée de la mémoire |
Les deux ne se croisent pas. staleTime ne supprime rien ; gcTime ne
recharge rien. Et gcTime ne court que lorsque l'entrée n'a plus aucun
composant qui l'observe : une donnée affichée n'est jamais collectée, quelle
que soit son ancienneté.
Avec les valeurs par défaut, une donnée est donc périmée immédiatement et conservée cinq minutes : chaque montage recharge, mais sans écran vide.
Invalider n'est pas vider
await enregistrer(client);
queryClient.invalidateQueries({ queryKey: ["clients"] });
invalidateQueries marque les entrées correspondantes comme périmées, et
recharge celles qui sont observées. L'ancienne valeur reste à l'écran
pendant la requête, isFetching passe à vrai, et l'affichage se corrige à
l'arrivée de la réponse.
| Appel | Effet | Ce que voit l'utilisateur |
|---|---|---|
invalidateQueries |
périmée, puis rechargée | l'ancien, qui se corrige |
removeQueries |
entrée supprimée | un écran de chargement |
resetQueries |
retour à l'état initial | un écran de chargement |
Les confondre coûte cher : removeQueries après une sauvegarde fait clignoter
toute la page alors qu'une ligne devait changer.
Les termes à connaître
- staleTime
La durée pendant laquelle une donnée est considérée fraîche. Tant qu'elle l'est, aucun rechargement automatique n'a lieu. Vaut
0par défaut.- gcTime
La durée pendant laquelle une entrée sans observateur est conservée en mémoire avant d'être supprimée. Cinq minutes par défaut. Nommée
cacheTimeavant la version 5.- Périmé
L'état d'une donnée encore présente et encore affichée, mais dont on n'affirme plus la fraîcheur. Elle sera rechargée au prochain déclencheur.
- Invalidation
Marquer des entrées comme périmées, et recharger celles qui sont observées. La donnée reste affichée pendant le rechargement.
- Suppression
Retirer des entrées du cache. L'écran qui les affichait repasse par un état de chargement, sans donnée à montrer.
- refetchType
L'option d'
invalidateQueriesqui décide lesquelles des entrées marquées sont rechargées tout de suite —activepar défaut, donc celles qui sont affichées.- Revalidation au focus
Le rechargement déclenché par le retour sur l'onglet. Il ne concerne que les données déjà périmées, ce qui explique le rôle central de
staleTime.
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.