エフェクトを使って同期を行う

一部のコンポーネントは外部システムと同期を行う必要があります。例えば、React の state に基づいて非 React 製コンポーネントを制御したり、サーバとの接続を確立したり、コンポーネントが画面に表示されたときに分析用のログを送信したりしたいかもしれません。エフェクト (Effect) を使うことで、レンダー後にコードを実行して、React 外のシステムとコンポーネントを同期させることができます。

このページで学ぶこと

  • エフェクトとは何か
  • エフェクトとイベントの違い
  • コンポーネントでエフェクトを宣言する方法
  • 不要なエフェクト再実行をスキップする方法
  • 開発中にエフェクトが 2 回実行される理由と対処法

エフェクトとは何であり、イベントとどう異なるのか

エフェクトについて説明する前に、React コンポーネント内の 2 種類のロジックについて理解しておく必要があります。

  • レンダーコードUI の記述で説明)とは、コンポーネントのトップレベルにあるものです。ここは、props や state を受け取り、それらを変換し、画面に表示したい JSX を返す場所です。レンダーコードは純粋でなければなりません。数学の式のように結果を計算するだけで、他のことは行わないようにする必要があります。

  • イベントハンドラインタラクティビティの追加で説明)とは、コンポーネント内にネストされた関数であり、計算だけでなく何かを実行するものです。イベントハンドラは、入力フィールドを更新したり、商品を購入するための HTTP POST リクエストを送信したり、ユーザを別の画面に遷移させたりすることができます。イベントハンドラには、特定のユーザアクション(例えば、ボタンクリックや入力)によって引き起こされてプログラムの状態を変更する、“副作用 (side effect)” が含まれています。

しかし、これらだけでは十分でない場合があります。画面に表示されている間、常にチャットサーバに接続していなければならない ChatRoom コンポーネントを考えてみてください。サーバへの接続は純粋な計算ではない(副作用がある)ため、レンダー中には行うことができません。しかし、ChatRoom が表示される原因となる、クリックのような特定のイベントは存在しません。

エフェクトは、特定のイベントによってではなく、レンダー自体によって引き起こされる副作用を指定するためのものです。チャットでのメッセージ送信は、ユーザが特定のボタンをクリックすることによって直接引き起こされるため、イベントです。しかし、サーバ接続のセットアップは、コンポーネントが表示される原因となるインタラクションに関係なく行われるべきであるため、エフェクトです。エフェクトは、コミットの最後に、画面が更新された後に実行されます。ここが、React コンポーネントを外部システム(ネットワークやサードパーティのライブラリなど)と同期させるのに適したタイミングです。

補足

このドキュメントの残りの部分では、“エフェクト”(大文字で始まる “Effect”)とは、上記の React 固有の定義、つまりレンダーによって引き起こされる副作用のことを指します。より広いプログラミング概念を指す場合は “副作用 (side effect)” と呼ぶことにします。

エフェクトはおそらく不要なもの

慌ててエフェクトをコンポーネントに追加しないようにしましょう。エフェクトは通常、React のコードから「踏み出して」、何らかの外部システムと同期するために使用されるものだということを肝に銘じてください。これには、ブラウザ API、サードパーティのウィジェット、ネットワークなどが含まれます。エフェクトが他の state に基づいて state を調整しているだけの場合、おそらくそのエフェクトは必要ありません

エフェクトの書き方

エフェクトを書くには、以下の 3 つのステップに従ってください。

  1. エフェクトを宣言する。デフォルトでは、エフェクトはすべてのコミット後に実行されます。
  2. エフェクトの依存値 (dependency) の配列を指定する。ほとんどのエフェクトは、レンダー後に毎回ではなく、必要に応じて再実行されるべきものです。例えば、フェードインアニメーションの開始は、コンポーネントが表示されるときにのみ行われるべきです。チャットルームへの接続と切断は、コンポーネントが表示されたり消えたりするときや、チャットルームが変更されたときにのみ行われるべきです。依存配列を指定してこれをコントロールする方法について、後で説明します。
  3. 必要に応じてクリーンアップを追加する。一部のエフェクトは、行っていたことを停止、元に戻す、またはクリーンアップする方法を指定する必要があります。例えば、「接続」には「切断」が必要で、「登録」には「解除」が必要で、「取得」には「キャンセル」または「無視」が必要です。クリーンアップ関数を返すことで、これを行う方法を学びます。

それぞれのステップを詳しく見ていきましょう。

ステップ 1:エフェクトを宣言する

コンポーネントでエフェクトを宣言するには、React から useEffect フックをインポートします。

import { useEffect } from 'react';

次に、コンポーネントのトップレベルでそれを呼び出し、エフェクト内にコードを記述します。

function MyComponent() {
useEffect(() => {
// Code here will run after *every* render
});
return <div />;
}

コンポーネントがレンダーされるたびに、React は画面を更新し、その後で useEffect 内のコードを実行します。言い換えると、useEffect はレンダー結果が画面に反映され終わるまで、コードの実行を「遅らせ」ます

エフェクトを使って外部システムと同期する方法を見てみましょう。<VideoPlayer> という React コンポーネントを考えてみてください。props として isPlaying を渡すことで、再生中か一時停止中かを制御できると便利です。

<VideoPlayer isPlaying={isPlaying} />;

カスタム VideoPlayer コンポーネントは、ブラウザ組み込みの <video> タグをレンダーします。

