【React】useContextの使い方!基本から実践パターンまで徹底解説

【React】useContextの使い方!基本から実践パターンまで徹底解説

PR Amazonのアソシエイトとして、ITナレッジライフは適格販売により収入を得ています。

記事の文字数:5,380

ReactのuseContextフックの使い方をわかりやすく解説。createContextによるコンテキスト作成からProviderの設定、TypeScriptでの型安全なカスタムフック化パターン、不要な再レンダリングを防ぐベストプラクティス、境界テストまで網羅します。

ITエンジニアにお勧めの本 ↗

おすすめ

エンジニアが知っておきたい思考の整理術 複雑な情報を【理解する】【伝える】テクニック

難易度
実用性
図解

思考の整理というテーマを、実務ですぐに使える具体的な「技術」として落とし込んだ一冊です。

ベストセラー

世界一流エンジニアの思考法

難易度
実用性
思考法

技術スキル以上に大切な「考え方」をアップデートできる。世界基準の効率的な仕事術が学べます。

文系社会人のためのIT資格の歩き方: 文系のあなたに最適な道をご提案します (YKcreate kiki)

難易度
実用性
キャリア度

ロードマップが非常に明確。キャリアプランを見据えた、無駄のない学習順序を提案してくれます。

エンジニアを説明上手にする本 相手に応じた技術情報や知識の伝え方

難易度
実用性
コミュ力

「伝える技術」もエンジニアの重要なスキル。相手の視点に立った、具体的な説明のコツが満載です。

技術広報入門 ー テックブログから始めるエンジニアカルチャーのつくり方

難易度
実用性
独自性

テックブログを入口にエンジニア組織の文化をどう設計し、育てていくかという実践論が学べます。

ReactReact [リアクト]Meta開発のUIライブラリアプリケーションの規模が大きくなると、何階層も離れた深い子コンポーネントにデータを渡したい場面が必ず出てきます。その際、中間のコンポーネントを経由して愚直にPropsをリレーし続ける 「Propsのバケツリレー(Prop Drilling)」 に頭を悩ませた経験はないでしょうか。

不要なPropsリレーはコードの可読性を著しく落とし、保守性やリファクタリングの難易度を高める原因になります。この問題を根本から解消するために用意されている仕組みが、React標準の createContext と useContext フックです。

Context(コンテキスト)機能を使うと、親コンポーネントが提供した値(ユーザー認証情報、テーマ設定、多言語データなど)を、中間のコンポーネントを一切経由せずに、ツリー内の任意の子孫コンポーネントから直接取り出せます。

本記事では、useContext の基本概念や3ステップの使い方から、TypeScriptTypeScript [タイプスクリプト]JavaScriptに型システムを追加した言語での型安全なカスタムフック化パターン、パフォーマンス低下を防ぐための再レンダリング対策、Vitestを用いたテスト手法まで、実務ですぐに役立つ知識を体系的に解説します。

推奨・確認環境

本記事で解説するコード例やベストプラクティスは、以下の環境での動作を想定しています。

項目推奨・検証バージョン補足
Node.jsv22.x / v24.xLTS対象環境
React18.3 / 19.x関数コンポーネント環境(Hooks)
TypeScript5.xstrict: true(厳格モード)推奨
Vitest2.x以上単体・結合テストフレームワーク
Testing Library16.x(@testing-library/react)Reactコンポーネント・フックの検証用

React 18以降の Strict Mode や React 19 環境でもそのまま活用できるモダンな書き方で解説します。

スポンサーリンク

Propsのバケツリレー問題とuseContextの仕組み

まずは、なぜ useContext が必要なのか、その仕組みとメリットを視覚的に整理しましょう。

Propsのバケツリレー(Prop Drilling)とは?

通常のReactでは、親から子へとデータを渡すためにPropsを利用します。しかし、トップレベルの App コンポーネントが持っている「ユーザー情報」を、深層の UserProfile コンポーネントで使いたい場合、間にある Layout や Sidebar といったコンポーネントにもPropsを中継させる必要があります。

flowchart TD subgraph PropDrilling["Propsのバケツリレー(Prop Drilling)"] A[App: state保持] -->|props| B[Layout: 使わないが中継] B -->|props| C[Sidebar: 使わないが中継] C -->|props| D[UserProfile: ここで使いたい] end

