Reactを学び始めたころ、僕はAPIの呼び出しなんて、いちばん簡単な部類の作業だと思っていました。
stateをいくつか用意します。
dataloadingerror
あとはuseEffectでデータを取ってくるだけです。
それで問題なく動いていました。
少なくとも、プロジェクトが大きくなるまでは。
以前、KPIのレポート画面を担当したことがあります。最初は、データを取るAPIが1本あるだけでした。ところが何度か手直しを重ねるうちに、画面にはこんな機能が加わっていきました。
- 検索
- 絞り込み(フィルター)
- ページ送り(ページネーション)
- データの再読み込み
- 更新したあとのデータの同期
そこから、コンポーネントがふくらみ始めたのです。
データを表示するためだけの部品だったはずが、APIにまつわる処理を何もかも抱え込むことになったのです。
しばらくして気づきました。悪いのはReactでもuseEffectでもありませんでした。
問題は、サーバーから来るデータの扱い方にあったのです。
React Query(TanStack Query)とは何か?
React Query(今の名前はTanStack Query)は、Reactのアプリで「サーバーから取ってくるデータ(サーバーステート)」を管理するためのライブラリです。Webポータルを改善するときでも、React Nativeのようなフレームワークで モバイルアプリ開発 を考えるときでも、データの状態をしっかり管理できるかどうかが、なめらかな使い心地の鍵になります。
次のような処理を、useEffectとuseStateで自前で書く代わりに、
- ローディング
- エラー
- キャッシュ
- 再取得(refetch)
- データの同期
宣言するのは、次の2つだけです。
- データをどこから取ってくるか(
queryFn) - そのデータが何なのか(
queryKey)
あとはReact Queryが引き受けてくれます。
単純な話に聞こえますが、Reactのコードがぐっとすっきりするのは、まさにこの仕組みのおかげです。
プロジェクトが大きくなると、なぜ useEffect + useState では足りなくなるのか?
APIを呼ぶだけなら、実はコードは数行で済みます。
たとえば、こうです。
const [users, setUsers] = useState([]);
useEffect(() => {
fetchUsers();
}, []);
問題は、最初のリクエストにはありません。
その後に続くもののほうです。
実際に使われる画面を作るときは、たいてい次のものが必要になります。
- ローディング中の状態
- エラーの状態
- 失敗したリクエストのやり直し(リトライ)
- データの再読み込み
- データのキャッシュ
- 更新したあとのデータの同期
どのAPIにも、似たようなものが要ります。
最初は気づきませんでした。
気づいたのは、プロジェクトが育って画面が何十にもなったころです。僕は、まったく同じ書き方のコードをあちこちで繰り返していました。
違うのは、APIの名前だけでした。
Reactのコンポーネントが、APIの処理を抱え込みすぎているサイン
僕はいつも、コードを読めばすぐに何をしているのか分かるコンポーネントが好きです。
たとえば、こんな流れです。
- データを取ってくる
- UIをレンダリングする
- 以上。
ところが実際には、多くのコンポーネントが、いつのまにかあらゆる処理の置き場になってしまいます。
UserPage
├── Fetch API
├── Loading State
├── Error State
├── Retry Logic
├── Refresh Logic
├── Cache Logic
└── UI Rendering
直したりデバッグしたりするたびに、コードを読むだけでかなり疲れます。
とくに、次のようなシステムではそうです。
- ダッシュボード
- CRM
- レポートシステム
- 管理システム
どれも、たくさんのAPIが同時に動いている場所です。こうした大きな規模の仕組みを作るには、しっかりした設計が求められます。複雑なデータの流れに取り組んでいるチームの方は、リノエッジのシステム開発 の進め方もご覧ください。
React Queryは、この問題をどう解決するのか?
正直に言うと、最初はReact Queryにあまり興味がありませんでした。
当時はこう思っていたのです。「APIを呼ぶだけなのに、ライブラリをもう1つ入れる必要が本当にあるのか?」
ところが、実際のプロジェクトで使ってみると、違いが見えてきました。
まず気に入ったのは、コンポーネントが短くなったことです。
データまわりのstateをいくつも手で管理しなくても、データをどこから取ってくるかを宣言するだけで済みます。
たとえば、こんなコードです。
const { data, isLoading, error } = useQuery({
queryKey: ["users"],
queryFn: getUsers,
});
あとは、画面を描くことに集中するだけ。
if (isLoading) return <Loading />;
if (error) return <Error />;
return <UserTable users={data} />;
読めば、このコンポーネントが何をしているのかがすぐに分かります。
React Queryの本当の良さは、キャッシュではない
React Queryと聞くと、たいていの人はまずキャッシュを思い浮かべます。
たしかに、キャッシュはとても便利です。
画面を行き来するのが速くなり、サーバーに届くリクエストも減ります。
ただ、僕にとって、それはいちばんの価値ではありません。
僕がいちばん気に入っているのは、React Queryのおかげで、UIとデータを管理する処理を切り分けられることです。
コンポーネントは、画面を描くことだけに集中できます。
React Component
│
▼
TanStack Query
│
┌─────┴─────┐
▼ ▼
Cache API
│
▼
UI Update
次のようなものは、
- Loading
- Retry
- Refetch
- Cache
……それぞれ、本来あるべき場所に収まります。
おかげで、コードがずっと読みやすいのです。

