Una biblioteca de React Hooks para obtener datos: primero devuelve los datos en caché y luego los revalida en segundo plano.
TanStack/query
Biblioteca de gestión de estado asíncrono y obtención de datos para aplicaciones web, con bindings para React, Vue, Svelte y Solid.
- Estrellas
- 50,456
- Forks
- 4,222
- Issues abiertos
- 151
- Último commit
- hace 11 horas
¿Qué es?
TanStack Query es una biblioteca de gestión de estado asíncrono que se encarga de obtener, almacenar en caché, sincronizar y actualizar el estado del servidor en aplicaciones web. No depende de ningún protocolo, por lo que funciona con REST, GraphQL o cualquier fuente de datos basada en promesas.
La biblioteca cubre necesidades habituales de obtención de datos, como el almacenamiento en caché, la actualización de datos en segundo plano, la paginación y el scroll infinito, las mutaciones, las consultas dependientes, la precarga y la cancelación de solicitudes. También es compatible con React Suspense. La lógica central reside en un paquete independiente del framework, con adaptadores oficiales para React Query, Vue Query, Svelte Query y Solid Query.
El proyecto está escrito en TypeScript y forma parte del ecosistema más amplio de TanStack, que incluye Router, Table, Form y Virtual.
Funciones clave
- 01Almacenamiento en caché con actualización de datos en segundo plano al estilo stale-while-revalidate
- 02Paginación, scroll infinito y consultas dependientes
- 03Mutaciones con actualizaciones de la caché
- 04Precarga y cancelación de solicitudes
- 05Bindings oficiales para React, Vue, Svelte y Solid
Casos de uso
- Crear frontends con React o Vue que obtengan datos de APIs REST o GraphQL
- Reemplazar la lógica escrita a mano para gestionar estados de carga, errores y caché en aplicaciones cliente
- Implementar listas con scroll infinito o tablas paginadas que obtengan datos remotos
Inicio rápido
- 1
Lee la documentación y elige la integración para tu framework
- 2
Sigue las instrucciones de configuración para contribuir en CONTRIBUTING.md
Temas
Preguntas frecuentes
- ¿Qué es query?
- Biblioteca de gestión de estado asíncrono y obtención de datos para aplicaciones web, con bindings para React, Vue, Svelte y Solid. TanStack Query es una biblioteca de gestión de estado asíncrono que se encarga de obtener, almacenar en caché, sincronizar y actualizar el estado del servidor en aplicaciones web. No depende de ningún protocolo, por lo que funciona con REST, GraphQL o cualquier fuente de datos basada en promesas.
- ¿query es gratuito? ¿Qué licencia tiene?
- query es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿query sigue mantenido?
- Mantenimiento activo. El último commit de query fue el 21 oct 2026.
- ¿Para qué puedo usar query?
- Crear frontends con React o Vue que obtengan datos de APIs REST o GraphQL Reemplazar la lógica escrita a mano para gestionar estados de carga, errores y caché en aplicaciones cliente Implementar listas con scroll infinito o tablas paginadas que obtengan datos remotos
- ¿Cómo se instala query?
- Lee la documentación y elige la integración para tu framework Sigue las instrucciones de configuración para contribuir en CONTRIBUTING.md
- ¿Dónde consigo query?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/TanStack/query
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Librería headless de tablas para TypeScript y JavaScript, con la que crear datagrids y controlar por completo el marcado y los estilos en React, Vue, Solid, Svelte y más.
Una pequeña biblioteca de gestión de estado para React basada en hooks, sin necesidad de providers.
Editor de texto enriquecido sin interfaz y agnóstico al framework, basado en ProseMirror y ampliable con un amplio conjunto de extensiones.
Bibliotecas open source para React y Svelte con las que crear interfaces interactivas basadas en nodos, como diagramas de flujo, grafos y editores de workflows.
Solución abierta y multiplataforma para crear una sola app con React o Vue que funcione en miniprogramas de WeChat, Alipay y otras plataformas, en la web H5 y en React Native.