この状態になると、中間のコンポーネントは 「自分では一切使わないPropsを受け取って下流へ流すだけ」 という無駄な依存関係を抱え込むことになり、コンポーネントの再利用性が著しく低下します。

useContextによるダイレクトな値の取得

ReactのContext機能を使用すると、中間のコンポーネントを経由することなく、必要なコンポーネントが直接値を受け取ることができます。

flowchart TD subgraph ContextAPI["Context + useContext"] P["UserContext.Provider (value={user})"] P -.->|Context経由で直結| C1["UserProfile: useContextで受け取る"] P -.->|Context経由で直結| C2["HeaderAvatar: useContextで受け取る"] L["Layout (中継不要)"] S["Sidebar (中継不要)"] P --> L L --> S S --> C1 end

中間のコンポーネントはPropsの受け渡しから解放され、コードの見通しが大幅に改善されます。

useContextの基本3ステップ

useContext を使いこなすための流れは、非常にシンプルです。以下の 3つのステップ で実装します。

  1. createContext でコンテキストを作成する
  2. Context.Provider でツリーに値を提供する
  3. useContext フックを使って子孫コンポーネントで値を取得する

ステップ1: createContext でコンテキストを作成

まずは React から createContext をインポートし、コンテキストオブジェクトを作成します。

import { createContext } from 'react';
// 初期値(デフォルト値)を指定してコンテキストを作成
export const ThemeContext = createContext<string>('light');

ここで渡す引数は、コンポーネントが Providerのツリーの外側 で呼び出された際に返されるデフォルト値です。

ステップ2: Context.Provider で値を提供する

親コンポーネントで、作成したコンテキストの <Context.Provider> を配置し、value プロパティに下流コンポーネントへ届けたい値を渡します。

import { useState } from 'react';
import { ThemeContext } from './ThemeContext';
import { MainContent } from './MainContent';
export function App() {
const [theme, setTheme] = useState<'light' | 'dark'>('light');
return (
<ThemeContext.Provider value={theme}>
<MainContent />
</ThemeContext.Provider>
);
}

<ThemeContext.Provider> で囲まれたすべての子孫コンポーネントが、提供された value にアクセス可能になります。

なお、React 19 からは <ThemeContext value={theme}> のようにContext自体をProviderとして記述することもできます。<Context.Provider> はReact 19でも引き続き動作しますが、将来のバージョンで非推奨化が予告されているため、React 19専用のプロジェクトでは新しい書き方も検討してください。本記事ではReact 18との互換性を優先して <Context.Provider> で解説します。

ステップ3: useContext で値を取得する

値を受け取りたい子孫コンポーネントで、useContext に先ほど作成したコンテキストオブジェクトを渡して呼び出します。

import { useContext } from 'react';
import { ThemeContext } from './ThemeContext';
export function ThemedButton() {
// 最も近いProviderから現在のthemeを取得
const theme = useContext(ThemeContext);
return (
<button className={`btn btn-${theme}`}>
現在のテーマ: {theme}
</button>
);
}

コンポーネントは一番近い親の <ThemeContext.Provider> を探し、その value を返します。親の theme ステートが更新されると、useContext(ThemeContext) を呼び出しているコンポーネントは自動的に再レンダリングされ、最新の値が反映されます。

スポンサーリンク

【最小動作コード】ダークモード切り替えの実装例

基本を理解したところで、状態の「読み取り」だけでなく「更新」も行える、テーマ切り替え機能の最小動作コードを見てみましょう。

1. Contextと型定義の作成

コンテキストが保持する値と更新関数をインターフェースで定義します。

src/contexts/ThemeContext.tsx
import { createContext, useState, type ReactNode } from 'react';
export type Theme = 'light' | 'dark';
export interface ThemeContextType {
theme: Theme;
toggleTheme: () => void;
}
// 初期値はnullで作成(Provider外利用のガードは後述のカスタムフックで行う)
export const ThemeContext = createContext<ThemeContextType | null>(null);
interface ThemeProviderProps {
children: ReactNode;
}
export function ThemeProvider({ children }: ThemeProviderProps) {
const [theme, setTheme] = useState<Theme>('light');
const toggleTheme = () => {
setTheme((prev) => (prev === 'light' ? 'dark' : 'light'));
};
return (
<ThemeContext.Provider value={{ theme, toggleTheme }}>
<div className={`theme-${theme}`}>
{children}
</div>
</ThemeContext.Provider>
);
}

