queryKey
React 🟡 MidDéfinition
Identifiant unique d'une requête dans TanStack Query, utilise pour le cache, la deduplication et l'invalidation. Généralement un tableau hiérarchique.
Analogie
Comme l'étiquette d'un tiroir de rangement : elle dit exactement ce qu'il y a dedans et permet de le retrouver.
Exemple de code
// Hierarchique pour une invalidation fine
useQuery({ queryKey: ['users'] });
useQuery({ queryKey: ['users', userId] });
useQuery({ queryKey: ['users', userId, 'posts'] });
// Invalider tout ce qui commence par 'users'
queryClient.invalidateQueries({ queryKey: ['users'] });
Cas d'usage
Structurer les clés de façon hiérarchique pour pouvoir invalider a différents niveaux de granularite.
Anti-pattern
Utiliser des strings simples au lieu de tableaux hiérarchiques, rendant l'invalidation partielle impossible.