ReactのSWRで、データの取得とキャッシュを扱う方法
SWR の useSWR に URL などのキーと取得用の関数を渡すと、取得したデータがキーごとにキャッシュされます。同じキーを使うコンポーネントが同時に表示されても取得は1回にまとまり、画面を開き直したときはキャッシュをすぐに表示してから、裏で最新のデータを取り直します。管理画面やダッシュボードのように、API から取得したデータを複数のコンポーネントで使い回したり、一覧と件数を同時に更新したりしたいときに向いています。
以下では、やることリストの小さな API を相手に、取得・キャッシュ・更新の書き方を、実際に出たリクエストの回数とともに示します。
検証環境は Ubuntu 24.04、Node.js 22.23.4 です。swr 2.5.1、react / react-dom 19.3.1、typescript 7.0.2、vite 8.3.7 を使い、tsc で型チェックしてから Vite の開発サーバーで動かしました。API は Vite のプラグインで作った検証用のもので、どのリクエストも 600ms 待ってから返します。ブラウザは Playwright 1.63.0 で動かした Chromium 153(ヘッドレス)だけです。タブの切り替えは、window に focus イベントを送ることで代用しました。Next.js などでのサーバーサイドレンダリング、Suspense モード、useSWRInfinite や useSWRMutation、通信が失敗したときに楽観的な表示が元に戻る動きは試していません。
SWR を入れて、取得用の関数を用意する
SWR は npm から入れます。検証で使った swr 2.5.1 の peerDependencies は react が ^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 で、React 19 でもそのまま使えます。
npm install swr
useSWR 自体は、データの取り方を決めていません。キーを受け取ってデータを返す関数(SWR では fetcher と呼びます)を自分で渡します。公式ドキュメントの「はじめに」では、fetch を包んで JSON を返す関数を作る書き方が示されています。
ここでは、公式のエラー処理の説明にならって、ステータスコードが 2xx でなければエラーを投げるようにしました。投げたエラーは、useSWR の error に入ります。
// fetcher.ts
export class FetchError extends Error {
constructor(public status: number, message: string) {
super(message);
}
}
export async function fetcher<T>(url: string): Promise<T> {
const res = await fetch(url);
if (!res.ok) {
const body = (await res.json()) as { message?: string };
throw new FetchError(res.status, body.message ?? res.statusText);
}
return res.json() as Promise<T>;
}
useSWR で一覧を取得する
一覧を表示するコンポーネントです。データ取得の説明にあるとおり、fetcher は第1引数のキー(ここでは '/api/todos')を受け取ります。型引数 <Todo[]> で、data の型を決めています。
// TodoList.tsx
import useSWR from 'swr';
import { fetcher } from './fetcher';
import type { Todo } from './types';
export function TodoList() {
const { data, error, isLoading, isValidating } = useSWR<Todo[]>('/api/todos', fetcher);
if (error) return <p>読み込みに失敗しました:{error.message}</p>;
if (isLoading) return <p>読み込み中…</p>;
return (
<>
<ul>
{data?.map((todo) => <li key={todo.id}>{todo.title}</li>)}
</ul>
{isValidating && <p className="stale">最新の内容を確認中…</p>}
</>
);
}
types.ts には type Todo = { id: number; title: string } を置いています。
検証環境で開くと、表示した直後は「読み込み中…」で、約1秒後に一覧に変わりました。失敗したときの表示は、500 を返す URL を読む別のコンポーネントで確かめました。エラーの型を2つ目の型引数で渡すと、error.status も使えます。
const { data, error, isLoading } = useSWR<unknown, FetchError>('/api/broken', fetcher, {
shouldRetryOnError: false, // 確認のため、失敗したときの自動の再試行を止める
});
if (error) return <p>読み込みに失敗しました({error.status}):{error.message}</p>;
画面には「読み込みに失敗しました(500):サーバーでエラーが起きました」と表示されました。
isValidating の使いどころは、あとの「開き直すと、キャッシュを先に表示してから取り直す」の節で説明します。
同じキーを使うと、取得は1回にまとまる
ヘッダーに件数を出すコンポーネントを足し、一覧と同じキーで useSWR を呼びます。
// TodoCount.tsx
import useSWR from 'swr';
import { fetcher } from './fetcher';
import type { Todo } from './types';
export function TodoCount() {
const { data } = useSWR<Todo[]>('/api/todos', fetcher);
return <p>やること:{data ? `${data.length}件` : '…'}</p>;
}
<TodoCount /> と <TodoList /> を同じ画面に並べたところ、/api/todos へのリクエストは1回だけでした。2つのコンポーネントは、同じキャッシュから同じデータを受け取ります。公式のパフォーマンスの説明でも、同じキーを持つコンポーネントがほぼ同時にレンダリングされると、リクエストは一度だけになるとされています。件数を一覧の親から props で配る必要はありません。StrictMode の中で動かしていますが、それでも1回でした。

画面の下の「API へのリクエスト」は、検証のために fetch の回数を数えて出したもので、記事のコードには含めていません。
開き直すと、キャッシュを先に表示してから取り直す
一覧をボタンで閉じたり開いたりできるようにして、一度読み込んだあとに閉じ、3秒後に開き直しました。すると、開いた直後から前回の一覧が表示され、同時に /api/todos へ2回目のリクエストが出ました。一覧が表示されたまま「最新の内容を確認中…」が出ているので、isLoading は false のままで、isValidating が true になっていることが分かります。