2. Providerの配置

アプリケーションのルートまたは機能の親コンポーネントに <ThemeProvider> を配置します。

src/App.tsx
import { ThemeProvider } from './contexts/ThemeContext';
import { Header } from './components/Header';
import { Content } from './components/Content';
export function App() {
return (
<ThemeProvider>
<Header />
<Content />
</ThemeProvider>
);
}

3. 子孫コンポーネントでの利用

ツリー内のどこからでも、テーマの参照と切り替え実行が行えます。

src/components/ThemeToggleButton.tsx
import { useContext } from 'react';
import { ThemeContext } from '../contexts/ThemeContext';
export function ThemeToggleButton() {
const context = useContext(ThemeContext);
if (!context) {
throw new Error('ThemeToggleButtonはThemeProviderの配下で利用してください');
}
const { theme, toggleTheme } = context;
return (
<button onClick={toggleTheme}>
テーマ切り替え(現在: {theme === 'light' ? 'ライト' : 'ダーク'})
</button>
);
}

【TypeScript実践】カスタムフック化パターン(ベストプラクティス)

前述のコード例で気付いた方もいるかもしれませんが、useContext をコンポーネントで直接呼ぶと、毎回 if (!context) による nullnull [ヌル / ナル]値が存在しないことを表す特殊な値チェックのエラーガード を書く必要が生じます。

これをスマートに解決する実務の標準手法が、 「専用カスタムフック化パターン」 です。カスタムフックの自作手順については、以下の カスタムフックの作り方解説 でも詳しく取り上げています。

【React】カスタムフック(Custom Hook)の作り方!基礎から解説
ITナレッジライフ

【React】カスタムフック(Custom Hook)の作り方!基礎から解説

Reactのカスタムフック(Custom Hooks)の作り方を徹底解説。基本ルールや命名規約、最小コード例からTypeScriptでの型定義、API通信やイベント監視の実装例、テスト手法、アンチパターンと回避策まで実務で役立つ知識を体系的に紹介します。

専用カスタムフックでエラーハンドリングを隠蔽する

以下のように、Contextの定義ファイル内で useTheme というカスタムフックをエクスポートします。

src/contexts/ThemeContext.tsx
import { createContext, useCallback, useContext, useState, useMemo, type ReactNode } from 'react';
export type Theme = 'light' | 'dark';
export interface ThemeContextType {
theme: Theme;
toggleTheme: () => void;
}
// 外部にはContext本体を直接exportせず、Providerと専用Hookのみを公開する
const ThemeContext = createContext<ThemeContextType | null>(null);
export function ThemeProvider({ children }: { children: ReactNode }) {
const [theme, setTheme] = useState<Theme>('light');
// 関数の参照も安定させるため useCallback でメモ化する
const toggleTheme = useCallback(() => {
setTheme((prev) => (prev === 'light' ? 'dark' : 'light'));
}, []);
// オブジェクトの参照が変わらないようメモ化(パフォーマンス最適化)
const value = useMemo(() => ({ theme, toggleTheme }), [theme, toggleTheme]);
return (
<ThemeContext.Provider value={value}>
{children}
</ThemeContext.Provider>
);
}
/**
* テーマ情報を取得・操作するための専用カスタムフック
* Provider外で呼び出された場合は明確な実行時エラーを投げる
*/
export function useTheme(): ThemeContextType {
const context = useContext(ThemeContext);
if (!context) {
throw new Error('useThemeはThemeProviderの内部でのみ使用できます。');
}
return context;
}

呼び出し側のコードがシンプルになる

このパターンを採用すると、呼び出し側のコンポーネントは以下のように極めてシンプルになります。

src/components/ThemeToggleButton.tsx
import { useTheme } from '../contexts/ThemeContext';
export function ThemeToggleButton() {
// nullチェック不要!型推論も ThemeContextType で確定する
const { theme, toggleTheme } = useTheme();
return (
<button onClick={toggleTheme}>
現在のテーマ: {theme}
</button>
);
}

このアプローチには以下の 3大メリット があります。

  1. 型安全性の向上: 戻り値の型から null が排除され、呼び出し側で context?.theme や if (!context) を書く手間がゼロになる。
  2. 早期のバグ検知: 万が一 Provider の外でコンポーネントを使ってしまった際、原因(「ThemeProviderで囲み忘れている」)が一目でわかる例外メッセージが表示される。
  3. カプセル化: Context オブジェクト自体を外部へ非公開にできるため、意図しない場所で直接コンテキストを操作されるリスクを低減できる。
