Accueil › React › Le cache et ses clés
Le cache et ses clés
État serveur et cacheavance
La clé est l'identité de la donnée
const { data } = useQuery({
queryKey: ["clients", { page, ville }],
queryFn: () => chargerClients({ page, ville }),
});
Le cache est un dictionnaire. queryKey est la clé d'entrée, queryFn la
façon de remplir la case si elle est absente. Tout le comportement de la
bibliothèque découle de là : deux composants qui écrivent la même clé partagent
la même entrée et déclenchent une requête ; deux clés différentes sont deux
données sans rapport.
D'où la seule règle à retenir :
Tout ce qui, en changeant, change la réponse du serveur doit figurer dans la clé.
Page, filtre, tri, identifiant de la ressource, langue, utilisateur. Ce qui n'est pas dans la clé n'existe pas pour le cache — et une variable oubliée produit deux réponses différentes qui se disputent la même case.
Ce que le hachage pardonne, et ce qu'il ne pardonne pas
["clients", { page: 1, tri: "nom" }] // même entrée
["clients", { tri: "nom", page: 1 }] // que celle-ci
["clients", 1] // deux entrées
[1, "clients"] // distinctes
Les propriétés d'un objet sont triées avant sérialisation : leur ordre d'écriture est sans effet. L'ordre des éléments du tableau, lui, est significatif. La convention est donc d'aller du plus général au plus précis.
Pourquoi un tableau
Parce qu'un préfixe désigne une famille :
| Clé de filtre | Atteint |
|---|---|
["clients"] |
toutes les vues de clients |
["clients", "liste"] |
les listes, pas les fiches |
["clients", "fiche", 7] |
cette fiche seulement |
Une seule invalidation couvre une ressource entière. C'est ce qu'une clé en chaîne unique rendrait impossible.
Les termes à connaître
- queryKey
Le tableau qui identifie une donnée dans le cache. Deux appels de même clé partagent la même entrée ; deux clés différentes sont deux données différentes.
- Hachage de clé
La transformation de la clé en texte pour servir d'index. TanStack Query trie les propriétés des objets avant de sérialiser : l'ordre d'écriture des clés d'un objet n'a donc aucun effet.
- Clé canonique
Une clé construite par une règle unique, de sorte que deux demandes équivalentes produisent exactement la même clé — et donc une seule entrée de cache.
- Correspondance partielle
Le fait qu'une clé de filtre atteigne toute clé dont elle est un préfixe.
["clients"]désigne aussi["clients", { page: 2 }].- Fabrique de clés
Un objet qui centralise la construction des clés d'un domaine, pour que lecture et invalidation ne puissent pas se désynchroniser.
- Dépendance cachée
Une variable qui change la réponse du serveur sans figurer dans la clé — identifiant de l'utilisateur, langue, organisation active. C'est la cause des fuites de données entre comptes.
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.