Repolode
vercel

vercel/swr

Uma biblioteca de React Hooks para buscar dados que retorna primeiro os dados em cache e depois os revalida em segundo plano.

Estrelas
32,496
Forks
1,401
Issues abertas
241
Último commit
há 5 dias

O que é?

SWR é uma biblioteca de React Hooks para buscar dados. Seu nome vem de stale-while-revalidate, uma estratégia de cache definida na RFC 5861 do HTTP: o hook retorna primeiro os dados em cache (desatualizados), envia uma requisição para revalidá-los e, em seguida, atualiza o componente com o resultado mais recente.

Você chama um único hook, `useSWR`, passando uma chave (geralmente uma URL de API) e uma função fetcher. Ele retorna `data`, `error` e `isLoading`, e o componente é renderizado novamente quando os dados mudam. O fetcher pode ser qualquer função assíncrona, então você pode usar sua própria biblioteca de busca de dados nessa etapa.

A biblioteca inclui cache integrado com deduplicação de requisições, revalidação ao voltar o foco e ao recuperar a conexão de rede, polling, helpers para paginação, suporte a SSR e SSG, mutação local otimista, nova tentativa em caso de erro, tipos TypeScript e suporte a React Suspense. Também funciona com React Native.

Recursos principais

  • 01Cache integrado com deduplicação de requisições
  • 02Revalida ao voltar o foco e ao recuperar a conexão de rede
  • 03Polling e atualizações de dados em tempo real
  • 04Mutação local otimista para atualizar a interface instantaneamente
  • 05Suporte a SSR, SSG, TypeScript e React Suspense

Casos de uso

  • Buscar e armazenar dados de API em cache em um app React ou Next.js
  • Manter dashboards ou feeds atualizados com polling ou revalidação
  • Criar interfaces otimistas para formulários e edições
  • Compartilhar dados entre componentes em um app React Native

Tópicos

Perguntas frequentes

O que é swr?
Uma biblioteca de React Hooks para buscar dados que retorna primeiro os dados em cache e depois os revalida em segundo plano. SWR é uma biblioteca de React Hooks para buscar dados. Seu nome vem de stale-while-revalidate, uma estratégia de cache definida na RFC 5861 do HTTP: o hook retorna primeiro os dados em cache (desatualizados), envia uma requisição para revalidá-los e, em seguida, atualiza o componente com o resultado mais recente.
swr é gratuito? Qual é a licença?
swr é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
swr ainda é mantido?
Manutenção ativa. O último commit de swr foi em 16 de out. de 2026.
Para que posso usar swr?
Buscar e armazenar dados de API em cache em um app React ou Next.js Manter dashboards ou feeds atualizados com polling ou revalidação Criar interfaces otimistas para formulários e edições Compartilhar dados entre componentes em um app React Native
Onde consigo swr?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/vercel/swr

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados