Gathering detailed insights and metrics for swr
Gathering detailed insights and metrics for swr
Installations
npm install swrDeveloper Guide
BETA
Typescript
Yes
Module System
CommonJS, ESM
Node Version
20.19.2
NPM Version
10.8.2
Score
97.2
Supply Chain
100
Quality
91.8
Maintenance
100
Vulnerability
100
License
Releases
120
Languages
3
TypeScript
JavaScript
Shell
TypeScript (99.23%)
JavaScript (0.75%)
Shell (0.02%)
Developer
Download Statistics
Total Downloads
306,944,096
Last Day
211,903
Last Week
3,725,940
Last Month
15,654,624
Last Year
138,524,631
GitHub Statistics
MIT License
31,633 Stars
912 Commits
1,273 Forks
218 Watchers
18 Branches
259 Contributors
Updated on Jul 03, 2025
Bundle Size
13.56 kB
Minified
5.23 kB
Minified + Gzipped
Maintainers
8
Package Meta Information
Latest Version
2.3.4
Package Id
swr@2.3.4
Unpacked Size
260.14 kB
Size
54.25 kB
File Count
53
NPM Version
10.8.2
Node Version
20.19.2
Published on
Jul 02, 2025
Total Downloads
Cumulative downloads
Total Downloads
306,944,096
Last Day
-6.6%
211,903
Compared to previous day
Last Week
-7.5%
3,725,940
Compared to previous week
Last Month
7.8%
15,654,624
Compared to previous month
Last Year
71.7%
138,524,631
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
2
Peer Dependencies
1
Dev Dependencies
34
@edge-runtime/jest-environment@arethetypeswrong/cli@playwright/test@swc/core@swc/jest@testing-library/jest-dom@testing-library/react@type-challenges/utils@types/jest@types/node@types/react@types/use-sync-external-store@typescript-eslint/eslint-plugin@typescript-eslint/parserbuncheeeslinteslint-config-prettiereslint-plugin-jest-domeslint-plugin-reacteslint-plugin-react-hookseslint-plugin-testing-libraryhuskyjestjest-environment-jsdomlint-stagednextprettierreactreact-domreact-error-boundaryrimrafsemverswrtypescript
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
1import useSWR from 'swr' 2 3function Profile() { 4 const { data, error, isLoading } = useSWR('/api/user', fetcher) 5 6 if (error) return <div>failed to load</div> 7 if (isLoading) return <div>loading...</div> 8 return <div>hello {data.name}!</div> 9}
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 3 values: data, isLoading and error. When the request (fetcher) is not yet finished,
data will be undefined and isLoading will be true. When we get a response, it sets data and error based on the result
of fetcher, isLoading to false 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:
- Shu Ding (@shuding_) - Vercel
- Jiachi Liu (@huozhi) - Vercel
- Guillermo Rauch (@rauchg) - Vercel
- Joe Haddad (@timer150) - Vercel
- Paco Coursey (@pacocoursey) - Vercel
Thanks to Ryan Chen for providing the awesome swr npm package name!
License
The MIT License.
No vulnerabilities found.
Reason
security policy file detected
Details
- Info: security policy file detected: .github/SECURITY.md:1
- Info: Found linked content: .github/SECURITY.md:1
- Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/SECURITY.md:1
- Info: Found text in security policy: .github/SECURITY.md:1
Reason
no dangerous workflow patterns detected
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
Found 20/30 approved changesets -- score normalized to 6
Reason
3 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 3
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/test-canary.yml:1
- Warn: no topLevel permission defined: .github/workflows/test-legacy-react.yml:1
- Warn: no topLevel permission defined: .github/workflows/test-release.yml:1
- Warn: no topLevel permission defined: .github/workflows/trigger-release.yml:1
- Info: no jobLevel write permissions found
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-canary.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/test-canary.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-legacy-react.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/test-legacy-react.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-release.yml:62: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/test-release.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-release.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/test-release.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-release.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/test-release.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-release.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/test-release.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/trigger-release.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/vercel/swr/trigger-release.yml/main?enable=pin
- Info: 0 out of 7 GitHub-owned GitHubAction dependencies pinned
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 24 are checked with a SAST tool
Reason
10 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-hpx4-r86g-5jrg
- Warn: Project is vulnerable to: GHSA-prr3-c3m5-p7q2
- Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
- Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
- Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
- Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
- Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
- Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Score
4.4
/10
Last Scanned on 2025-06-23
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More