swr
    TypeScript icon, indicating that this package has built-in type declarations

    1.1.2 • Public • Published

    SWR


    Introduction

    SWR is a React Hooks library for data fetching.

    The name “SWR” is derived from stale-while-revalidate, a cache invalidation strategy popularized by HTTP RFC 5861. SWR first returns the data from cache (stale), then sends the request (revalidate), and finally comes with the up-to-date data again.

    With just one hook, you can significantly simplify the data fetching logic in your project. And it also covered in all aspects of speed, correctness, and stability to help you build better experiences:

    • Fast, lightweight and reusable data fetching
    • Transport and protocol agnostic
    • Built-in cache and request deduplication
    • Real-time experience
    • Revalidation on focus
    • Revalidation on network recovery
    • Polling
    • Pagination and scroll position recovery
    • SSR and SSG
    • Local mutation (Optimistic UI)
    • Built-in smart error retry
    • TypeScript
    • React Suspense
    • React Native

    ...and a lot more.

    With SWR, components will get a stream of data updates constantly and automatically. Thus, the UI will be always fast and reactive.


    View full documentation and examples on swr.vercel.app.


    Quick Start

    import useSWR from 'swr'
    
    function Profile() {
      const { data, error } = useSWR('/api/user', fetcher)
    
      if (error) return <div>failed to load</div>
      if (!data) return <div>loading...</div>
      return <div>hello {data.name}!</div>
    }

    In this example, the React Hook useSWR accepts a key and a fetcher function. The key is a unique identifier of the request, normally the URL of the API. And the fetcher accepts key as its parameter and returns the data asynchronously.

    useSWR also returns 2 values: data and error. When the request (fetcher) is not yet finished, data will be undefined. And when we get a response, it sets data and error based on the result of fetcher and rerenders the component.

    Note that fetcher can be any asynchronous function, you can use your favourite data-fetching library to handle that part.


    View full documentation and examples on swr.vercel.app.


    Authors

    This library is created by the team behind Next.js, with contributions from our community:

    Contributors

    Thanks to Ryan Chen for providing the awesome swr npm package name!


    License

    The MIT License.

    Keywords

    none

    Install

    npm i swr

    DownloadsWeekly Downloads

    541,538

    Version

    1.1.2

    License

    MIT

    Unpacked Size

    163 kB

    Total Files

    46

    Last publish

    Collaborators

    • gsoltis
    • epallerols
    • domysee
    • nwienert
    • arbw
    • stephdietz
    • gudmundur
    • marcgreenstock
    • vvo
    • falcoagustin
    • nabsul
    • bmealey
    • maedahbatool
    • brethudson
    • matt.straka
    • jasongullickson
    • f3d0r
    • gaspar09
    • jtaylor0196
    • pieparker
    • kelly
    • dferber90
    • healeycodes
    • broph123
    • codybrouwers
    • gdborton
    • jeffreyarneson
    • ebb-tide
    • msimulcik
    • domeccleston
    • nutlope
    • hungrybearstudio
    • codetaromiura
    • gkaragkiaouris
    • geovanisouza92
    • dglsparsons
    • lostinpatterns
    • vercel-release-bot
    • southpolesteve
    • matheuss
    • igorklopov
    • nkzawa
    • tootallnate
    • rauchg
    • timneutkens
    • javivelasco
    • iamevilrabbit
    • kdy1
    • joecohens
    • quietshu
    • dav-is
    • styfle
    • zeit-bot
    • lucleray
    • mglagola
    • andybitz
    • paulogdm
    • anatrajkovska
    • timer
    • arzafran
    • ijjk
    • lfades
    • msweeneydev
    • williamli
    • ragojose
    • guybedford
    • paco
    • skllcrn
    • janicklas-ralph
    • atcastle
    • spanicker
    • housseindjirdeh
    • gmonaco
    • kikobeats
    • prateekbh
    • jkrems
    • jaredpalmer
    • gielcobben
    • chibicode
    • nazarenooviedo
    • samsisle
    • okbel
    • hankvercel
    • leerobinson
    • elsigh
    • julianbenegas
    • rizbizkits
    • sokra
    • cl3arglass
    • chriswdmr
    • ernestd
    • ismaelrumzan
    • jhoch
    • mitchellwright
    • mrmckeb
    • kuvos
    • creationix
    • huozhi
    • cmvnk
    • ktcarter
    • padmaia
    • delba
    • catsaremlg
    • steventey
    • gsandhu
    • dbredvick