SWR という名前は、HTTP の stale-while-revalidate から来ています(npm の SWR の README)。README には、まずキャッシュのデータ(stale)を返し、それからリクエストを送って(revalidate)、最新のデータに置き換えると書かれています。上の画面は、ちょうどその途中の状態です。
公式の「SWR を理解する」のページでは、isValidating はデータがあるかどうかに関わらずリクエスト中なら true、isLoading はリクエスト中で、まだ表示するデータがないときに true だと説明されています。最初の読み込みのあいだは isLoading を見て「読み込み中…」だけを出し、取り直しのあいだは isValidating を見て、一覧の下に灰色の文字で「最新の内容を確認中…」を出す、と使い分けると、取り直しのあいだも一覧を表示したままにできます。
一方、閉じてから0.3秒後に開き直したとき(前のリクエストから約1.4秒後)は、新しいリクエストは出ませんでした。API のページにあるとおり、dedupingInterval(既定は 2000ms)のあいだは、同じキーのリクエストを重複として出さないからです。
タブに戻ったときの取り直しを止める
SWR は、ウィンドウにフォーカスが戻ったときにもデータを取り直します(自動再検証のページ)。swr 2.5.1 のソースでは、window の focus イベントと document の visibilitychange イベントを待ち受けていました。
検証環境で、読み込みから約5秒後に window へ focus イベントを送ると、/api/todos へのリクエストがもう1回出て、そのあいだ「最新の内容を確認中…」が表示されました。
取り直しが要らない画面では、revalidateOnFocus を false にします。SWRConfig で囲むと、中のすべての useSWR に同じ設定が効きます(グローバルな設定のページ)。
import { SWRConfig } from 'swr';
<SWRConfig value={{ revalidateOnFocus: false }}>
<TodoList />
</SWRConfig>
この設定で同じように focus イベントを送ると、リクエストは出ませんでした。
データを追加したあとで、一覧を取り直す
API にデータを追加したあとは、キャッシュの一覧が古くなります。useSWR が返す mutate を引数なしで呼ぶと、そのキーのデータを取り直します(ミューテーションと再検証のページ)。
// AddTodo.tsx
import { useState } from 'react';
import useSWR from 'swr';
import { fetcher } from './fetcher';
import type { Todo } from './types';
import { postTodo } from './postTodo';
export function AddTodo() {
const { data, mutate } = useSWR<Todo[]>('/api/todos', fetcher);
const [title, setTitle] = useState('');
const add = async () => {
await postTodo(title);
setTitle('');
await mutate(); // 一覧を取り直す
};
return (
<div>
<input value={title} onChange={(e) => setTitle(e.target.value)} aria-label="やること" />
<button onClick={add} disabled={!title || !data}>追加</button>
</div>
);
}
postTodo は、/api/todos に POST で { title } を送り、追加された Todo を返す関数です。
「ゴミを出す」を追加すると、POST の完了後に GET /api/todos が出て、その返事が届いたところで、一覧が3件になりました。同じキーを使っている件数の表示も、同時に「3件」に変わりました。取り直しのあいだは、前の2件のまま「最新の内容を確認中…」が出ています。
mutate は、useSWRConfig から取り出すと、別のコンポーネントからでも、キーを指定して呼べます。ただし公式の説明では、キーだけを渡して呼んだ場合、そのキーの useSWR がマウントされていなければ、キャッシュの更新も取り直しも起きないとされています。
送信の完了を待たずに、追加した項目を表示する
前の節の書き方では、追加した項目が表示されるまでに、POST と GET の2回分待ちます。mutate の optimisticData に表示したいデータを渡すと、送信の完了を待たずに、キャッシュを先に書き換えられます。
// AddTodoOptimistic.tsx(追加の処理だけ)
const add = async () => {
const current = data ?? [];
setTitle('');
await mutate(
async () => [...current, await postTodo(title)],
{
optimisticData: [...current, { id: -1, title: `${title}(送信中)` }],
rollbackOnError: true,
revalidate: false,
},
);
};
mutate の第1引数の関数が返した配列が、送信後のキャッシュになります。revalidate: false にしているので、そのあとの GET は出しません。mutate の options の説明によると、rollbackOnError は、送信がエラーになったときにキャッシュを元に戻す設定で、既定でも true です。
ボタンを押した直後には、一覧の最後に「ゴミを出す(送信中)」が出て、件数も3件になりました。約0.7秒後、POST の返事が届くと「ゴミを出す」に置き換わりました。このあいだに出たリクエストは POST の1回だけで、一覧の GET は出ていません。

条件がそろうまで、取得しない
選んだユーザーの情報を取得するときのように、キーに必要な値がまだないことがあります。キーに null を渡すと、SWR はリクエストを出しません(条件付きフェッチのページ)。
// UserName.tsx
import useSWR from 'swr';
import { fetcher } from './fetcher';
import type { User } from './types';
export function UserName({ userId }: { userId: number | null }) {
const { data, isLoading } = useSWR<User>(
userId === null ? null : `/api/users/${userId}`,
fetcher,
);
if (userId === null) return <p>ユーザーを選んでください</p>;
if (isLoading) return <p>読み込み中…</p>;
return <p>名前:{data?.name}</p>;
}
検証環境では、ユーザーを選ぶまでリクエストは0回でした。「ユーザー1」を押すと /api/users/1、「ユーザー2」を押すと /api/users/2 が取得されました。続けてもう一度「ユーザー1」を押すと、「読み込み中…」を挟まずに、すぐ「名前:ユーザー1」が表示されました。このときは前回の取得から2秒たっていなかったので、新しいリクエストも出ませんでした。
SWR のキャッシュは、キーごとに分かれています。同じデータを使う場所では同じキーを書き、別のデータには別のキーを付けるのが、使い回しと更新の両方の土台になります。





