SWR: Hook lấy dữ liệu cho React
SWR làm tốt đúng một việc: giữ dữ liệu trong component React luôn đồng bộ với server mà không phải tự viết logic fetch, cache và retry. Hook `useSWR` thay được kiểu `useState` cộng `useEffect` quen thuộc, và revalidate khi focus lại tab hay mạng khôi phục bắt được dữ liệu cũ mà fetch lúc mount bỏ sót. SWR hẹp hơn một GraphQL client như Apollo - không query language, không normalized cache - nên coi nó là lớp cache, không phải framework đầy đủ.
SWR là gì
SWR là thư viện React Hooks dùng để lấy dữ liệu, xây dựng quanh chiến lược cache stale-while-revalidate lấy từ HTTP RFC 5861. Tên gọi này đến thẳng từ chiến lược đó: component nhận dữ liệu cũ (stale) từ cache ngay lập tức, SWR âm thầm gửi request thật ở nền, rồi cập nhật giao diện khi dữ liệu mới về. Nó chỉ gồm một hook `useSWR`, trả về `data`, `error` và `isLoading`.
Tính năng chính của SWR
- ✓Cache stale-while-revalidate: SWR trả dữ liệu trong cache ngay lập tức, revalidate request đó ở nền, rồi cập nhật giao diện khi dữ liệu mới về.
- ✓Gộp request tự động - nhiều component cùng gọi một key thì chỉ tạo một lần gọi mạng, không lặp lại.
- ✓Revalidate khi focus lại tab và khi mạng khôi phục, cộng thêm polling nếu cần.
- ✓Phân trang và khôi phục vị trí cuộn cho danh sách.
- ✓Local mutation cho optimistic UI, cùng cơ chế smart error retry tích hợp sẵn.
- ✓TypeScript, React Suspense, và bản dựng cho React Native đều nằm trong cùng một package.
- ✓Không phụ thuộc transport hay protocol cụ thể - hàm `fetcher` có thể là `fetch`, `axios`, GraphQL, hay bất cứ thứ gì bạn đang dùng.
Các trường hợp dùng SWR phổ biến
- •Dashboard hay số liệu real-time cần tự làm mới khi người dùng quay lại tab, không cần nút refresh thủ công.
- •Danh sách phân trang hoặc infinite-scroll cần giữ nguyên vị trí cuộn khi revalidate ở nền.
- •Ứng dụng Next.js dùng SSR/SSG nhưng vẫn cần làm mới phía client sau khi trang hydrate.
- •Optimistic UI - cập nhật cache local ngay khi người dùng thao tác (ví dụ bấm like) trước khi server xác nhận, qua local mutation.
- •Trang có nhiều component cùng gọi một endpoint mà bạn không muốn mỗi component tự bắn request riêng.
Cài đặt SWR trong dự án
README của SWR không có phần hướng dẫn cài đặt từng bước, nhưng có xác nhận package này publish lên npm với tên `swr`. Cài đặt như mọi package npm khác: `npm install swr` (hoặc `yarn add swr`, `pnpm add swr`). Không cần CLI riêng, không cần file config hay tài khoản - bạn import `useSWR` từ `swr` rồi gọi ngay trong component, giống bất kỳ dependency npm nào khác trong dự án React.
Ví dụ cơ bản với hook useSWR
Ví dụ Quick Start trong README thể hiện toàn bộ cách dùng chỉ trong vài dòng: ```js import useSWR from 'swr' function Profile() { const { data, error, isLoading } = useSWR('/api/user', fetcher) if (error) return failed to load if (isLoading) return loading... return hello {data.name}! } ``` `useSWR` nhận hai tham số: một `key` (thường là URL của request, dùng để nhận diện và cache) và một `fetcher` - hàm async nhận key đó và trả về dữ liệu. Hook trả về `data`, `error` và `isLoading` - khi request đang chạy thì `data` là `undefined` và `isLoading` là `true`; khi fetcher resolve xong, SWR set `data` hoặc `error`, chuyển `isLoading` về `false`, rồi re-render component. Bản thân fetcher không phải việc của SWR - dùng `fetch`, `axios`, hay bất cứ thứ gì dự án bạn đang gọi API.
Ưu điểm khi dùng SWR
- ✓Một hook (`useSWR`) thay thế kiểu code `useState` + `useEffect` + trạng thái loading mà hầu hết team viết lại trong từng component.
- ✓Cache và gộp request đã tích hợp sẵn - không cần thêm package thứ hai.
- ✓Không phụ thuộc transport: dùng chung với `fetch`, `axios`, hay GraphQL client vì SWR chỉ quan tâm đến key và hàm fetcher bạn đưa vào.
- ✓TypeScript, React Suspense, và React Native đều nằm trong cùng một package.
- ✓Được đội ngũ Next.js xây dựng, nên hành vi SSR/SSG là ưu tiên chính chứ không phải thêm vào sau.
Hạn chế và đánh đổi của SWR
- △Tài liệu ở đây không có hướng dẫn cài đặt/cấu hình từng bước - phần đó nằm ở trang docs riêng, không có trong README này.
- △SWR chỉ lo fetch và cache; nó không có query language hay store chuẩn hoá như một GraphQL client chuyên dụng, nên bạn vẫn phải tự viết `fetcher` và các lệnh POST/PATCH.
- △Không thấy devtools hay panel kiểm tra cache nào được nhắc tới trong tài liệu này, nên muốn xem thứ gì đang nằm trong cache thường phải tự log ra.
- △Ví dụ Quick Start là cách dùng duy nhất được đưa ra ở đây - những thứ như conditional fetching hay dependent queries không được đề cập.
Các lựa chọn thay thế SWR
Câu hỏi thường gặp
SWR miễn phí và mã nguồn mở, phát hành theo giấy phép MIT, nên dùng được trong dự án React thương mại lẫn cá nhân mà không tốn phí bản quyền.
SWR dùng được với React Native - README liệt kê hỗ trợ React Native là một trong các khả năng tích hợp sẵn, bên cạnh React Hooks tiêu chuẩn.
Có thể dùng SWR với TypeScript - dự án liệt kê hỗ trợ TypeScript ngay trong danh sách tính năng cốt lõi, nên giá trị trả về của hook như `data` và `error` đã có type sẵn, không cần cài thêm package.
SWR hỗ trợ server-side rendering và static generation (SSR và SSG), được README liệt kê rõ ràng - hợp lý vì thư viện này đến từ đội ngũ cũng xây dựng Next.js.
Khác biệt chính nằm ở phạm vi: SWR là một hook nhẹ, tập trung vào đúng cơ chế cache stale-while-revalidate, còn React Query (TanStack Query) là thư viện lớn hơn với nhiều tính năng quản lý server state hơn. Cả hai đều giải quyết việc lấy dữ liệu cho React, nhưng tài liệu của chính SWR cũng mô tả nó theo hướng nhẹ và gọn chứ không phải một bộ công cụ đầy đủ.
SWR cache dữ liệu theo key - thường là URL của request - và trả ngay giá trị đã cache đó ở lần gọi lặp lại trước khi âm thầm gửi request mới ở nền, rồi cập nhật cache và component khi dữ liệu mới về, đúng theo chiến lược stale-while-revalidate mà tên gọi của nó bám theo.
Vấn đề mà SWR giải quyết
Ứng dụng React nào cũng phải lấy dữ liệu bằng cách này hay cách khác. Phần lớn component kết thúc bằng việc viết lại đúng kiểu `useState` + `useEffect` + trạng thái loading/error, và những phiên bản viết tay như vậy thường không gộp các request trùng lặp, không tự lấy lại dữ liệu khi người dùng quay lại tab, và mất luôn vị trí cuộn ở danh sách phân trang mỗi khi dữ liệu tải lại. SWR gói chiến lược cache stale-while-revalidate - định nghĩa trong HTTP RFC 5861 - vào một hook duy nhất để component không phải làm lại việc đó.
Ai nên thử SWR — và ai nên bỏ qua
Nên thử SWR nếu bạn đang xây ứng dụng React (hay Next.js) cần dữ liệu luôn mới mà không muốn tự viết lại `useEffect` cộng trạng thái loading/error cho từng lần fetch - càng hợp lý hơn nếu bạn đã dùng Next.js, vì cùng một đội ngũ xây cả hai. Bỏ qua nếu API của bạn nặng về GraphQL và muốn một client hiểu sẵn query, mutation, normalized cache, vì đó là việc của Apollo Client chứ không phải SWR, hoặc nếu framework bạn dùng đã có sẵn cơ chế loader và bạn không cần thêm hành vi revalidate.
Repo liên quan
Vẫn đang phân vân về swr?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về swr.