function VideoPlayer({ src, isPlaying }) {
// TODO: do something with isPlaying
return <video src={src} />;
}

しかしブラウザの <video> タグに isPlaying プロパティはありません。ビデオを制御する唯一の方法は、DOM 要素上で play() および pause() メソッドを手動で呼び出すことです。ビデオが現在再生中であるべきかどうかを示す props である isPlaying の値を、play()pause() などの呼び出しと同期させる必要があるわけです

まず、<video> DOM ノードへの ref を取得する必要があります。

レンダー中に play()pause() を呼び出したくなるかもしれませんが、それは正しくありません。

import { useState, useRef, useEffect } from 'react';

function VideoPlayer({ src, isPlaying }) {
  const ref = useRef(null);

  if (isPlaying) {
    ref.current.play();  // Calling these while rendering isn't allowed.
  } else {
    ref.current.pause(); // Also, this crashes.
  }

  return <video ref={ref} src={src} loop playsInline />;
}

export default function App() {
  const [isPlaying, setIsPlaying] = useState(false);
  return (
    <>
      <button onClick={() => setIsPlaying(!isPlaying)}>
        {isPlaying ? 'Pause' : 'Play'}
      </button>
      <VideoPlayer
        isPlaying={isPlaying}
        src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
      />
    </>
  );
}

このコードが正しくない理由は、レンダー中に DOM ノードで何かをしようとしているからです。React では、レンダーは JSX の純粋な計算であるべきであり、DOM の変更のような副作用を含んではいけません。

それに、VideoPlayer が初めて呼び出されるとき、その DOM はそもそも存在していません! React は JSX が返されるまでどんな DOM を作成したいのか分からないのですから、play()pause() を呼び出すための DOM ノードはまだ存在していません。

ここでの解決策は、副作用を useEffect でラップして、レンダーの計算処理の外に出すことです

import { useEffect, useRef } from 'react';

function VideoPlayer({ src, isPlaying }) {
const ref = useRef(null);

useEffect(() => {
if (isPlaying) {
ref.current.play();
} else {
ref.current.pause();
}
});

return <video ref={ref} src={src} loop playsInline />;
}

DOM の更新をエフェクトでラップすることで、React が先にまず画面を更新できるようになります。その後、エフェクトが実行されます。

VideoPlayer コンポーネントがレンダーされるとき(初回または再レンダーのいずれでも)、いくつかのことが起こります。まず、React は画面を更新し、正しいプロパティを持つ <video> タグが DOM に存在するようにします。次に、React はエフェクトを実行します。最後に、エフェクトは isPlaying の値に応じて play() または pause() を呼び出します。

再生/一時停止を何度か押して、ビデオプレーヤが isPlaying の値に同期していることを確認してください。

import { useState, useRef, useEffect } from 'react';

function VideoPlayer({ src, isPlaying }) {
  const ref = useRef(null);

  useEffect(() => {
    if (isPlaying) {
      ref.current.play();
    } else {
      ref.current.pause();
    }
  });

  return <video ref={ref} src={src} loop playsInline />;
}

export default function App() {
  const [isPlaying, setIsPlaying] = useState(false);
  return (
    <>
      <button onClick={() => setIsPlaying(!isPlaying)}>
        {isPlaying ? 'Pause' : 'Play'}
      </button>
      <VideoPlayer
        isPlaying={isPlaying}
        src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
      />
    </>
  );
}

この例では、React の state に同期させる「外部システム」とはブラウザのメディア API でした。同様のアプローチを使用して、古い非 React コード(jQuery プラグインなど)を宣言的な React コンポーネントにラップできます。

なおビデオプレーヤの制御は実際にはもっと複雑です。play() の呼び出しは失敗することがありますし、ユーザはブラウザ組み込みのコントロールを使って再生や一時停止を行うかもしれません。この例は非常に単純化された不完全なものです。

落とし穴

デフォルトでは、エフェクトは毎回のレンダーの後に実行されます。このため、次のようなコードは無限ループを引き起こします

const [count, setCount] = useState(0);
useEffect(() => {
setCount(count + 1);
});

エフェクトはレンダーの結果として実行されます。state の設定はレンダーをトリガします。エフェクトで直ちに state を設定するというのは、電源コンセントを自分自身に接続するようなものです。エフェクトが実行され、state がセットされ、これによって再レンダーが発生し、エフェクトが実行され、再び state がセットされ、これによってまた再レンダーが発生し、という具合に続きます。

エフェクトは通常、コンポーネントを外部システムと同期させるのに使います。外部システムがなく、他の state に基づいて state を調整したいだけの場合、エフェクトは必要ありません

ステップ 2:エフェクトの依存配列を指定する

デフォルトでは、エフェクトはすべてのレンダー後に実行されます。しかし、これが望ましくない場合があります

  • 時にはそれが遅いことがあります。外部システムとの同期は常に瞬時に起こるものではないため、必要でない限り行わない方が良いかもしれません。例えば、キーストロークごとにチャットサーバに再接続することは望ましくありません。
  • 時にはそれが間違っていることがあります。例えば、キーストロークごとにコンポーネントのフェードインアニメーションを開始したくはありません。アニメーションは、コンポーネントが初めて表示されるときに 1 回だけ再生されるべきです。

問題を示すために、前掲の例に、いくつかの console.log 呼び出しと、親コンポーネントの state を更新するテキスト入力フィールドを加えたものを示します。タイピングによってエフェクトが再実行されていることを確認してください。