React Query vs Redux:サーバーステートにはどちらを使うべきか?
僕が以前よくやっていたのは、APIから取ってきたデータを、たくさんReduxに入れることでした。
たとえば、次のようなデータです。
- ユーザー
- 注文
- 商品
- レポート
しばらくすると、ストアが巨大になりました。
よく調べてみて分かったのは、サーバーから取ってきたデータは、まったく別の種類のstateだということです。
こうしたデータには、次のものが求められます。
- キャッシュ
- 同期
- 再取得(refetch)
- 定期的な更新
これこそ、React Queryが解決するために生まれた問題です。
だからといって、React QueryがReduxに取って代わるわけではありません。
- Reduxはクライアントステート(client state)に向いています。
- React Queryはサーバーステート(server state)に向いています。
React Queryを使い始めてから、僕がReduxに入れるAPIのデータは大きく減りました。
いつReact Queryを使い、いつuseEffectで十分なのか?
作っているのが、次のようなものだとしましょう。
- ランディングページ
- 会社や製品の紹介サイト
- シンプルなAPIがいくつかあるだけのもの
……それならuseEffectでまったく問題ありません。
では、プロジェクトに次のようなものが加わり始めたとしましょう。
- ダッシュボード
- CRM
- ERP
- レポートシステム
- 管理ポータル
……そうなると、React Queryの良さがはっきり分かるようになります。
とくに、APIの数が増えていくほどそうです。

まとめ
Reactを何年か使ってきて、いちばん難しいのはAPIを呼ぶことではないと分かりました。
いちばん難しいのは、アプリの規模が大きくなっても、データを一貫したやり方で管理し続けることです。
TanStack Queryは、特別な魔法を使っているわけではありません。
ほとんどのReactプロジェクトがいずれぶつかる問題を、ただ見事に解決してくれるのです。
僕にとって、React Queryのいちばんの価値は、キャッシュでもパフォーマンスでもありません。
コンポーネントを、UIを描くという本来の役割に戻してくれることです。
Reactのファイルを開いて、データ取得の処理よりUIの記述がコードの大半を占めているのを見ると、コードベースがきれいになってきたと実感します。
よくある質問
React Query(TanStack Query)とは何ですか?
Reactのアプリで、サーバーから取ってくるデータ(サーバーステート)を管理するためのライブラリです。今はTanStack Queryという名前です。ローディング、エラー、キャッシュ、再取得、データの同期をuseEffectとuseStateで自前で書く代わりに、データをどこから取ってくるか(queryFn)と、そのデータが何なのか(queryKey)を宣言すれば、あとはReact Queryが引き受けます。
データフェッチはuseEffectで十分なのは、どんなときですか?
ランディングページ、会社や製品の紹介サイト、シンプルなAPIがいくつかあるだけのものなら、useEffectでまったく問題ありません。ダッシュボード、CRM、ERP、レポートシステム、管理ポータルが加わり始めたら、React Queryの良さがはっきり分かるようになります。とくに、APIの数が増えていくほどそうです。
React QueryはReduxの代わりになりますか?
代わりにはなりません。Reduxはクライアントステートに、React Queryはサーバーステートに向いています。サーバーから取ってきたデータには、キャッシュ、同期、再取得、定期的な更新が必要で、これこそReact Queryが解決するために生まれた問題です。
こんなふうに開発を進めるチームをお探しですか?
リノエッジのホーチミンのエンジニアは、実際にこうして開発を進めています。ベトナムでのオフショア開発を検討中でしたら、お気軽にご相談ください。そのプロジェクトにとって本当に大事なことを、一緒に整理しましょう。
お問い合わせはこちら →
Tho NguyenTho Nguyen
Fullstack Developer · 株式会社リノエッジ
フロントエンドとバックエンドの両方で最新技術を用いてWebアプリケーションを構築しています。拡張性、パフォーマンス、そして継続的な改善に情熱を注いでいます。
オフショア開発を検討中の方へ:費用ガイド・チェックリスト(無料ダウンロード)