queryKey

React 🟡 Mid

Dé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.
#data-fetching

← → au clavier pour passer d'une fiche à l'autre