import { useState, useRef, useEffect } from 'react';

function VideoPlayer({ src, isPlaying }) {
  const ref = useRef(null);

  useEffect(() => {
    if (isPlaying) {
      console.log('Calling video.play()');
      ref.current.play();
    } else {
      console.log('Calling video.pause()');
      ref.current.pause();
    }
  });

  return <video ref={ref} src={src} loop playsInline />;
}

export default function App() {
  const [isPlaying, setIsPlaying] = useState(false);
  const [text, setText] = useState('');
  return (
    <>
      <input value={text} onChange={e => setText(e.target.value)} />
      <button onClick={() => setIsPlaying(!isPlaying)}>
        {isPlaying ? 'Pause' : 'Play'}
      </button>
      <VideoPlayer
        isPlaying={isPlaying}
        src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
      />
    </>
  );
}

useEffect の呼び出しの第 2 引数として依存値の配列を指定することで、React にエフェクトの不必要な再実行をスキップするように指示できます。まず、上記の例の 14 行目に空の [] 配列を追加してください。

useEffect(() => {
// ...
}, []);

React Hook useEffect has a missing dependency: 'isPlaying' というエラーが表示されるはずです。

import { useState, useRef, useEffect } from 'react';

function VideoPlayer({ src, isPlaying }) {
  const ref = useRef(null);

  useEffect(() => {
    if (isPlaying) {
      console.log('Calling video.play()');
      ref.current.play();
    } else {
      console.log('Calling video.pause()');
      ref.current.pause();
    }
  }, []); // This causes an error

  return <video ref={ref} src={src} loop playsInline />;
}

export default function App() {
  const [isPlaying, setIsPlaying] = useState(false);
  const [text, setText] = useState('');
  return (
    <>
      <input value={text} onChange={e => setText(e.target.value)} />
      <button onClick={() => setIsPlaying(!isPlaying)}>
        {isPlaying ? 'Pause' : 'Play'}
      </button>
      <VideoPlayer
        isPlaying={isPlaying}
        src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
      />
    </>
  );
}

問題は、エフェクト内のコードが isPlaying プロパティに依存して何をすべきかを決定しているにもかかわらず、その依存関係が明示的に宣言されていないことです。この問題を解決するために、依存配列に isPlaying を追加してください。

useEffect(() => {
if (isPlaying) { // It's used here...
// ...
} else {
// ...
}
}, [isPlaying]); // ...so it must be declared here!

依存値がすべて宣言されているので、エラーはなくなりました。依存配列として [isPlaying] を指定することで、React に isPlaying が前回のレンダー時と同じである場合は、エフェクトの再実行をスキップするように指示しています。この変更により、入力欄に入力してもエフェクトは再実行されず、再生/一時停止ボタンを押した場合は再実行されるようになります。

import { useState, useRef, useEffect } from 'react';

function VideoPlayer({ src, isPlaying }) {
  const ref = useRef(null);

  useEffect(() => {
    if (isPlaying) {
      console.log('Calling video.play()');
      ref.current.play();
    } else {
      console.log('Calling video.pause()');
      ref.current.pause();
    }
  }, [isPlaying]);

  return <video ref={ref} src={src} loop playsInline />;
}

export default function App() {
  const [isPlaying, setIsPlaying] = useState(false);
  const [text, setText] = useState('');
  return (
    <>
      <input value={text} onChange={e => setText(e.target.value)} />
      <button onClick={() => setIsPlaying(!isPlaying)}>
        {isPlaying ? 'Pause' : 'Play'}
      </button>
      <VideoPlayer
        isPlaying={isPlaying}
        src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
      />
    </>
  );
}

依存配列には複数の依存値を含めることができます。React は、指定したすべての依存値が前回のレンダー時とまったく同じ値である場合に限り、エフェクトの再実行をスキップします。React は、個々の依存値を Object.is を用いて比較します。詳細については useEffect リファレンスを参照してください。

依存値は自分で「選ぶ」ようなものではありません。エフェクト内のコードに基づいて React が期待する配列と、指定した依存配列が合致しない場合、リントエラーが発生します。これにより、コード内の多くのバグを検出することができます。一部のコードを再実行しない場合は、エフェクトのコード自体を編集して、その依存値が「必要」とならないようにします

落とし穴

依存配列がない場合と、空の [] という依存配列がある場合の挙動は異なります。

useEffect(() => {
// 毎回のレンダー後に実行される
});

useEffect(() => {
// マウント時(コンポーネント出現時)のみ実行される
}, []);

useEffect(() => {
// マウント時と、a か b の値が前回のレンダーより変わった場合に実行される
}, [a, b]);

次のステップで、「マウント」とは何かを詳しく見ていきます。

さらに深く知る

なぜ ref は依存配列にないのか?

このエフェクトでは、refisPlaying の両方が使用されていますが、依存値として宣言されているのは isPlaying のみです。

