Formations — 1 037 leçons en français

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 0 par 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 cacheTime avant 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'invalidateQueries qui décide lesquelles des entrées marquées sont rechargées tout de suite — active par 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.

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.