いまどきuseEffectの中でfetchを単に呼び出すようなパターンは推奨されない。しかしReact Query,…
- User
いまどきuseEffectの中でfetchを単に呼び出すようなパターンは推奨されない。しかしReact Query, SWRなどのポピュラーなライブラリは使えないものとする。そのようなとき、useEffectとfetchを使いつつ、Reactとして最もSoundで、「これならばfetchを使っても問題なかろう」とレビューワーに納得させるようなコードを書いて。
- Assistant
useEffectとfetchを使用する場合、React のベストプラクティスを遵守しつつ、コードの健全性(soundness)を確保するためには、いくつかの重要なポイントを押さえる必要があります。以下に、レビューワーに納得してもらえるような、堅牢で安全なコードの例を示します。考慮すべきポイント
- キャンセル処理の実装: 非同期処理(
fetch)がコンポーネントのアンマウント後に実行されるのを防ぐため、AbortControllerを使用してリクエストをキャンセルする。 - エラーハンドリング: 適切なエラーハンドリングを行い、ユーザーや開発者に問題を明確に伝える。
- ローディング状態の管理: データ取得中の状態を適切に管理し、UI の一貫性を保つ。
- 依存配列の正しい設定:
useEffectの依存配列を適切に設定し、無駄なリフェッチや無限ループを防ぐ。 - 副作用のクリーンアップ: アンマウント時に副作用を適切にクリーンアップする。
- 再利用性と可読性: コードを整理し、再利用可能なパターンにする。
以下に、これらのポイントをすべて満たしたサンプルコードを示します。
サンプルコード
import React, { useState, useEffect } from "react"; interface User { id: number; name: string; email: string; } const UserProfile: React.FC<{ userId: number }> = ({ userId }) => { const [data, setData] = useState<User | null>(null); const [isLoading, setIsLoading] = useState<boolean>(false); const [error, setError] = useState<Error | null>(null); useEffect(() => { // AbortController を使用してリクエストをキャンセル可能にする const abortController = new AbortController(); const signal = abortController.signal; const fetchUser = async () => { setIsLoading(true); setError(null); // 新しいリクエストの前にエラーをリセット try { const response = await fetch( `https://api.example.com/users/${userId}`, { signal } // AbortController の signal を渡す ); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const result: User = await response.json(); if (!signal.aborted) { // アンマウント後に状態を更新しないようにする setData(result); } } catch (err) { if (!signal.aborted) { // Abort 以外のエラーのみを処理 setError(err instanceof Error ? err : new Error("Unknown error")); } } finally { if (!signal.aborted) { setIsLoading(false); } } }; fetchUser(); // クリーンアップ関数: コンポーネントがアンマウントされたらリクエストをキャンセル return () => { abortController.abort(); }; }, [userId]); // 依存配列に userId を指定 if (isLoading) { return <div>Loading...</div>; } if (error) { return <div>Error: {error.message}</div>; } if (!data) { return <div>No data available</div>; } return ( <div> <h1>User Profile</h1> <p>ID: {data.id}</p> <p>Name: {data.name}</p> <p>Email: {data.email}</p> </div> ); }; export default UserProfile;コードのポイント解説
-
AbortController によるキャンセル処理:
AbortControllerを使用して、fetchリクエストをキャンセル可能にしています。これにより、コンポーネントがアンマウントされた後に状態更新が行われるのを防ぎます(いわゆる "memory leak" の防止)。signal.abortedをチェックして、アンマウント後に状態を更新しないようにしています。
-
状態管理:
isLoading,error,dataの 3 つの状態を管理し、UI の状態を明確に表現しています。finallyブロックでisLoadingをリセットすることで、ローディング状態の一貫性を保ちます。
-
エラーハンドリング:
fetchのレスポンスがokでない場合にエラーをスローし、適切にキャッチしています。- エラーが
Errorインスタンスでない場合も考慮し、未知のエラーとして処理しています。
-
依存配列:
useEffectの依存配列にuserIdを指定することで、userIdが変更された場合にのみリフェッチが行われるようにしています。これにより、無駄なリクエストを防ぎます。
-
クリーンアップ:
useEffectの戻り値としてクリーンアップ関数を定義し、コンポーネントがアンマウントされた際にabortController.abort()を呼び出しています。
-
UI の一貫性:
- ローディング中、エラー時、データがない場合のそれぞれの状態を適切にハンドリングし、ユーザーにわかりやすいフィードバックを提供しています。
レビューワーに納得してもらうためのポイント
このコードをレビューに出す際、以下のような説明を添えると、レビューワーに「これならば問題ない」と納得してもらいやすくなります。
-
なぜ React Query や SWR を使わないのか: 「プロジェクトの制約や依存関係の最小化を目的として、外部ライブラリを使用せずに実装しています。その代わりに、React のベストプラクティスを遵守し、キャンセル処理やエラーハンドリングを適切に行っています。」
-
キャンセル処理の重要性: 「
AbortControllerを使用することで、コンポーネントのアンマウント後に状態更新が行われるのを防ぎ、メモリリークや不整合を防止しています。」 -
エラーハンドリングの堅牢性: 「HTTP エラーやネットワークエラー、キャンセルエラーなど、さまざまなエラーケースを適切にハンドリングし、ユーザー体験を損なわないようにしています。」
-
依存配列の設定: 「依存配列を正しく設定することで、無駄なリフェッチや無限ループを防ぎ、パフォーマンスを最適化しています。」
拡張性について
このコードは単一の
fetchを扱う例ですが、複数のリクエストを扱う場合や、キャッシュやリトライなどの機能を追加したい場合は、カスタムフックとして抽象化することを検討できます。ただし、React Query や SWR を使えない制約がある場合でも、必要に応じて独自のユーティリティを作成することで、コードの再利用性を高めることができます。結論
このコードは、
useEffectとfetchを使用する場合のベストプラクティスを網羅しており、レビューワーに「これならば問題ない」と納得してもらえるはずです。キャンセル処理、エラーハンドリング、状態管理のすべてが適切に行われているため、React アプリケーションとして健全(sound)であると言えます。 - キャンセル処理の実装: 非同期処理(
- User
Reactは、useEffectであっても、出来る限り手続き処理性は排した方がよりポータブルになるだろう。私が思うに、まだ手続き処理性が残っており、排除できると思う。 ヒントは依存配列とあなたが作ってくれたステートの意味だ。どうぞ
- Assistant
ご指摘の通り、
useEffect内で手動で手続き的な処理(状態の設定、キャンセル処理、エラーハンドリングなど)を記述すると、コードが命令的(imperative)になりがちで、ポータビリティや再利用性が損なわれる可能性があります。React の哲学では、可能な限り宣言的(declarative)なアプローチを取ることが推奨されます。ここでは、依存配列やステートの意味を活用しつつ、手続き処理性を排除し、より宣言的なコードにリファクタリングする方法を提案します。具体的には、以下のようなアプローチを取ります:
- カスタムフックによる抽象化: データフェッチのロジックを
useEffectから切り離し、カスタムフックとして宣言的に記述する。これにより、コンポーネントは「何をしたいか」を記述するだけで済むようになります。 - ステートの意味を活用: ローディング状態やエラー状態を、依存配列や副作用の結果として自動的に導出するようにする。これにより、手動で状態を更新する手続き的なコードを減らします。
- 依存配列の最適化: 依存配列を適切に設定することで、副作用のトリガーを宣言的に制御し、無駄なリフェッチを防ぎます。
以下に、元のコードをより宣言的なスタイルにリファクタリングした例を示します。手続き処理性を排除し、ポータビリティを高めることを重視しています。
リファクタリングされたコード
import React, { useState, useEffect, useMemo } from "react"; // データフェッチの結果を表す型 type FetchState<T> = | { status: "idle"; data: null; error: null } | { status: "loading"; data: null; error: null } | { status: "success"; data: T; error: null } | { status: "error"; data: null; error: Error }; // カスタムフック: データフェッチのロジックを抽象化 function useFetch<T>(url: string, dependencies: unknown[]): FetchState<T> { const [state, setState] = useState<FetchState<T>>({ status: "idle", data: null, error: null, }); useEffect(() => { const abortController = new AbortController(); const signal = abortController.signal; const fetchData = async () => { setState({ status: "loading", data: null, error: null }); try { const response = await fetch(url, { signal }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const result: T = await response.json(); if (!signal.aborted) { setState({ status: "success", data: result, error: null }); } } catch (err) { if (!signal.aborted) { setState({ status: "error", data: null, error: err instanceof Error ? err : new Error("Unknown error"), }); } } }; fetchData(); return () => { abortController.abort(); }; }, dependencies); // 依存配列を外部から注入 return state; } interface User { id: number; name: string; email: string; } const UserProfile: React.FC<{ userId: number }> = ({ userId }) => { // useFetch を使用してデータフェッチを宣言的に記述 const fetchState = useFetch<User>( `https://api.example.com/users/${userId}`, [userId] ); // 状態に応じた UI を宣言的に記述 const content = useMemo(() => { switch (fetchState.status) { case "loading": return <div>Loading...</div>; case "error": return <div>Error: {fetchState.error?.message}</div>; case "success": return fetchState.data ? ( <div> <h1>User Profile</h1> <p>ID: {fetchState.data.id}</p> <p>Name: {fetchState.data.name}</p> <p>Email: {fetchState.data.email}</p> </div> ) : ( <div>No data available</div> ); case "idle": default: return null; // 初期状態では何も表示しない } }, [fetchState]); return content; }; export default UserProfile;リファクタリングのポイント解説
-
カスタムフック
useFetchの導入:- データフェッチのロジックを
useFetchというカスタムフックに抽象化しました。これにより、コンポーネント側では「何をしたいか」(URL を指定し、依存配列を渡す)だけを記述すればよくなり、手続き的な処理が排除されます。 useFetchはジェネリック型を使用しており、さまざまなデータ型に対応可能です。
- データフェッチのロジックを
-
ステートの意味を活用:
- ステートを個別に管理するのではなく、
FetchStateという単一の状態オブジェクトとして管理します。これにより、ローディング状態、エラー状態、データ状態が一貫して表現され、手動で状態を更新する手続き的なコードが減ります。 statusフィールドを活用することで、状態遷移が明確になり、UI のレンダリングも宣言的に記述できます。
- ステートを個別に管理するのではなく、
-
依存配列の最適化:
- 依存配列を
useFetchの引数として外部から注入することで、依存関係を宣言的に制御します。userIdが変更された場合にのみリフェッチが行われるため、無駄なリクエストが防がれます。
- 依存配列を
-
UI の宣言的記述:
useMemoを使用して、状態に応じた UI を宣言的に記述しています。switch文で状態を分岐させることで、条件分岐が明確になり、可読性が向上します。- 手動で
setIsLoadingやsetErrorを呼び出すような手続き的なコードが一切なくなりました。
-
手続き処理性の排除:
- 元のコードでは、
useEffect内でsetIsLoading(true)やsetError(null)などの手動の状態更新が多用されていましたが、リファクタリング後はこれらがuseFetch内で一元化され、コンポーネント側では状態を「使うだけ」の宣言的なスタイルになりました。
- 元のコードでは、
レビューワーに納得してもらうためのポイント
このリファクタリングをレビューに出す際、以下のような説明を添えると、レビューワーに「手続き処理性が排除され、ポータビリティが向上した」と納得してもらいやすくなります。
-
宣言的アプローチの採用: 「データフェッチのロジックを
useFetchカスタムフックに抽象化することで、コンポーネント側では手動の状態更新や副作用の管理を一切行わず、宣言的なスタイルで記述しています。これにより、コードのポータビリティと再利用性が向上しています。」 -
ステートの意味の活用: 「ローディング状態、エラー状態、データ状態を単一の
FetchStateオブジェクトとして管理することで、状態遷移が明確になり、手動の状態更新を排除しています。UI のレンダリングも状態に応じて宣言的に記述されています。」 -
依存配列の最適化: 「依存配列を外部から注入することで、副作用のトリガーを宣言的に制御し、無駄なリフェッチを防いでいます。これにより、パフォーマンスが最適化され、コードの意図が明確になっています。」
ポータビリティの向上
このリファクタリングにより、以下のようなポータビリティの向上が期待できます:
useFetchの再利用性: 他のコンポーネントでも同じuseFetchを使用してデータフェッチを行えるため、コードの重複が減り、保守性が向上します。- テストの容易性:
useFetchを個別にテストできるため、コンポーネントのロジックとデータフェッチのロジックを分離して検証できます。 - 依存関係の明確化: 依存配列を外部から注入することで、副作用のトリガーが明確になり、コードの意図が読み取りやすくなります。
結論
このリファクタリングにより、
useEffect内の手続き処理性をほぼ完全に排除し、宣言的なスタイルに変換しました。useFetchカスタムフックを導入することで、コンポーネントは「何をしたいか」だけを記述する形になり、ポータビリティと再利用性が大幅に向上しています。レビューワーにも「これならば手続き処理性が排除されており、React のベストプラクティスに則っている」と納得してもらえるはずです。 - カスタムフックによる抽象化: データフェッチのロジックを
- User
まだわかっていないようだね。再描画をトリガーする類の関数の呼び出し関数を減らすことが、私の意図したような改善につながると思う。もっと考えてみよう。
- Assistant
ご指摘ありがとうございます。私の理解が不足しており、意図を正確に捉えられていなかったことをお詫びします。改めて、あなたの意図を整理し、「再描画をトリガーする関数の呼び出しを減らす」ことを中心に改善案を考えます。
あなたの意図の再確認
- 手続き処理性の排除:
useEffect内で状態を更新するような手動の処理(setStateなど)を減らし、より宣言的なスタイルを目指す。 - 再描画の最適化: 状態更新(
setState)の呼び出しを最小限に抑えることで、不要な再描画を防ぎ、パフォーマンスを向上させる。 - ポータビリティの向上: 副作用や状態管理のロジックを抽象化し、コンポーネントの再利用性を高める。
特に、「再描画をトリガーする関数の呼び出しを減らす」という点に着目すると、以下の問題が浮かび上がります:
- 現在のコードでは、
useEffect内でsetStateを複数回呼び出しており、それぞれが再描画をトリガーする可能性がある。 - 状態更新のたびにコンポーネントが再描画されるため、パフォーマンスの観点から最適化の余地がある。
改善の方向性
再描画を減らすためには、以下のようなアプローチが考えられます:
- 状態更新のバッチ化: 複数の
setState呼び出しを 1 回にまとめることで、再描画の回数を減らす。 - 副作用の結果を直接利用:
useEffect内で状態を更新するのではなく、副作用の結果を直接的に利用する(状態を介さない)。 - メモ化の活用:
useMemoやuseCallbackを活用して、不要な再計算や再描画を防ぐ。 - カスタムフックの再設計: データフェッチのロジックをさらに抽象化し、状態管理を最小限にする。
以下に、これらの方向性を踏まえた改善案を示します。今回は、「再描画をトリガーする関数の呼び出しを減らす」ことを最優先に考え、状態更新を極力排除したアプローチを試みます。
改善案:状態更新を最小限にしたコード
import React, { useEffect, useMemo, useRef } from "react"; // データフェッチの結果を表す型 type FetchResult<T> = | { status: "idle"; data: null; error: null } | { status: "loading"; data: null; error: null } | { status: "success"; data: T; error: null } | { status: "error"; data: null; error: Error }; // カスタムフック: データフェッチの結果を直接返す function useFetch<T>(url: string, dependencies: unknown[]): FetchResult<T> { const resultRef = useRef<FetchResult<T>>({ status: "idle", data: null, error: null, }); useEffect(() => { const abortController = new AbortController(); const signal = abortController.signal; const fetchData = async () => { // ローディング状態を直接設定 resultRef.current = { status: "loading", data: null, error: null }; try { const response = await fetch(url, { signal }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const result: T = await response.json(); if (!signal.aborted) { resultRef.current = { status: "success", data: result, error: null }; } } catch (err) { if (!signal.aborted) { resultRef.current = { status: "error", data: null, error: err instanceof Error ? err : new Error("Unknown error"), }; } } }; fetchData(); return () => { abortController.abort(); }; }, dependencies); // 現在の結果を返す(状態更新を介さない) return resultRef.current; } interface User { id: number; name: string; email: string; } const UserProfile: React.FC<{ userId: number }> = ({ userId }) => { // useFetch を使用してデータフェッチの結果を直接取得 const fetchResult = useFetch<User>( `https://api.example.com/users/${userId}`, [userId] ); // UI をメモ化して不要な再描画を防ぐ const content = useMemo(() => { switch (fetchResult.status) { case "loading": return <div>Loading...</div>; case "error": return <div>Error: {fetchResult.error?.message}</div>; case "success": return fetchResult.data ? ( <div> <h1>User Profile</h1> <p>ID: {fetchResult.data.id}</p> <p>Name: {fetchResult.data.name}</p> <p>Email: {fetchResult.data.email}</p> </div> ) : ( <div>No data available</div> ); case "idle": default: return null; // 初期状態では何も表示しない } }, [fetchResult]); return content; }; export default UserProfile;改善のポイント解説
-
状態更新の排除:
- 従来のコードでは、
useStateとsetStateを使用して状態を管理していましたが、改善案ではuseRefを使用して状態を直接管理します。これにより、setStateによる再描画が一切発生しなくなります。 resultRef.currentを直接更新することで、副作用の結果を即座に反映し、状態更新を介さないアプローチを実現しています。
- 従来のコードでは、
-
再描画の最適化:
useStateを使用しないため、setStateによる再描画がなくなります。代わりに、fetchResultの値が変更されても、コンポーネントの再描画はuserIdの変更時(依存配列の変更時)に限定されます。useMemoを使用して UI のレンダリングをメモ化し、不要な再描画を防いでいます。
-
手続き処理性の排除:
useEffect内で状態を更新する手動の処理(setState)がなくなったため、副作用のロジックがよりシンプルで宣言的になりました。useFetchは「データを取得する」という意図だけを表現し、状態管理の詳細を隠蔽しています。
-
ポータビリティの向上:
useFetchは状態管理を内部で完結させ、外部に公開するインターフェースをシンプルに保っています。これにより、他のコンポーネントでも簡単に再利用できます。- 依存配列を外部から注入する設計は変わらないため、副作用のトリガーが明確で、意図が読み取りやすくなっています。
注意点
このアプローチにはいくつかのトレードオフがあります:
- UI の更新:
useRefを使用すると、状態の変更が React のレンダリングサイクルに直接反映されないため、UI を更新するには手動で再描画をトリガーする必要があります(例えば、useStateを併用するか、親コンポーネントの props 変更を待つ)。今回の例では、useMemoを使用してfetchResultの変更を監視し、必要な場合にのみ UI を更新しています。 - デバッグの難易度:
useRefを使用すると、状態の変更が React DevTools で追跡しにくくなるため、デバッグがやや難しくなる可能性があります。
さらなる改善の可能性
もし「再描画をトリガーする関数の呼び出しを減らす」ことをさらに徹底したい場合、以下のようなアプローチも検討できます:
- カスタムフック内でコールバックを提供:
useFetchがデータを取得した際に、状態更新を強制するのではなく、コールバックを通じて結果を渡す。これにより、状態管理を完全にコンポーネント側に委ねることができます。 - Suspense との統合: React の
Suspenseを使用して、データフェッチのローディング状態を宣言的に管理する。ただし、これは React 18 以降の機能に依存します。
レビューワーに納得してもらうためのポイント
この改善案をレビューに出す際、以下のような説明を添えると、レビューワーに「再描画をトリガーする関数の呼び出しが減らされ、意図が達成されている」と納得してもらいやすくなります。
-
状態更新の排除: 「
useStateとsetStateを排除し、useRefを使用することで、状態更新による再描画を完全に防いでいます。これにより、パフォーマンスが最適化され、手続き処理性が排除されています。」 -
再描画の最適化: 「
useMemoを使用して UI のレンダリングをメモ化し、依存配列の変更時(userIdの変更時)にのみ再描画が行われるようにしています。これにより、不要な再描画が防がれています。」 -
宣言的アプローチの採用: 「
useFetchカスタムフックは、データフェッチのロジックを抽象化し、状態管理の詳細を隠蔽しています。コンポーネント側では、取得した結果を直接利用するだけで済むため、宣言的なスタイルが実現されています。」
結論
この改善案では、
useStateとsetStateを排除し、useRefを使用することで、「再描画をトリガーする関数の呼び出し」を最小限に抑えました。useFetchカスタムフックは副作用のロジックを抽象化し、コンポーネント側では宣言的なスタイルで結果を利用するだけになっています。これにより、手続き処理性が排除され、ポータビリティとパフォーマンスが向上しています。レビューワーにも「これならば意図が達成されている」と納得してもらえるはずです。もしさらに具体的な改善点や別のアプローチをご希望であれば、ぜひご指摘ください。
- 手続き処理性の排除:
- User
正解はだな、最初のステートをloadingから開始する、あるいは、loading状態に突入を所望しているような状態であることを表すステートを用意するか、だ。
- Assistant
ご指摘ありがとうございます。あなたの意図をようやく正確に理解できました。「再描画をトリガーする関数の呼び出しを減らす」ための鍵は、初期状態を工夫することで、
useEffect内で状態を更新する手動の処理(特にsetState)を排除することにありますね。具体的には、以下のようなアプローチが正解ということになります:- 初期状態を
loadingにする: 初期状態をloadingに設定することで、データフェッチが開始される前にローディング状態を表現し、useEffect内でsetStateを呼び出してloading状態に遷移する手動の処理を不要にする。 - 「ローディングを所望する状態」を表現するステートを用意: 例えば、
fetchRequestedのようなステートを用意し、これがtrueの場合にローディング状態を自動的に導出する。これにより、状態遷移がより宣言的になり、手動の状態更新が減る。
以下に、これらのアプローチを反映したコードを示します。今回は、特に「初期状態を
loadingにする」アプローチを中心に実装し、可能な限り手動の状態更新を排除します。改善案:初期状態を
loadingにするアプローチimport React, { useState, useEffect, useMemo } from "react"; // データフェッチの結果を表す型 type FetchState<T> = | { status: "loading"; data: null; error: null } | { status: "success"; data: T; error: null } | { status: "error"; data: null; error: Error }; // カスタムフック: データフェッチのロジックを抽象化 function useFetch<T>(url: string, dependencies: unknown[]): FetchState<T> { const [state, setState] = useState<FetchState<T>>({ status: "loading", // 初期状態を loading にする data: null, error: null, }); useEffect(() => { const abortController = new AbortController(); const signal = abortController.signal; const fetchData = async () => { try { const response = await fetch(url, { signal }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const result: T = await response.json(); if (!signal.aborted) { setState({ status: "success", data: result, error: null }); } } catch (err) { if (!signal.aborted) { setState({ status: "error", data: null, error: err instanceof Error ? err : new Error("Unknown error"), }); } } }; fetchData(); return () => { abortController.abort(); }; }, dependencies); return state; } interface User { id: number; name: string; email: string; } const UserProfile: React.FC<{ userId: number }> = ({ userId }) => { // useFetch を使用してデータフェッチ const fetchState = useFetch<User>( `https://api.example.com/users/${userId}`, [userId] ); // UI をメモ化して不要な再描画を防ぐ const content = useMemo(() => { switch (fetchState.status) { case "loading": return <div>Loading...</div>; case "error": return <div>Error: {fetchState.error?.message}</div>; case "success": return fetchState.data ? ( <div> <h1>User Profile</h1> <p>ID: {fetchState.data.id}</p> <p>Name: {fetchState.data.name}</p> <p>Email: {fetchState.data.email}</p> </div> ) : ( <div>No data available</div> ); } }, [fetchState]); return content; }; export default UserProfile;改善のポイント解説
-
初期状態を
loadingにする:useStateの初期値を{ status: "loading", data: null, error: null }に設定しました。これにより、useEffect内でsetStateを呼び出してloading状態に遷移する手動の処理が不要になります。- 結果として、
useEffect内のsetState呼び出しが 1 回(成功時またはエラー時)に減り、再描画のトリガーも最小限に抑えられます。
-
状態遷移の簡素化:
- 初期状態が
loadingであるため、データフェッチの開始時に状態を更新する必要がなくなり、コードがより宣言的になりました。useFetchは「データを取得する」という意図だけを表現し、状態管理の詳細を最小限にしています。
- 初期状態が
-
再描画の最適化:
- 初期状態が
loadingであるため、コンポーネントの初回レンダリング時にローディング UI が表示されます。その後、データフェッチが成功または失敗した際にのみsetStateが呼ばれ、再描画がトリガーされます。これにより、再描画の回数が最小限に抑えられます。
- 初期状態が
-
手続き処理性の排除:
useEffect内でsetStateを呼び出す回数が減ったため、手動の状態更新が減り、コードがより宣言的になりました。初期状態を工夫することで、副作用のロジックがシンプルになり、意図が明確になっています。
代替案:
fetchRequestedステートを用意するアプローチもし「ローディングを所望する状態」をより明示的に表現したい場合、以下のように
fetchRequestedステートを導入する方法も考えられます。この場合、状態遷移をさらに宣言的に制御できます。import React, { useState, useEffect, useMemo } from "react"; // データフェッチの結果を表す型 type FetchState<T> = | { status: "idle"; data: null; error: null } | { status: "loading"; data: null; error: null } | { status: "success"; data: T; error: null } | { status: "error"; data: null; error: Error }; // カスタムフック: データフェッチのロジックを抽象化 function useFetch<T>(url: string, dependencies: unknown[]): FetchState<T> { const [fetchRequested, setFetchRequested] = useState(true); // フェッチをリクエストする状態 const [state, setState] = useState<FetchState<T>>({ status: "idle", data: null, error: null, }); useEffect(() => { if (!fetchRequested) return; const abortController = new AbortController(); const signal = abortController.signal; const fetchData = async () => { setState({ status: "loading", data: null, error: null }); try { const response = await fetch(url, { signal }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const result: T = await response.json(); if (!signal.aborted) { setState({ status: "success", data: result, error: null }); } } catch (err) { if (!signal.aborted) { setState({ status: "error", data: null, error: err instanceof Error ? err : new Error("Unknown error"), }); } } finally { if (!signal.aborted) { setFetchRequested(false); // フェッチが完了したらリクエスト状態をリセット } } }; fetchData(); return () => { abortController.abort(); }; }, [fetchRequested, ...dependencies]); // fetchRequested が true の場合、自動的に loading 状態を導出 return fetchRequested ? { status: "loading", data: null, error: null } : state; } interface User { id: number; name: string; email: string; } const UserProfile: React.FC<{ userId: number }> = ({ userId }) => { // useFetch を使用してデータフェッチ const fetchState = useFetch<User>( `https://api.example.com/users/${userId}`, [userId] ); // UI をメモ化して不要な再描画を防ぐ const content = useMemo(() => { switch (fetchState.status) { case "loading": return <div>Loading...</div>; case "error": return <div>Error: {fetchState.error?.message}</div>; case "success": return fetchState.data ? ( <div> <h1>User Profile</h1> <p>ID: {fetchState.data.id}</p> <p>Name: {fetchState.data.name}</p> <p>Email: {fetchState.data.email}</p> </div> ) : ( <div>No data available</div> ); case "idle": default: return null; } }, [fetchState]); return content; }; export default UserProfile;代替案のポイント解説
fetchRequestedステートの導入:fetchRequestedステートを導入することで、「フェッチを所望する状態」を明示的に表現しています。このステートがtrueの場合、自動的にloading状態を導出します。- 状態遷移の宣言的制御:
fetchRequestedを依存配列に含めることで、フェッチのリクエストが明示的にトリガーされ、状態遷移がより宣言的になります。 - 再描画の最適化:
fetchRequestedがfalseにリセットされると、以降の再描画はstateの変更時(成功またはエラー時)に限定されます。
どちらのアプローチを選ぶか
- 初期状態を
loadingにするアプローチ: シンプルで直感的であり、useEffect内の手動の状態更新を最小限に抑えたい場合に適しています。コード量も少なく、意図が明確です。 fetchRequestedステートを用意するアプローチ: フェッチのリクエストをより明示的に制御したい場合や、キャッシュやリトライなどの機能を追加する可能性がある場合に適しています。ただし、コードがやや複雑になるトレードオフがあります。
レビューワーに納得してもらうためのポイント
この改善案をレビューに出す際、以下のような説明を添えると、レビューワーに「再描画をトリガーする関数の呼び出しが減らされ、意図が達成されている」と納得してもらいやすくなります。
-
初期状態の工夫: 「初期状態を
loadingに設定することで、useEffect内でsetStateを呼び出してloading状態に遷移する手動の処理を排除しました。これにより、再描画のトリガーが減り、コードがより宣言的になっています。」 -
再描画の最適化: 「状態更新はデータフェッチの成功時またはエラー時にのみ行われるため、再描画の回数が最小限に抑えられています。
useMemoを使用して UI のレンダリングをメモ化し、不要な再描画を防いでいます。」 -
手続き処理性の排除: 「初期状態を工夫することで、
useEffect内の手動の状態更新を減らし、副作用のロジックをシンプルにしました。これにより、コードの意図が明確になり、ポータビリティが向上しています。」
結論
ご指摘の通り、「初期状態を
loadingにする」アプローチが最もシンプルで効果的であり、「再描画をトリガーする関数の呼び出しを減らす」という意図を達成する正解です。このアプローチにより、useEffect内の手動の状態更新が最小限になり、コードがより宣言的でポータブルになりました。レビューワーにも「これならば意図が達成されている」と納得してもらえるはずです。もしさらに具体的な改善点や別のアプローチをご希望であれば、ぜひご指摘ください。
- 初期状態を
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.