tanstack-query

SKILL.md

Status: Production Ready ✅ Last Updated: 2025-10-22 Dependencies: React 18.0+, TypeScript 4.7+ (recommended) Latest Versions: @tanstack/react-query@5.90.5, @tanstack/react-query-devtools@5.90.2

❌ Never use query callbacks (onSuccess, onError, onSettled in queries)

This skill prevents 8 documented issues from v5 migration and common mistakes:

Cette compétence fournit des connaissances complètes sur la gestion de l'état du serveur TanStack Query v5 (React Query) dans les applications React. Il doit être utilisé lors de la configuration de la récupération de données avec useQuery, de l'implémentation de mutations avec useMutation, de la configuration de QueryClient, de la gestion des stratégies de mise en cache, de la migration de la v4 vers la v5, de la mise en œuvre de mises à jour optimistes, de l'utilisation de requêtes infinies ou de la rencontre d'erreurs de requête/mutation. À utiliser lors de : l'initialisation de TanStack Query dans des projets React, la configuration des paramètres QueryClient, la création de hooks de requête personnalisés, la mise en œuvre de mutations avec gestion des erreurs, la configuration de mises à jour optimistes, l'utilisation de useInfiniteQuery pour la pagination, la migration de React Query v4 vers la v5, le débogage de problèmes de données obsolètes, la résolution de problèmes de mise en cache, la résolution des modifications avec rupture de la v5, la mise en œuvre de requêtes en suspens ou la configuration d'outils de développement de requêtes. Mots clés : TanStack Query, React Query, useQuery, useMutation, useInfiniteQuery, useSuspenseQuery, QueryClient, QueryClientProvider, récupération de données, état du serveur, mise en cache, staleTime, gcTime, invalidation de requête, prélecture, mises à jour optimistes, mutations, clés de requête, fonctions de requête, limites d'erreur, suspense, React Query DevTools, migration v5, v4 à v5, cascades de requêtes, récupération en arrière-plan, cacheTime renommé, état de chargement renommé, état en attente, initialPageParam requis, keepPreviousData supprimé, placeholderData, rappels de requête supprimés, onSuccess supprimé, onError supprimé, syntaxe d'objet requise Source : jackspace/claudeskillz.

Voir l'original