Uma biblioteca de React Hooks para buscar dados que retorna primeiro os dados em cache e depois os revalida em segundo plano.
TanStack/query
Biblioteca de gerenciamento de estado assíncrono e busca de dados para apps web, com integrações para React, Vue, Svelte e Solid.
- Estrelas
- 50,456
- Forks
- 4,222
- Issues abertas
- 151
- Último commit
- há 4 horas
O que é?
TanStack Query é uma biblioteca de gerenciamento de estado assíncrono que cuida da busca, do cache, da sincronização e da atualização do estado do servidor em aplicações web. Ela não depende de um protocolo específico, então funciona com REST, GraphQL ou qualquer fonte de dados baseada em promises.
A biblioteca atende a necessidades comuns de busca de dados, como cache, novas buscas em segundo plano, paginação e rolagem infinita, mutations, queries dependentes, prefetching e cancelamento de requisições. Também oferece suporte ao React Suspense. A lógica central fica em um pacote independente de framework, com adaptadores oficiais para React Query, Vue Query, Svelte Query e Solid Query.
O projeto é escrito em TypeScript e faz parte do ecossistema mais amplo do TanStack, que inclui Router, Table, Form e Virtual.
Recursos principais
- 01Cache com novas buscas em segundo plano no estilo stale-while-revalidate
- 02Paginação, rolagem infinita e queries dependentes
- 03Mutations com atualizações no cache
- 04Prefetching e cancelamento de requisições
- 05Integrações oficiais para React, Vue, Svelte e Solid
Casos de uso
- Desenvolver front-ends em React ou Vue que carregam dados de APIs REST ou GraphQL
- Substituir a lógica escrita manualmente para estados de carregamento, erro e cache em apps cliente
- Implementar listas com rolagem infinita ou tabelas paginadas alimentadas por dados remotos
Início rápido
- 1
Leia a documentação e escolha a integração para o seu framework
- 2
Siga as instruções de configuração para contribuir em CONTRIBUTING.md
Tópicos
Perguntas frequentes
- O que é query?
- Biblioteca de gerenciamento de estado assíncrono e busca de dados para apps web, com integrações para React, Vue, Svelte e Solid. TanStack Query é uma biblioteca de gerenciamento de estado assíncrono que cuida da busca, do cache, da sincronização e da atualização do estado do servidor em aplicações web. Ela não depende de um protocolo específico, então funciona com REST, GraphQL ou qualquer fonte de dados baseada em promises.
- query é gratuito? Qual é a licença?
- query é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- query ainda é mantido?
- Manutenção ativa. O último commit de query foi em 21 de out. de 2026.
- Para que posso usar query?
- Desenvolver front-ends em React ou Vue que carregam dados de APIs REST ou GraphQL Substituir a lógica escrita manualmente para estados de carregamento, erro e cache em apps cliente Implementar listas com rolagem infinita ou tabelas paginadas alimentadas por dados remotos
- Como instalar query?
- Leia a documentação e escolha a integração para o seu framework Siga as instruções de configuração para contribuir em CONTRIBUTING.md
- Onde consigo query?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/TanStack/query
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Biblioteca headless de tabelas em TypeScript/JavaScript para criar grades de dados com controle total sobre a marcação e os estilos, compatível com React, Vue, Solid, Svelte e outros.
Uma biblioteca leve de gerenciamento de estado para React, baseada em hooks e sem necessidade de providers.
Editor de texto rico headless e independente de framework, baseado no ProseMirror e extensível por meio de uma ampla variedade de extensões.
Bibliotecas open source para React e Svelte que permitem criar interfaces interativas baseadas em nós, como fluxogramas, grafos e editores de workflows.
Uma solução aberta e multiplataforma, compatível com vários frameworks, para criar um único app que roda em mini programs do WeChat, Alipay e outras plataformas, na web H5 e no React Native com React ou Vue.