スポンサーリンク

アンチパターン vs ベストプラクティス比較

useContext は手軽で強力ですが、使い方を誤ると 「不要な再レンダリングによるパフォーマンス低下」 や 「スパゲッティコード化」 を招きます。実務でよく見られるアンチパターンと、その解決策を押さえておきましょう。オブジェクト指向や設計パターンの観点からも、関心事の分離は GoFデザインパターン一覧 などで語られる普遍的な原則です。

1. 巨大な単一Context(God Context)アンチパターン

あらゆる状態(ユーザー情報、通知設定、ショッピングカート、テーマなど)をひとつの巨大なContextに詰め込んでしまうパターンです。

❌ バッド例

// すべてを1つのコンテキストに詰め込む
interface AppState {
user: User;
theme: Theme;
notifications: Notification[];
cart: CartItem[];
// ...大量の状態
}

Reactの仕様上、 Contextの value の参照が変わると、そのContextを useContext で読み込んでいるすべてのコンポーネントが無条件で再レンダリング されます。

例えば、「テーマ(theme)だけを監視しているボタン」であっても、別のコンポーネントが「通知(notifications)」を1件追加しただけで、道連れで再レンダリングされてしまいます。

⭕ ベストプラクティス

コンテキストは「関心事(ドメイン)ごと」に細かく分割する のが基本です。

  • AuthContext: ログインユーザー情報と認証操作
  • ThemeContext: カラーテーマと表示モード
  • CartContext: ショッピングカートの状態

関心事ごとにContextを分けることで、関係のないステート更新による不要な再レンダリングを根本から遮断できます。

2. Providerのvalueにインラインオブジェクトを渡すアンチパターン

❌ バッド例

export function UserProvider({ children }: { children: ReactNode }) {
const [user, setUser] = useState<User | null>(null);
// レンダリングごとに毎回新しいオブジェクト参照が生成される!
return (
<UserContext.Provider value={{ user, setUser }}>
{children}
</UserContext.Provider>
);
}

JavaScriptでは、{} で作成されるオブジェクトは毎回異なるメモリアドレス(参照)を持ちます。そのため、UserProvider の親が再レンダリングされた際、user の中身が一切変わっていなくても value は「新しいオブジェクト」と判定され、すべての子孫購読コンポーネントが再レンダリングされてしまいます。

⭕ ベストプラクティス

useMemo を使って value に渡すオブジェクトの参照を安定させます。

export function UserProvider({ children }: { children: ReactNode }) {
const [user, setUser] = useState<User | null>(null);
// userステートが変化した時だけ新しいオブジェクト参照を生成する
const value = useMemo(() => ({ user, setUser }), [user]);
return (
<UserContext.Provider value={value}>
{children}
</UserContext.Provider>
);
}

さらに、値の「参照(state)」と「更新関数(dispatch)」のContextを2つに分離する State / Dispatch 分離パターン も非常に効果的です。更新関数しか使わないコンポーネント(ボタンなど)が、state変更時に再レンダリングされなくなります。

3. バケツリレー解消の第一手段にContextを選んでしまう

「Propsを2階層渡すのが面倒だから」と、何でもContextにしてしまうのは早計です。Contextを使うとコンポーネントと特定のProviderとの結合度が高まり、Storybookでのプレビューや単体テストが難しくなります。

⭕ ベストプラクティス: コンポーネント合成(Composition)を検討する

React公式ドキュメントでも強調されている通り、Propsバケツリレーの解決策としてまず検討すべきは 「コンポーネント合成(children の活用)」 です。

// ❌ Propsリレー: Page -> Layout -> Header -> Avatar
<Page user={user} />
// ⭕ コンポーネント合成: トップレベルでAvatarを組み立てて渡す
<Page>
<Layout>
<Header>
<Avatar user={user} />
</Header>
</Layout>
</Page>

ツリーの組み立てを親側で行い、中間の Layout や Header には単に {children} を描画させれば、Contextを使わずとも中継Propsを排除できます。コンポーネント合成で解決できない「アプリケーション全体の共有状態」に絞ってContextを採用するのがベストです。

テスト手法と境界ケース(Vitest + Testing Library)

