ReactReact [リアクト]Meta開発のUIライブラリアプリケーションを開発していると、モーダルの開閉フラグ、フォーム入力のバリデーション、APIAPI [エーピーアイ]Application Programming Interface。異なるソフトウェア間の接続口通信のローディングやエラーハンドリングなど、複数のコンポーネントで似たようなロジックが重複することがよくあります。
コンポーネントの中にUIUI [ユーアイ]User Interface。ユーザーとシステムの間で情報をやり取りする接点や画面(JSX)と状態管理ロジックが混ざり合うと、コードの見通しが悪くなり保守性が低下します。そこで活躍するのが カスタムフック(Custom Hooks) です。
カスタムフックを作成すると、React標準のフック(useState や useEffect など)を組み合わせた状態管理ロジックを関数として抽出し、複数のコンポーネント間で再利用できます。ただし、カスタムフックを呼び出すたびに状態は独立して作成されるため、コンポーネント間で状態そのものが共有されるわけではありません。
本記事では、カスタムフックの基本概念や命名ルールから、最小構成の実装例、TypeScriptTypeScript [タイプスクリプト]JavaScriptに型システムを追加した言語での型安全な戻り値の設計、実務で役立つ実践例(API通信・イベント監視)、テスト手法、ありがちなアンチパターンまで体系的に解説します。
推奨環境
本記事に掲載しているコード例は、以下の環境での利用を想定・推奨しています。
| 項目 | バージョン | 補足 |
|---|---|---|
| Node.js | v22.x / v24.x / v26.x | LTS対象(26.xはActive LTS、22.x / 24.xはMaintenance LTS) |
| React | 18.3 / 19.3 | 関数コンポーネント環境 |
| TypeScript | 5.x | 厳格モード(strict: true)推奨 |
| Vitest | 2.x以上 | 使用するReact・Node.jsとの互換性を確認 |
| @testing-library/react | 16.x | renderHook 検証用 |
React 18以降の Strict Mode や React 19 環境でも利用可能な構成になっています。
カスタムフックとは?基本概念と2大ルール
カスタムフックとは、Reactの標準フック(useState や useEffect など)を呼び出すことで、コンポーネントのロジックを抽出して再利用可能にするためのJavaScript関数のことです。
特別な構文や専用のライブラリは不要で、通常の関数定義と同じように作成できます。
// カスタムフックの基本イメージfunction useCounter(initialValue: number = 0) { const [count, setCount] = useState(initialValue); const increment = () => setCount((prev) => prev + 1); return { count, increment };}なお、カスタムフックで共有されるのは「状態管理や副作用などのロジック」であり、 状態(state)そのものではありません 。例えば、2つのコンポーネントから同じ useCounter() を呼び出しても状態は共有されず、呼び出しごとにそれぞれ独立した useState の状態が作成されます。
カスタムフックを安全に作成・利用するためには、React公式が定めている 2つの重要なルール を必ず守る必要があります。
ルール1: 関数名は use に続けて大文字で始める
フックの関数名は、use に続けて大文字で始める必要があります(例: useToggle、useFetch、useWindowSize)。
ReactのESLintESLint [イーエスリント]JavaScriptやTypeScriptのコードに潜むバグや不要な記述をルールに沿って検出する静的解析ツールプラグイン(eslint-plugin-react-hooks)は、この命名規則をもとにフックを識別し、Rules of Hooksに違反する呼び出し方を静的解析します。命名規則に従わない関数では、フックの使用方法に関する問題を適切に検出できない場合があります。
ルール2: フック呼び出しのルール(Rules of Hooks)を守る
カスタムフックの内部でも、標準フックと同様に以下の規則が適用されます。
- トップレベルでのみ呼び出す: ループ文(
for)、条件分岐(if)、ネストされた関数の中でフックを呼び出してはいけません。 - Reactの関数からのみ呼び出す: Reactの関数コンポーネント、または他のカスタムフックの中からのみ呼び出せます。通常のプレーンなJavaScript関数から呼び出すことはできません。
(なお、React 19で追加された use APIには条件分岐やループ内で呼び出せる例外がありますが、useState や useEffect などの標準フックおよび通常のカスタムフックでは上記のルールを守る必要があります。)
【最小コード例】真偽値を切り替える useToggle の作成
まずは最もシンプルで実用性の高い例として、モーダルやドロワーの開閉管理に役立つ useToggle フックを作成してみましょう。
1. カスタムフックの実装
ブール値の状態と、それを反転・明示的に変更する関数を提供するフックです。
import { useState, useCallback } from 'react';
/** * 真偽値の状態と操作関数を提供するカスタムフック * @param initialValue 初期状態(デフォルト: false) */export function useToggle(initialValue: boolean = false) { const [value, setValue] = useState<boolean>(initialValue);
// トグル操作(反転) const toggle = useCallback(() => { setValue((prev) => !prev); }, []);
// 明示的にtrueにする const setTrue = useCallback(() => { setValue(true); }, []);
// 明示的にfalseにする const setFalse = useCallback(() => { setValue(false); }, []);
return { value, toggle, setTrue, setFalse };}2. コンポーネント側での呼び出し
作成したカスタムフックは、コンポーネント内で通常のフックと同じように呼び出します。
import React from 'react';import { useToggle } from '../hooks/useToggle';
export const ModalExample: React.FC = () => { const { value: isOpen, toggle, setFalse: closeModal } = useToggle(false);
return ( <div style={{ padding: '16px' }}> <button type="button" onClick={toggle}> {isOpen ? 'モーダルを閉じる' : 'モーダルを開く'} </button>
{isOpen && ( <div style={{ marginTop: '12px', border: '1px solid #ccc', padding: '16px' }}> <p>モーダルのコンテンツが表示されています。</p> <button type="button" onClick={closeModal}> 閉じる </button> </div> )} </div> );};コンポーネント側には「どのように状態を更新するか」のロジックが一切存在せず、「状態と関数を受け取ってJSXを組み立てる」というUIの責務に専念できています。
【TypeScript実践】型安全な戻り値の設計
カスタムフックをTypeScriptで記述する際、戻り値の設計には 「オブジェクト形式」 と 「配列(タプル)形式」 の2通りがあります。
1. タプル返却と型定義(as const など)
useState のように [value, setValue] という配列形式で値を返したい場合、TypeScriptにタプル型として正しく推論させる必要があります。
その方法の一つが as const (const アサーション)です。関数の戻り値型を [boolean, () => void] のように明示的に指定する方法もあります。
import { useState, useCallback } from 'react';
export function useSimpleToggle(initialValue: boolean = false) { const [value, setValue] = useState(initialValue); const toggle = useCallback(() => setValue((prev) => !prev), []);
// as const を付けないと (boolean | (() => void))[] と推論されてしまう return [value, toggle] as const;}
// 戻り値の型を明示的に指定する方法export function useSimpleToggleExplicit( initialValue: boolean = false): [boolean, () => void] { const [value, setValue] = useState(initialValue); const toggle = useCallback(() => setValue((prev) => !prev), []);
return [value, toggle];}as const を付けない場合(かつ戻り値型も明示していない場合)、戻り値が (boolean | (() => void))[] のような配列型として推論されることがあります。その場合、分割代入した各要素の型が正しく特定されず、呼び出し側で型エラーが発生する可能性があります。
// as const または戻り値型の明示がある場合:// isOpen は boolean 型、toggleOpen は () => void 型として正確に推論されるconst [isOpen, toggleOpen] = useSimpleToggle(false);2. オブジェクト形式 vs タプル形式の使い分け
どちらの形式を採用すべきかは、フックが返す値の個数と再利用性によって判断します。
| 形式 | メリット | デメリット | 推奨される場面 |
|---|---|---|---|
タプル形式 ([state, action]) | 呼び出し側で自由な名前を付けやすい | 要素数が3個以上になると順序の間違いが起きやすい | 戻り値が1〜2個のシンプルなフック(useState 互換など) |
オブジェクト形式 ({ data, error, refetch }) | 名前付きなのでプロパティの意味が明確、使わない値の省略が容易 | 呼び出し側で別名をつける際に構文が長くなる | 戻り値が3個以上、または拡張の可能性があるフック |
実務の大規模なアプリケーションでは、可読性と拡張性の観点から オブジェクト形式 が主流となっています。
【実践例1】APIデータ取得をカプセル化する useFetch
実務で最も頻繁に作成されるのが、非同期通信とライフサイクルを管理するカスタムフックです。
以下の例では、API通信中のローディング状態、取得データ、エラー状態を管理し、さらにコンポーネントがアンマウントされた際の通信キャンセル(AbortController)も組み込んでいます。
import { useState, useEffect } from 'react';
interface FetchState<T> { data: T | null; loading: boolean; error: Error | null;}
/** * 指定したURLからデータを取得するカスタムフック * @param url 取得先のエンドポイント */export function useFetch<T = unknown>(url: string): FetchState<T> { const [state, setState] = useState<FetchState<T>>({ data: null, loading: true, error: null, });
useEffect(() => { // リクエストの中断制御用コントローラー const controller = new AbortController(); const { signal } = controller;
// 通信開始時にローディングをtrueに初期化 setState({ data: null, loading: true, error: null });
async function fetchData() { try { const response = await fetch(url, { signal }); if (!response.ok) { throw new Error(`HTTPエラー: ステータスコード ${response.status}`); } const result: T = await response.json(); setState({ data: result, loading: false, error: null }); } catch (err: unknown) { // AbortError(意図的な中断)の場合は状態を更新しない if (err instanceof Error && err.name === 'AbortError') { return; } const errorObject = err instanceof Error ? err : new Error('不明なエラーが発生しました'); setState({ data: null, loading: false, error: errorObject }); } }
fetchData();
// クリーンアップ関数: アンマウント時やURL変更時に通信を中断 return () => { controller.abort(); }; }, [url]);
return state;}このフックを利用することで、コンポーネント側は通信の煩雑なエラー処理やアンマウント時のクリーンアップを意識することなく、以下のように簡潔にデータを扱えます。
// 利用例interface User { id: number; name: string;}
export const UserProfile: React.FC<{ userId: number }> = ({ userId }) => { const { data: user, loading, error } = useFetch<User>(`/api/users/${userId}`);
if (loading) return <div>読み込み中...</div>; if (error) return <div>エラー: {error.message}</div>; if (!user) return null;
return <div>ユーザー名: {user.name}</div>;};なお、この実装はAPI通信の基本的な処理をカプセル化したものです。実務で利用する際は、以下の点に注意してください。
- URLURL [ユーアールエル]Uniform Resource Locator。Webページのアドレス変更時の挙動:
AbortControllerにより古いリクエストは中断されますが、urlが変更された直後のレンダリングでは、useEffectが実行されるまで前回のdataが一時的に残る場合があります。 - キャッシュや重複排除は行われない: 同じURLを複数のコンポーネントから取得した場合でも、リクエストはそれぞれ独立して発生します。
- 実行時の型検証は行われない:
response.json()で取得したデータに型Tを割り当てていますが、TypeScriptが実行時にJSONJSON [ジェイソン]JavaScript Object Notation。軽量データ交換フォーマットの構造を検証するわけではありません。
実務でキャッシュ、リクエストの重複排除、再取得、複雑なエラーハンドリングなどが必要な場合は、TanStack Queryquery [クエリー / クエリ]データベースへの問い合わせ文などのデータ取得ライブラリを利用する方法もあります。
なお、useEffect の詳しいライフサイクルやクリーンアップ処理の仕様については 【React】useEffectの使い方!依存配列とクリーンアップ完全解説 もあわせて参照してください。
【実践例2】ブラウザイベントを監視する useWindowSize
ブラウザの画面幅や高さを監視し、レスポンシブな描画を行いたい場合のカスタムフックです。
import { useState, useEffect } from 'react';
interface WindowSize { width: number; height: number;}
export function useWindowSize(): WindowSize { const [windowSize, setWindowSize] = useState<WindowSize>({ width: 0, height: 0, });
useEffect(() => { function handleResize() { setWindowSize({ width: window.innerWidth, height: window.innerHeight, }); }
// 初期マウント時に実際のサイズを反映 handleResize();
// イベントリスナーの登録 window.addEventListener('resize', handleResize);
// クリーンアップ関数でリスナーを解除(メモリリーク防止) return () => { window.removeEventListener('resize', handleResize); }; }, []);
return windowSize;}イベントリスナーの登録と removeEventListener によるクリーンアップ処理がカスタムフック内に完結しているため、呼び出し側のコンポーネントが増えてもリスナー解除の漏れを防ぐことができます。
また、初期値を typeof window !== 'undefined' ? window.innerWidth : 0 のように分岐させると、SSR(サーバーサイドレンダリング)環境ではサーバー側(0)とブラウザ側(実際の画面幅)で初回レンダリングの結果が異なり、 Hydration mismatch(ハイドレーション不一致) が発生する可能性があります。上記のように初期値を { width: 0, height: 0 } で統一し、ブラウザ側でのみ実行される useEffect 内で実際の画面サイズを取得することで、SSR環境でも安全に動作させられます。なお、初回レンダリング時のサイズは 0 となるため、画面サイズに応じた表示切り替えを行う場合は、実際のサイズが取得されるまでの初期表示も考慮する必要があります。
アンチパターン vs ベストプラクティス
カスタムフックを作成・運用する際によく見られるアンチパターンと、その解決策を比較します。
1. Reactフックを使っていないのにカスタムフックにしてしまう
「再利用したい共通処理だから」という理由だけで、内部で useState や useEffect などのReactフックを一切使っていない関数を use 始まりにするのはアンチパターンです。
// ❌ アンチパターン: 内部でフックを使っていないfunction useFormatDate(date: Date): string { return `${date.getFullYear()}/${date.getMonth() + 1}/${date.getDate()}`;}
// ⭕ ベストプラクティス: 通常のユーティリティ関数として定義するexport function formatDate(date: Date): string { return `${date.getFullYear()}/${date.getMonth() + 1}/${date.getDate()}`;}理由: use 始まりの名前にすると、ReactのESLintプラグインによって「関数コンポーネントまたは他のカスタムフックのトップレベルでしか呼べない」というフックの制約がかかり、通常のイベントハンドラや条件分岐の中などで呼び出しにくくなります。
2. 返却する関数の参照同一性を考慮していない(useCallback の使い分け)
カスタムフックが返す関数は、特別な対策をしなければレンダリングのたびに新しい関数インスタンスが生成されます。
ただし、すべての関数を useCallback でメモ化する必要はありません。React.memo で最適化した子コンポーネントに関数を渡す場合や、useEffect の依存配列に指定する場合など、 関数の参照同一性が重要になる場面 で使用します。
以下は比較用の別々の実装例です(同じファイル内に同時に定義するものではありません)。
// 通常の実装: レンダリングのたびに新しい関数インスタンスが生成されるexport function useCounter() { const [count, setCount] = useState(0); const increment = () => setCount((c) => c + 1); return { count, increment };}// 参照の安定化が必要な場合: useCallback でメモ化するexport function useCounter() { const [count, setCount] = useState(0); const increment = useCallback(() => { setCount((c) => c + 1); }, []); // 依存配列が空なら参照が維持される return { count, increment };}使い分けのポイント: 返却された関数を React.memo でメモ化した子コンポーネントの props や useEffect の依存配列に渡している場合、関数の参照が毎回変わると不要な再描画やエフェクトの再実行(場合によっては無限ループ)の原因となります。一方で、参照同一性が不要な場面にまで過剰に useCallback を書くとコードが複雑になるため、用途に応じて使い分けましょう。
なお、React Compilerを導入している環境では、関数のメモ化が自動的に行われる場合があります。
パフォーマンス最適化やコールバックの安定化、React Compiler時代のメモ化の考え方については 【React】useMemoとuseCallbackの違い!使い分け完全解説 でも詳しく解説しています。
カスタムフックのテスト手法(Vitest + Testing Library)
カスタムフックはUIとロジックを分離できるため、画面全体を構築せずにロジックを個別にテストできます。
@testing-library/react の renderHook を使用すると、カスタムフックをテスト用のコンポーネント内で実行し、戻り値や状態の変化を検証できます。状態更新を伴う操作の検証には act を併用します。
useToggle のテストコード例
import { describe, it, expect } from 'vitest';import { renderHook, act } from '@testing-library/react';import { useToggle } from '../useToggle';
describe('useToggle', () => { it('初期値が正しく設定されること', () => { const { result } = renderHook(() => useToggle(false)); expect(result.current.value).toBe(false); });
it('toggle を呼ぶと真偽値が反転すること', () => { const { result } = renderHook(() => useToggle(false));
// 状態変更を伴う操作は act() でラップする act(() => { result.current.toggle(); });
expect(result.current.value).toBe(true);
act(() => { result.current.toggle(); });
expect(result.current.value).toBe(false); });
it('setTrue と setFalse が正しく動作すること', () => { const { result } = renderHook(() => useToggle(false));
act(() => { result.current.setTrue(); }); expect(result.current.value).toBe(true);
act(() => { result.current.setFalse(); }); expect(result.current.value).toBe(false); });});テスト実行時の重要なポイント
renderHook: カスタムフックをラップするテスト用のコンポーネントを自動生成し、result.currentを通じてフックの最新の戻り値を取得できます。act: フック内の状態更新(setState)をトリガーする操作を行う際は、必ずact(() => { ... })内で実行します。これにより、Reactの再レンダリング処理が完了するまでテストが適切に待機します。
まとめ
本記事では、Reactにおけるカスタムフックの作り方とTypeScriptでの実践的な設計パターンについて解説しました。
要点を振り返りましょう。
- カスタムフックの目的: 複数のコンポーネント間で重複する状態管理や副作用ロジックを抽出し、UIと責務を分離する(共有されるのはロジックであり、状態は呼び出しごとに独立する)。
- 命名と制約:
useに続けて大文字で始まる名前にし、Reactのフックのルール(Rules of Hooks)を遵守する。 - TypeScriptの型付け: タプル形式で返す際は
as constや戻り値型の明示でタプル型として定義する。3つ以上の値を返す場合はオブジェクト形式がおすすめ。 - アンチパターンの回避: 内部で標準フックを使っていない純粋関数は通常のユーティリティ関数にする。
useCallbackは関数の参照同一性が必要な場面で適切に使用する。 - テスト: 画面全体を構築せず、
@testing-library/reactのrenderHookとactを用いてロジックを個別に単体テストできる。
カスタムフックを適切に活用することで、コンポーネントの行数を大幅に削減し、テスト容易性と保守性の高いReactアプリケーションを構築できます。まずは頻出するトグル処理やフォーム入力の共通化から始めてみてください。
以上で本記事の解説を終わります。
よいITライフを!
人気記事
- 1
- 2
- 3
- 4
- 5
思考の整理というテーマを、実務ですぐに使える具体的な「技術」として落とし込んだ一冊です。