React と TypeScript
状態は一箇所に
すべての値には、所有者が1つだけであるべきです。React のバグの大半は、同じ事実について2つのコピーが食い違うことで発生します。
格納する代わりに導出してください。もし値を props と state からレンダリング中に計算できるなら、計算してください — useState にミラーリングしないでください。なぜなら、コピーは元のソースが変わった瞬間に古くなるからです。const total = items.reduce(...) は state を必要とせず、決して間違うことはありません。
prop からコピーした state は、同じバグがより長いヒューズを持つだけです:useState の初期値は一度だけ読み取られ、その後は永遠に無視されます。コンポーネントが prop の変更時にリセットされる必要があるなら、key を与えて React に再マウントさせてください。
状態のリフトは、それを必要とする最も近い共通の親までの範囲にとどめてください。それ以上リフトすると、すべての兄弟がキーストロークごとに再レンダリングされます。
エフェクト
エフェクトは React の外部との何かと同期します:サブスクリプション、タイマー、ドキュメント、命令型ライブラリ。値を計算したりクリックに応答するための場所ではありません — それはイベントハンドラの役割です。
依存配列には、エフェクトが読み取るものをすべてリストアップしなければなりません。ループを止めるために値を省略すると、その値は最初の値で固定され、クロージャの値が古くなるバグ(stale-closure bug)が発生します。エフェクトがループする原因が、依存関係としてレンダリングごとに再作成されるオブジェクトや関数にある場合は、依存関係を修正してください — useCallback、useMemo、またはコンポーネントの外に移動する — 配列から削除するのではなく。
エフェクトがコンポーネントより長く生存する可能性のあるものを開始する場合は、必ずクリーンアップ関数を返してください。サブスクリプション、タイマー、進行中のリクエストはすべて、コンポーネントがアンマウントされるか依存関係が変更されたときに停止する必要があります。また、開発モードの StrictMode では、エフェクトは2回実行されることで、特にクリーンアップの欠落を露呈させます。
async 関数はエフェクトの本体になれません — プロミスを返すため、React はクリーンアップ関数を期待します。非同期の処理は内部で宣言して呼び出してください。
データフェッチ
エフェクト内での手動フェッチよりも、プロジェクトのデータライブラリを優先してください。キャッシュ、重複排除、リトライ、そしてあなたがまさに書きそうな競合状態をすでに解決してくれています。
手動でフェッチする場合は、ローディング、空、エラー、成功の4つの状態すべてを処理し、クリーンアップ時にリクエストをキャンセルしてください。順番に開始された2つのリクエストが順不同で解決される可能性があるため、前のリクエストを中止するか、もはや最新でないレスポンスを無視してください。
拒否(rejection)を飲み込まないでください。ハンドラやエフェクト内で未処理の拒否は、静かに失敗し、UI は単に更新を停止します。
レンダリング
リストには、データから安定した ID をキーとして使用してください。インデックスキーは、並べ替え、挿入、削除が決して行われないリストでのみ正しく動作します。そうでない場合、React は間違った DOM ノードを再利用し、入力は前の行の値を保持します。
memo、useMemo、useCallback は、プロファイラで計測した後に使用してください。デフォルトですべてに適用すると、アロケーションと誤った依存配列が追加され、問題を解決できません。本当のコストが親がツリー全体を再レンダリングすることである場合、これらは何も解決しません。
フックを条件付きで、ループ内で、または早期リターンの後で呼び出さないでください。フックの呼び出し順序は、すべてのレンダリングで同一でなければなりません。
TypeScript
any と型アサーションは、修正ではなく未解決の質問として扱ってください。どちらも、コンパイラが有用なことを言おうとしていたまさにその場所で、それを黙らせます。型が本当に不明な場合は、unknown を使用して絞り込んでください。
境界を越えるものに型を付けましょう:API レスポンス、フォームの値、URL パラメータ。ネットワークからのデータは、何かがチェックするまでは宣言した型ではありません。そのため、境界でバリデーションし、アプリの残りの部分はその結果を信頼できるようにしてください。
検証
グリーンビルドは見た目ほど確かな証拠にはなりません。多くのプロジェクトは、ビルド中に lint や型エラーを無視するようにフレームワークを構成しているため、ビルドを証拠として扱う前に設定を確認し、型チェックとリンターを明示的に実行してください。
その後、コンポーネントを使用してください:空の状態、エラー状態、低速なネットワーク、そして最初の操作が完了する前の2回目の素早い操作もテストしてください。