useContext を使ったコンポーネントやカスタムフックのテスト方法を確認しましょう。Vitestを用いたテストの基本構造については Vitestの基本的な使い方入門 でも解説しています。

【Vitest】基本的な使い方入門!Jestとの違いやテストの書き方を解説
ITナレッジライフ

【Vitest】基本的な使い方入門!Jestとの違いやテストの書き方を解説

Vitestの基本的な使い方を初心者向けに徹底解説!Vite環境に最適化された高速なユニットテストフレームワークの導入手順から、テストコードの書き方、Jestとの違いやviモックの活用法まで、実機検証の出力結果を交えてわかりやすく紹介します。

1. カスタムフックのテスト(renderHook + wrapper)

renderHook の wrapper オプションを使うことで、対象のフックを Provider でラップして検証できます。

src/contexts/ThemeContext.test.tsx
import { describe, it, expect, vi } from 'vitest';
import { renderHook, act } from '@testing-library/react';
import { ThemeProvider, useTheme } from './ThemeContext';
describe('useTheme hook', () => {
it('初期テーマが light であること', () => {
const { result } = renderHook(() => useTheme(), {
wrapper: ThemeProvider,
});
expect(result.current.theme).toBe('light');
});
it('toggleTheme を呼び出すと dark に切り替わること', () => {
const { result } = renderHook(() => useTheme(), {
wrapper: ThemeProvider,
});
act(() => {
result.current.toggleTheme();
});
expect(result.current.theme).toBe('dark');
});
});

2. 境界ケース: Provider外で呼び出した際のエラーテスト

「Providerの外側で呼び出されたときに意図通り例外を投げるか」という境界ケースのテストも重要です。以下は前述の ThemeContext.test.tsx に追記する想定のコードです(vi は vitest からインポートしておきます。globals: true を設定していない場合、インポートしないと ReferenceError: vi is not defined で失敗します)。

describe('useTheme 境界ケースの検証', () => {
it('ThemeProvider外で呼び出された場合、エラーをスローすること', () => {
// コンソールへのエラー出力を一時的に抑制
const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
expect(() => {
renderHook(() => useTheme());
}).toThrow('useThemeはThemeProviderの内部でのみ使用できます。');
consoleErrorSpy.mockRestore();
});
});

このように、正常系だけでなく例外スローの挙動までテストを作成しておくことで、チーム開発でも安心してコンテキストを利用できます。

まとめ

本記事では、Reactの useContext の基本概念から実践的なカスタムフック化パターン、パフォーマンス最適化、テスト手法までを網羅して解説しました。

重要ポイントを改めて整理します。

  • 役割: 中間コンポーネントを経由することなく、ツリー上の親から子孫コンポーネントへ直接データを渡す。
  • 基本3ステップ: createContext で作成し、<Context.Provider value={...}> で提供し、useContext で受け取る。
  • 型安全化のベストプラクティス: useCustomContext のように専用カスタムフックでラップし、Provider外利用時の null ガード例外を実装する。
  • パフォーマンス配慮: 巨大な単一Contextは避け、ドメインごとにContextを細かく分割する。Providerの value は useMemo でメモ化する。
  • 事前の選択肢: 単純なPropsリレーであれば、Contextを入れる前にコンポーネント合成(children)で解決できないか検討する。

グローバルな状態管理ライブラリ(Redux、Zustandなど)を無理に導入しなくても、React標準の useContext とカスタムフックを適切に組み合わせるだけで、多くのアプリケーションの状態管理はすっきりと美しく構築できます。ぜひ日々の開発で活用してみてください。


以上で本記事の解説を終わります。
よいITライフを!
スポンサーリンク
ITナレッジライフ 運営者
この記事を書いた人

Z (ITナレッジライフ)

現役のITエンジニア。Linux、プログラミング、IT用語など、日々の業務で得た「痒いところに手が届く」技術情報を発信しています。

プロフィールと編集ポリシーを見る →
スポンサーリンク

ITエンジニアにお勧めの本 ↗

おすすめ

エンジニアが知っておきたい思考の整理術 複雑な情報を【理解する】【伝える】テクニック

難易度
実用性
図解

思考の整理というテーマを、実務ですぐに使える具体的な「技術」として落とし込んだ一冊です。

スポンサーリンク

人気記事


記事を評価

Thanks!
目次
Scroll to Top