TanStack Query en 2026 : adaptateur Lit, version bêta Solid v6, et clés de requête stables

La création manuelle de flags de chargement et de logiques de gestion des données obsolètes autour de useEffect coûte généralement plus qu’elle n’économise. TanStack Query s’est imposé comme couche de gestion de l’état serveur pour de nombreux projets React, et les versions récentes continuent d’améliorer les adaptateurs sans nécessiter de réécritures constantes.

Pourquoi cette bibliothèque mérite toujours sa place

L’appeler un simple outil HTTP est une sous-estimation. Ce toolkit gère le cache de l’état distant, la mise à jour en arrière-plan et le partage des résultats dans toute l’interface utilisateur, sans les complications liées aux anciens stores globaux nécessaires pour gérer les données réseau. La version v5 a mis l’accent sur une interface plus simple à maîtriser tout en conservant ses capacités.

Points importants dans les versions actuelles

• Couverture plus large des frameworks. La prochaine version v6 de Solid Query est en bêta, offrant un meilleur support SSR pour les requêtes différées ainsi qu’une réactivité plus proche du nouveau modèle de Solid.

Soutien à Lit. En plus de React, Vue, Svelte et Solid, @tanstack/query-lit apporte le même modèle de pensée aux applications Lit.

Outils de développement améliorés. Angular Query a obtenu une option de thème, et l’expérience d’affichage des erreurs commune est en cours de validation afin que l’inspection du cache paraisse familière quel que soit l’adaptateur utilisé.

Patchs de fiabilité. La saisie avec Persister a été affinée autour de NoInfer, la détection de l’environnement SSR s’est améliorée avec la suppression de anciens outils comme isServer, et les cas limites liés aux mutations et aux outils de développement ont été corrigés.

La plupart de ces améliorations visent à affiner les fonctionnalités plutôt qu’à introduire des changements disruptifs — c’est le profil souhaité pour les bibliothèques d’infrastructure.

Gardez les clés de requête simples

Un schéma qui continue de corrompre silencieusement les caches :

// fragile — breaks cache matching silently
useQuery({
  queryKey: ['user', userId, Math.random()],
  queryFn: fetchUserProfile,
});

// stable, predictable, cache-friendly
useQuery({
  queryKey: ['user', userId] as const,
  queryFn: () => fetchUserProfile(userId),
  staleTime: 60_000,
});

Les clés déterministes permettent à la bibliothèque d’éliminer les doublons, de réutiliser les entrées du cache entre les composants, et d’éviter les séquences de rechargement causées par des clés qui changent pour des raisons non sémantiques.

Points d’attention

• Laissez Solid Query v6 dans les environnements non de production jusqu’à ce qu’il sorte de la version bêta.
• Les paquets d’adaptation sont livrés selon leurs propres calendriers — consultez le journal des modifications du paquet que vous importez.
• Les projets TypeScript devraient intégrer les corrections de typage liées à persister même lorsque le code de l’application reste inchangé.

Les équipes déjà utilisant TanStack Query peuvent considérer cette nouvelle version comme une période de maintenance : fixez délibérément les adaptateurs, consultez rapidement les notes spécifiques au framework avant de mettre à jour, et maintenez la stabilité des clés afin que le partage du cache reste prévisible. Les nouveaux utilisateurs bénéficient d’un système de mise en cache et de synchronisation en arrière-plan sans avoir à écrire manuellement des chaînes d’effets, ainsi que d’adaptateurs qui fonctionnent au-delà de React seul. C’est cette combinaison d’un noyau stable et d’une couverture étendue des frameworks qui explique pourquoi le projet reste utile à mesure que les stacks évoluent.