function VideoPlayer({ src, isPlaying }) {
const ref = useRef(null);
useEffect(() => {
if (isPlaying) {
ref.current.play();
} else {
ref.current.pause();
}
}, [isPlaying]);

これは、ref オブジェクトが毎回同一のものだからです。React は、同じ useRef コールから常に同じオブジェクトが返されることを保証しています。これが変更されることはないため、それ自体がエフェクトの再実行を引き起こすことも決してありません。したがって、それを含めるかどうかは問題となりません。ただし含めても問題ありません:

function VideoPlayer({ src, isPlaying }) {
const ref = useRef(null);
useEffect(() => {
if (isPlaying) {
ref.current.play();
} else {
ref.current.pause();
}
}, [isPlaying, ref]);

useState によって返される set 関数も毎回全く同一のものであるため、依存配列から省略されることがよくあります。ある依存値を省略してもリンタのエラーが出ない場合は、それを行っても安全です。

毎回同一である値を依存配列から省略できるのは、リンタがそのオブジェクトが毎回同一であると「判断できる」場合のみです。例えば、ref が親コンポーネントから渡される場合は、依存配列にそれを指定する必要があります。親コンポーネントが常に同じ ref を渡すのか、それとも条件付きで違う ref から 1 つ選んで渡すのか、知ることはできないのですから、これは良いことです。あなたのエフェクトは、どの ref が渡されるかに確かに依存していることになります。

ステップ 3:必要に応じてクリーンアップを追加する

別の例を考えてみましょう。表示されたときにチャットサーバに接続する必要がある ChatRoom コンポーネントを作成しているとします。connect() および disconnect() というメソッドを持つオブジェクトを返す createConnection() という API があります。コンポーネントがユーザに表示されている間、接続を維持するにはどうすればよいでしょうか?

まず、エフェクトのロジックを書いてみましょう。

useEffect(() => {
const connection = createConnection();
connection.connect();
});

再レンダー後に毎回チャットに接続するのは遅いため、依存配列を追加します。

useEffect(() => {
const connection = createConnection();
connection.connect();
}, []);

エフェクト内のコードは props や state を使用していないため、依存配列は [](空)です。こうすると React に、コンポーネントが「マウント」される、つまり画面に初めて表示されるときにのみこのコードを実行するよう指示することになります

このコードを実行してみましょう。

import { useEffect } from 'react';
import { createConnection } from './chat.js';

export default function ChatRoom() {
  useEffect(() => {
    const connection = createConnection();
    connection.connect();
  }, []);
  return <h1>Welcome to the chat!</h1>;
}

このエフェクトはマウント時にのみ実行されるため、コンソールに "✅ Connecting..." が 1 回だけ表示されると思うかもしれません。しかし、コンソールを確認すると、"✅ Connecting..." が 2 回表示されているはずです。なぜこれが起こるのでしょうか?

ChatRoom コンポーネントが、さまざまな画面がある大規模なアプリの一部であると想像してみてください。ユーザは ChatRoom ページからナビゲーションを始めます。コンポーネントがマウントされ、connection.connect() が呼び出されます。次に、ユーザが別の画面、例えば設定ページに移動します。ChatRoom コンポーネントがアンマウントされます。最後に、ユーザが戻るボタンをクリックし、ChatRoom が再びマウントされます。これにより 2 つ目の接続が設定されます…が、最初の接続は破棄されていません! ユーザがアプリ内で移動するたびに、接続がどんどん積み重なっていくことになります。

このようなバグは、手動での徹底的なテストがないと見逃しやすいものです。これらをすばやく見つけるために、開発環境では React は、初回マウント直後にすべてのコンポーネントを一度だけ再マウントします。

"✅ Connecting..." のログが 2 回表示されることで、実際の問題に気付くことができます。つまり、コンポーネントがアンマウントされたときに接続を閉じるコードがないということです。

この問題を解決するには、エフェクトからクリーンアップ関数を返すようにします。

useEffect(() => {
const connection = createConnection();
connection.connect();
return () => {
connection.disconnect();
};
}, []);

React は、エフェクトが再度実行される前に毎回クリーンアップ関数を呼び出し、コンポーネントがアンマウントされる(削除される)ときにも最後の 1 回の呼び出しを行います。クリーンアップ関数が実装された場合、どのような動作になるか見てみましょう。

import { useState, useEffect } from 'react';
import { createConnection } from './chat.js';

export default function ChatRoom() {
  useEffect(() => {
    const connection = createConnection();
    connection.connect();
    return () => connection.disconnect();
  }, []);
  return <h1>Welcome to the chat!</h1>;
}

これで、開発中に 3 つのコンソールログが表示されるようになります。

  1. "✅ Connecting..."
  2. "❌ Disconnected."
  3. "✅ Connecting..."

これが開発環境での正しい動作です。コンポーネントを再マウントすることで、React はページを離れて戻ってきてもコードが壊れないことを確認します。切断してからの再接続は、まさに起こるべきことなのです! クリーンアップがうまく実装されていれば、エフェクトを 1 回だけ実行することと、クリーンアップしてから再度実行することとの間に、ユーザにとって目に見える違いはないはずです。開発中にコードのバグを探るために、接続/切断の呼び出しペアが 1 つ余分にあるだけです。これは正常ですので、消そうとしないでください!

本番環境では、"✅ Connecting..." が 1 回だけ表示されます。コンポーネントの再マウントは、クリーンアップが必要なエフェクトを見つけるために開発中にのみ行われます。Strict Mode を外すことで、開発時専用のこの挙動をオフにすることができますが、オンにしておくことをお勧めします。これにより、上記のような多くのバグを見つけることができます。

開発環境で 2 回発生するエフェクトへの正しい対応

React は、開発中に意図的にコンポーネントを再マウントして、前述の例のようなバグを見つけます。ここでの正しい質問は「エフェクトを 1 回だけ実行する方法」ではなく「再マウントされても正しく動作するようエフェクトを修正する方法」です

通常、答えはクリーンアップ関数を実装することです。クリーンアップ関数は、エフェクトが行っていたことを停止または元に戻すべきです。大事なルールとして、ユーザは(本番環境でのように)エフェクトが一度だけ実行される場合と、(開発環境でのように)セットアップ → クリーンアップ → セットアップと続く場合との違いを、見分けることができないようにするべきです。

ほとんどのエフェクトは、以下の一般的なパターンのいずれかに合致します。

落とし穴

ref を使ってエフェクトの実行を抑止しようとしない

開発時にエフェクトが 2 回実行されるのを抑止しようとして ref を使おうとするのはよくある誤りです。上記のバグを useRef を使って以下のように「修正」しようと思うかもしれません。

const connectionRef = useRef(null);
useEffect(() => {
// 🚩 This wont fix the bug!!!
if (!connectionRef.current) {
connectionRef.current = createConnection();
connectionRef.current.connect();
}
}, []);

これにより "✅ Connecting..." が開発時に 1 回だけ表示されるようにはなるのですが、これでバグが修正されるわけではありません。

ユーザが他のページに移動しても、接続は閉じられず、戻ってきたときに新しい接続が作成されます。ユーザがアプリ内を移動するたびに接続が積み重なっていきます。「修正」前と同じ状況です。

このバグを修正するには、エフェクトを一度だけ実行するようにするだけでは不十分です。エフェクトは再マウント時にも機能する必要があり、接続は上記の解決策のようにクリーンアップされる必要があるのです。

以下の例を参考に、一般的なパターンの処理方法を確認してください。

React 以外のウィジェットを制御する

時に、React で書かれていない UI ウィジェットを追加したい場合があります。例えば、ページに地図コンポーネントを追加しようとしているとします。setZoomLevel() メソッドがあり、React のコード内の zoomLevel という state 変数と同期させたいとします。エフェクトは次のようになります。

useEffect(() => {
const map = mapRef.current;
map.setZoomLevel(zoomLevel);
}, [zoomLevel]);

この場合、クリーンアップは必要ありません。開発環境では React はこのエフェクトを 2 回呼び出しますが、同じ値で setZoomLevel を 2 回呼び出しても何も起きません。わずかに遅くはなるかもしれませんが、本番環境では無用に再マウントされることはないので、問題はありません。

API によっては、連続して 2 回呼び出すことができない場合があります。例えば、組み込みの <dialog> 要素の showModal メソッドは、2 回呼び出すと例外が発生します。クリーンアップ関数を実装し、ダイアログを閉じるようにしてください。

useEffect(() => {
const dialog = dialogRef.current;
dialog.showModal();
return () => dialog.close();
}, []);

開発中、エフェクトは showModal() を呼び出し、すぐに close() を呼び出し、再び showModal() を呼び出します。ユーザに見える動作としては、本番環境で showModal() を 1 回だけ呼び出すのと同じになります。

イベントのリッスン

エフェクトが何かをリッスンしている場合、クリーンアップ関数はそれを解除する必要があります。

useEffect(() => {
function handleScroll(e) {
console.log(window.scrollX, window.scrollY);
}
window.addEventListener('scroll', handleScroll);
return () => window.removeEventListener('scroll', handleScroll);
}, []);

開発環境では、エフェクトは addEventListener() を呼び出し、すぐに removeEventListener() を呼び出し、同じハンドラで再び addEventListener() を呼び出します。そのため、一度にアクティブなリスナは 1 つだけです。ユーザに見える動作としては、本番環境で addEventListener() を 1 回だけ呼び出すのと同じになります。

アニメーションのトリガ

エフェクトが何かをアニメーションで表示する場合、クリーンアップ関数はアニメーションを初期値にリセットする必要があります。

useEffect(() => {
const node = ref.current;
node.style.opacity = 1; // Trigger the animation
return () => {
node.style.opacity = 0; // Reset to the initial value
};
}, []);

開発中は、opacity が 1 にセットされ、次に 0 にセットされ、再び 1 にセットされます。ユーザに見える動作としては、本番環境で直接 1 に設定される場合と同じになるべきです。トゥイーンに対応したサードパーティのアニメーションライブラリを使用している場合、クリーンアップ関数はタイムラインを初期状態にリセットする必要があります。

データのフェッチ

エフェクトが何かをフェッチ(fetch, 取得)する場合、クリーンアップ関数は、フェッチを中止するか、その結果を無視する必要があります。

useEffect(() => {
let ignore = false;

async function startFetching() {
const json = await fetchTodos(userId);
if (!ignore) {
setTodos(json);
}
}

startFetching();

return () => {
ignore = true;
};
}, [userId]);

すでに発生したネットワークリクエストをなかったことにはできませんが、クリーンアップ関数は、もはや重要ではなくなったフェッチがアプリケーションに影響を与え続けないようにする必要があります。userId'Alice' から 'Bob' に変わった場合、クリーンアップは、'Alice' のレスポンスが 'Bob' の後に到着した場合に無視されるようにします。

開発環境では、ネットワークタブに 2 つのフェッチが表示されます。これには何の問題もありません。上記のアプローチでは、最初のエフェクトがすぐにクリーンアップされるため、ignore 変数のコピーが true に設定されます。そのため、余分なリクエストがあっても、if (!ignore) チェックのおかげで state に影響を与えません。

本番環境では、リクエストは 1 回だけになります。開発環境の 2 つ目のリクエストが気になる場合は、リクエストの重複を排除し、コンポーネント間でレスポンスをキャッシュするソリューションを使用することが最善の方法です。

function TodoList() {
const todos = useSomeDataLibrary(`/api/user/${userId}/todos`);
// ...

これにより、開発体験が向上するだけでなく、アプリケーションの動作も高速化されます。例えば、ユーザが戻るボタンを押しても、キャッシュされたデータがあるため、再びデータをロードするのを待つ必要がありません。このようなキャッシュを自分で構築することもできますし、エフェクトでの手動フェッチを行う多数のライブラリの選択肢からいずれかを使用することもできます。

さらに深く知る

エフェクトでのデータ取得に代わる良い方法は?

特に完全にクライアントサイドのアプリにおいては、エフェクトの中で fetch コールを書くことはデータフェッチの一般的な方法です。しかし、これは非常に手作業頼りのアプローチであり、大きな欠点があります。

  • エフェクトはサーバ上では動作しません。これは、サーバレンダリングされた初期 HTML にはデータのないローディング中という表示のみが含まれてしまうことを意味します。クライアントのコンピュータは、すべての JavaScript をダウンロードし、アプリをレンダーした後になってやっと、今度はデータを読み込む必要もあるということに気付くことになります。これはあまり効率的ではありません。
  • エフェクトで直接データフェッチを行うと、「ネットワークのウォーターフォール(滝)」を作成しやすくなります。親コンポーネントをレンダーし、それが何かデータをフェッチし、それによって子コンポーネントをレンダーし、今度はそれが何かデータのフェッチを開始する、といった具合です。ネットワークがあまり速くない場合、これはすべてのデータを並行で取得するよりもかなり遅くなります。
  • エフェクト内で直接データフェッチするということはおそらくデータをプリロードもキャッシュもしていないということです。例えば、コンポーネントがアンマウントされた後に再びマウントされる場合、データを再度取得する必要があります。
  • 人にとって書きやすいコードになりません競合状態のようなバグを起こさないように fetch コールを書こうとすると、かなりのボイラープレートコードが必要です。

上記の欠点は、マウント時にデータをフェッチするのであれば、React に限らずどのライブラリを使う場合でも当てはまる内容です。ルーティングと同様、データフェッチの実装も上手にやろうとすると一筋縄ではいきません。私たちは以下のアプローチをお勧めします。

  • フレームワークを使用している場合、組み込みのデータフェッチ機構を使用してください。モダンな React フレームワークには、効率的で上記の欠点がないデータフェッチ機構が統合されています。
  • それ以外の場合は、クライアントサイドキャッシュの使用や構築を検討してください。一般的なオープンソースのソリューションには、React QueryuseSWR、および React Router 6.4+ が含まれます。自分でソリューションを構築することもできます。その場合、エフェクトを内部で使用しつつ、リクエストの重複排除、レスポンスのキャッシュ、ネットワークのウォーターフォールを回避するためのロジック(データのプリロードやルーティング部へのデータ要求の巻き上げ)を追加することになります。

これらのアプローチがどちらも適合しない場合は、引き続きエフェクト内で直接データをフェッチすることができます。

アナリティクスログの送信

ページ訪問時にアナリティクスイベントを送信する次のコードを考えてみましょう:

useEffect(() => {
logVisit(url); // Sends a POST request
}, [url]);

開発中には、logVisit が各 URL ごとに 2 回呼び出されるため、それを修正しようと試みるかもしれません。このコードはそのままにしておくことをお勧めします。先の例と同様に、1 度実行することと 2 度実行することとの間にユーザに見える挙動の違いはありません。実用的な観点からは、開発マシンからのログのせいで本番の計測結果がおかしくなることは望まないため、logVisit 関数は開発環境では何も行わないはずです。あなたがファイルを保存するたびにコンポーネントは再マウントされるのですから、開発環境において余分な訪問が記録されることはいずれにせよ避けられません。

本番環境では訪問ログの重複は起こりません

送信しているアナリティクスイベントをデバッグするには、アプリを(本番モードで実行される)ステージング環境にデプロイするか、一時的に Strict Mode を外して開発環境専用の再マウントチェックを止めることができます。また、エフェクトの代わりにルート変更のイベントハンドラからアナリティクスログを送信することもできます。より正確な分析のために交差オブザーバを用いれば、どのコンポーネントがビューポートにありどれだけの時間表示されているかを追跡するのに役立ちます。

アプリケーション初期化はエフェクトではない

アプリケーションの起動時に一度だけ実行されるべきロジックがあります。そのようなものはコンポーネントの外に置くことができます:

if (typeof window !== 'undefined') { // Check if we're running in the browser.
checkAuthToken();
loadDataFromLocalStorage();
}

function App() {
// ...
}

これにより、そのようなロジックはブラウザがページを読み込んだ後に一度だけ実行されることが保証されます。

商品購入はエフェクトではない

クリーンアップ関数を書いても、エフェクトを 2 回実行することによるユーザに見える影響を防ぐ方法がないことがあります。例えば、エフェクトが商品の購入のような POST リクエストを送信する場合です:

useEffect(() => {
// 🔴 Wrong: This Effect fires twice in development, exposing a problem in the code.
fetch('/api/buy', { method: 'POST' });
}, []);

同じ商品を 2 度買いたいわけではありません。しかしまさにそれが、そもそもエフェクトにこのロジックを入れてはいけない理由でもあるのです。ユーザが別のページに行ってから戻るボタンを押した場合、どうなるでしょう? あなたのエフェクトは再び実行されてしまいます。ユーザはページを訪れるたびに製品を買いたいわけではなく、クリックして購入ボタンを押したときに買いたいのです。

購入はレンダーによって引き起こされるのではなく、特定のユーザ操作によって引き起こされるものです。ユーザがボタンを押したときにのみ実行する必要があります。エフェクトを削除し、/api/buy リクエストを購入ボタンのイベントハンドラに移動してください

function handleClick() {
// ✅ Buying is an event because it is caused by a particular interaction.
fetch('/api/buy', { method: 'POST' });
}

これで分かるのは、再マウントでアプリケーションのロジックが壊れるなら、通常それは既存のバグが明らかになったのだということです。ユーザの視点から見ると、ページを訪れることと、ページを訪れてリンクをクリックしてから戻るボタンを押して元のページをもう一度見ることとの間に、違いがあってはいけません。React は、開発環境でコンポーネントを 1 度再マウントすることで、この原則に従っていることを確認します。

ここまでのまとめ

以下のプレイグラウンドは、エフェクトの動作について「感覚を掴む」のに役立ちます。

この例では、setTimeout を使用して、エフェクトが実行されてから 3 秒後に入力テキストを含むコンソールログが表示されるようにスケジュールしています。クリーンアップ関数は、保留中のタイムアウトをキャンセルします。まず、「コンポーネントをマウント」ボタンを押してください。

import { useState, useEffect } from 'react';

function Playground() {
  const [text, setText] = useState('a');

  useEffect(() => {
    function onTimeout() {
      console.log('⏰ ' + text);
    }

    console.log('🔵 Schedule "' + text + '" log');
    const timeoutId = setTimeout(onTimeout, 3000);

    return () => {
      console.log('🟡 Cancel "' + text + '" log');
      clearTimeout(timeoutId);
    };
  }, [text]);

  return (
    <>
      <label>
        What to log:{' '}
        <input
          value={text}
          onChange={e => setText(e.target.value)}
        />
      </label>
      <h1>{text}</h1>
    </>
  );
}

export default function App() {
  const [show, setShow] = useState(false);
  return (
    <>
      <button onClick={() => setShow(!show)}>
        {show ? 'Unmount' : 'Mount'} the component
      </button>
      {show && <hr />}
      {show && <Playground />}
    </>
  );
}

最初に 3 つのログが表示されます。Schedule "a" logCancel "a" log、そして再び Schedule "a" log です。3 秒後には、a というログも表示されます。前述のように、スケジュール・キャンセルのペアが 1 回余分に出てくるのは、React が開発中にコンポーネントを一度再マウントして、クリーンアップがうまく実装されていることを確認するためです。

次に、入力欄に abc と入力します。十分に早く行えば、Schedule "ab" logCancel "ab" logSchedule "abc" log の順でログが表示されます。React は常に、次のレンダーのエフェクトの前に、前のレンダーのエフェクトをクリーンアップします。したがって入力欄に素早く入力しても、同時にスケジュールされるタイムアウトは最大でも 1 つです。入力欄を何度か編集して、コンソールを見て、エフェクトがどのようにクリーンアップされるか、感覚を掴んでください。

入力欄に何か入力してからすぐに “Unmount the component” ボタンを押してみてください。アンマウントによって、最後のレンダーのエフェクトがクリーンアップされることに気付くでしょう。この場合は、最後のタイムアウトが、発火する前にクリアされます。

最後に、上のコンポーネントを編集して、クリーンアップ関数をコメントアウトしてタイムアウトがキャンセルされないようにしてみてください。abcde を素早く入力してみてください。3 秒後に何が起こると思いますか? タイムアウト内の console.log(text) は、最新の text、つまり abcde というログを 5 回生成するのでしょうか? あなたの直観を確かめるため実際に試してみましょう!

3 秒後に、abcde ログが 5 回表示されるのではなく、ログが順番に表示される(aababcabcdabcde)はずです。各エフェクトは、対応するレンダーからの text 値を「キャプチャ」しますtext の state が変更されたとしても、text = 'ab' だったレンダーからのエフェクトには常に 'ab' という値が見えることになります。言い換えると、各レンダーからのエフェクトは互いに隔離されています。これがどのように動作するか興味がある場合は、クロージャについて学びましょう。

さらに深く知る

個々のレンダーに別のエフェクトがある

useEffect を、レンダー出力に何らかの振る舞いを「付随」させるものであると考えることができます。以下のエフェクトを考えてみましょう。

export default function ChatRoom({ roomId }) {
useEffect(() => {
const connection = createConnection(roomId);
connection.connect();
return () => connection.disconnect();
}, [roomId]);

return <h1>Welcome to {roomId}!</h1>;
}

ユーザがアプリを操作する際に、具体的に何が起こるか見てみましょう。

初期レンダー

ユーザは <ChatRoom roomId="general" /> を訪れます。roomId'general' であると頭の中で置き換えてみましょう。

// JSX for the first render (roomId = "general")
return <h1>Welcome to general!</h1>;

エフェクトもまた、レンダー出力の一部です。最初のレンダーのエフェクトは次のようになります。

// Effect for the first render (roomId = "general")
() => {
const connection = createConnection('general');
connection.connect();
return () => connection.disconnect();
},
// Dependencies for the first render (roomId = "general")
['general']

React はこのエフェクトを実行し、'general' チャットルームに接続します。

同じ依存値での再レンダー

<ChatRoom roomId="general" /> が再レンダーされるとしましょう。JSX の出力は同じです。

// JSX for the second render (roomId = "general")
return <h1>Welcome to general!</h1>;

React はレンダー出力が変更されていないことを認識するため、DOM を更新しません。

2 回目のレンダーからのエフェクトは以下のようになります。

// Effect for the second render (roomId = "general")
() => {
const connection = createConnection('general');
connection.connect();
return () => connection.disconnect();
},
// Dependencies for the second render (roomId = "general")
['general']

React は 2 回目のレンダーからの ['general'] と、1 回目のレンダーからの ['general'] を比較します。すべての依存値が同じであるため、React は 2 回目のレンダーからのエフェクトを無視します。エフェクトは呼び出されません。

異なる依存値での再レンダー

次に、ユーザが <ChatRoom roomId="travel" /> を訪れます。このとき、コンポーネントは異なる JSX を返します。

// JSX for the third render (roomId = "travel")
return <h1>Welcome to travel!</h1>;

React は DOM を更新して、"Welcome to general""Welcome to travel" に変更します。

3 回目のレンダーからのエフェクトは以下のようになります。

// Effect for the third render (roomId = "travel")
() => {
const connection = createConnection('travel');
connection.connect();
return () => connection.disconnect();
},
// Dependencies for the third render (roomId = "travel")
['travel']

React は 3 回目のレンダーからの ['travel'] と、2 回目のレンダーからの ['general'] を比較します。1 つの依存値が異なります。Object.is('travel', 'general')false です。このエフェクトはスキップできません。

React が 3 回目のレンダーからのエフェクトを適用する前に、最後に実行されたエフェクトをクリーンアップする必要があります。2 回目のレンダーのエフェクトはスキップされたため、React は 1 回目のレンダーのエフェクトをクリーンアップする必要があります。上にスクロールして 1 回目のレンダーを見返すと、そのクリーンアップコードは createConnection('general') で作成された接続に対して disconnect() を呼び出すことがわかります。これにより、アプリは 'general' チャットルームから切断されます。

その後、React は 3 回目のレンダーのエフェクトを実行します。これにより、'travel' チャットルームに接続されます。

アンマウント

最後に、ユーザがページから出て、ChatRoom コンポーネントがアンマウントされるとしましょう。React は最後のエフェクトのクリーンアップ関数を実行します。最後のエフェクトは 3 回目のレンダーからのものでした。3 回目のレンダーのクリーンアップは、createConnection('travel') の接続を破棄します。そのため、アプリは 'travel' ルームから切断されます。

開発環境専用の挙動

Strict Mode がオンの場合、React はマウント後にすべてのコンポーネントを一度再マウントします(state と DOM は保持されます)。これは、クリーンアップが必要なエフェクトを見つけるのに役立ちますし、競合状態 (race condition) のようなバグが早期に見つかるようにもします。さらに、React は開発中にあなたがファイルを保存するたびにエフェクトを再マウントします。これらの挙動は開発環境でのみ起こります。

まとめ

  • イベントとは異なり、エフェクトは特定のユーザ操作ではなく、レンダー自体によって引き起こされる。
  • エフェクトを使い、コンポーネントを外部システム(サードパーティ API、ネットワークなど)と同期させることができる。
  • デフォルトでは、エフェクトは毎回のレンダー(初回も含む)の後に実行される。
  • すべての依存値が前回のレンダー時と同じ値である場合、React はエフェクトをスキップする。
  • 依存値は「選ぶ」類のものではない。それはエフェクト内のコードによって決定される。
  • 空の依存配列 ([]) は、コンポーネントが「マウント」される、つまり画面に追加されることに対応する。
  • Strict Mode では、React はコンポーネントを 2 回マウント(開発環境のみ!)して、エフェクトのストレステストを行う。
  • エフェクトが再マウントにより壊れる場合、クリーンアップ関数を実装する必要がある。
  • React は、次のエフェクトが実行される前とアンマウント中に、クリーンアップ関数を呼び出す。

チャレンジ 1/4:
マウント時にフィールドにフォーカス

この例では、フォームが <MyInput /> コンポーネントをレンダーします。

入力フィールドの focus() メソッドを使って、MyInput が画面に表示されたときに自動的にフォーカスが当たるようにしてください。すでにコメントアウトされた実装がありますが、これはうまく動作しません。なぜ動作しないのかを理解し、修正してください。(autoFocus 属性をご存じの場合でも、今はこれが存在しないことにしてください。同じ機能をゼロから再実装しましょう。)

import { useEffect, useRef } from 'react';

export default function MyInput({ value, onChange }) {
  const ref = useRef(null);

  // TODO: This doesn't quite work. Fix it.
  // ref.current.focus()    

  return (
    <input
      ref={ref}
      value={value}
      onChange={onChange}
    />
  );
}

あなたの答えが動作することを確認するには、“Show form” を押して、入力がフォーカスされる(ハイライトされ、カーソルが内部に配置される)ことを確認してください。“Hide form” を押してから再度 “Show form” を押すと、再び入力欄がハイライトされることを確認してください。

MyInput は、毎レンダーごとではなくマウント時にのみフォーカスされる必要があります。この動作が正しいことを確認するには、“Show form” を押してから、“Make it uppercase” チェックボックスを何度か押してみてください。チェックボックスをクリックしても、その上にある入力フィールドにフォーカスが移動しないようにしてください。