TanStack Query en 2026: adaptador Lit, Solid v6 beta y claves de consulta estables
¿Qué hay de nuevo en los adaptadores de TanStack Query: soporte para Lit, Solid Query v6 beta, herramientas de desarrollo mejoradas y tipado con persister? Además, ¿por qué las claves de consulta estables siguen siendo importantes?
Las banderas de carga creadas manualmente y la lógica para datos obsoletos alrededor de useEffect suelen costar más de lo que ahorran. TanStack Query se ha consolidado como la capa de estado del servidor para muchos proyectos React, y las versiones recientes siguen mejorando los adaptadores sin obligar a reescrituras constantes.
Por qué la biblioteca sigue mereciendo su lugar
Llamarla simplemente una herramienta HTTP ligera es subestimarla. Este conjunto de herramientas abarca el caché de estado remoto, la actualización en segundo plano y el intercambio de resultados en toda la interfaz de usuario, sin las complejidades que requerían los almacenes globales antiguos para manejar datos de red. La versión v5 puso énfasis en una interfaz más sencilla que es fácil de aprender, manteniendo al mismo tiempo su capacidad funcional.
Aspectos destacables en las versiones actuales
- Cobertura más amplia de frameworks. La próxima versión v6 de Solid Query ya está en beta, con un mejor soporte SSR para consultas diferidas y una reactividad más cercana al modelo más reciente de Solid.
@tanstack/query-lit lleva el mismo modelo conceptual a las aplicaciones Lit.NoInfer, mejoró la detección del entorno SSR al descontinuarse ayudantes antiguos como isServer, y se resolvieron casos límite relacionados con las mutaciones y las herramientas de desarrollo.La mayor parte de estos cambios son mejoras menores y no implican alteraciones significativas: es el tipo de evolución que se espera de las bibliotecas de infraestructura.
Mantén las claves de consulta simples
Un patrón que aún daña silenciosamente los cachés:
// 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,
});
Las claves deterministas permiten que la biblioteca realice tareas de eliminación de duplicados, reutilice entradas de caché entre componentes y evite secuencias de recarga causadas por claves que cambian por razones no semánticas.
Puntos a tener en cuenta
- Deje Solid Query v6 en entornos no de producción hasta que salga de la versión beta.
- Los paquetes adaptadores se distribuyen según sus propios horarios; lea el registro de cambios del paquete que importe.
- Los proyectos TypeScript deben incorporar las correcciones de tipado de persister incluso cuando el código de la aplicación no haya cambiado.
Los equipos que ya utilizan TanStack Query pueden considerar esta actualización como un período de mantenimiento: fijen deliberadamente los adaptadores, revisen las notas específicas del framework antes de actualizar y mantengan estables las claves para que el intercambio de caché siga siendo predecible. Los nuevos usuarios obtienen funcionalidades de caché y sincronización en segundo plano sin necesidad de cadenas de efectos escritas a mano, además de adaptadores que van más allá de React por sí solo. Esa combinación de un núcleo estable y cobertura más amplia del framework es la razón por la cual el proyecto sigue siendo útil a medida que las tecnologías utilizadas se diversifican.