深掘り– category –
**本線を一周した人向け。** roadmap.sh のコースを1つ選んで、その中を細かく潰していく記録。**順路ではありません。** 必要になったコースだけ読んでください。
-
Kubernetes 深掘り
ConfigMapとSecret — Secretは暗号化ではない
設定と秘密情報をどこに置くかの回です。まずConfigMapを3通り(環境変数に1つずつ・envFromでまとめて・ファイルとしてマウント)で渡し、値を書き換えて「環境変数は反映されない・ファイルは反映される」を実際に見ます。次にSecretを作って kubectl get secret -o yaml を開き、base64をデコードして平文が出るところまでやります。Secretは暗号化ではなく符号化で、etcdの中でも既定では平文です。ではどう守るのかを、権限で絞る・Gitに入れない・誰が読んだか記録する、の3つに分けて書きます。値はすべてダミーです。 -
React 深掘り
UIライブラリとヘッドレスUI — 自作モーダルはEscで閉じない
モーダルを自分で書くと、10行で「開いて閉じる」ところまでは動く。ところがEscキーで閉じず、開いてもフォーカスが移らず、Tabで後ろの画面へ抜けていく。足りないものを7項目のチェックリストにして1つずつ数え、まずブラウザ標準の と showModal で5つを消す。残った2つを埋めるためにヘッドレスUI(見た目を持たず、振る舞いとアクセシビリティだけを提供するライブラリ)を1つ入れて、同じモーダルをもう一度作る。全部入り・ヘッドレス・コピーして使う、の3分類と向き不向き、そして入れる前に確認する5項目まで。~/reactlab をポート5185で新しく作り、最後に消します。 -
React 深掘り
Reactのテスト — 実装を直すたびに落ちる
テストを書いたのに、アプリを直すたびにテストが落ちる。壊れているのはアプリではなくテストのほうで、原因は「実装を見ている」ことにある。この記事では ~/reactlab をポート5187で新しく作り、まず悪い書き方(stateの中身を見る・クラス名で要素を探す)と良い書き方を並べて原則を決める。そのうえで Vitest + React Testing Library + jsdom を設定全文つきで入れ、要素の探し方の優先順位(getByRole が最初、getByTestId が最後)、getBy/queryBy/findBy の使い分け、userEvent での操作、findBy と waitFor での待ち方をひとつずつ動かす。さらに fetch をモックする方法の限界を実際に踏んでから MSW でネットワーク層を差し替え、何をテストして何をしないかの判断表と Playwright との住み分けまでやる。 -
React 深掘り
状態管理ライブラリ — 入れる前に大半は要らなかった
「Reactには状態管理ライブラリが必須」と読んで入れたが、実際に必要だったのは一部だけだった。まず状態を「サーバーのデータ / URLの状態 / フォームの入力 / 本当のクライアント状態」の4つに分け、それぞれ担当する道具が違うことを表で確かめる。多くの人がライブラリを欲しがっているものの大半はサーバーのデータで、そこはQueryの担当。URLの状態はURLに置く。残るのはテーマ・サイドバーの開閉・通知・認証情報くらいで、驚くほど少ない。そのうえで ~/reactlab をポート5186で新しく作り、Contextで作ったものを Zustand に置き換えて、「使っている値だけで再描画される」ことを再描画の回数で数える。Redux Toolkit・Jotai・MobX の性格の違い、入れる前のチェック、入れたあとに増える仕事まで。 -
React 深掘り
エラー境界 — 例外1つで画面が真っ白
コンポーネントが1つ例外を投げただけで、関係のない部分まで消えて画面が真っ白になる。これは事故ではなくReact 16以降の仕様で、壊れた画面を出し続けるより全部消すほうが安全だという判断の結果。~/reactlab をポート5183で新しく作り、わざとthrowするコンポーネントで真っ白を再現し、開発サーバーと本番ビルド(npm run build + preview)で見え方がまるで違うことを確かめる。そのうえでエラー境界を自作する。Reactで唯一クラスコンポーネントが必要な場所で、getDerivedStateFromErrorとcomponentDidCatchの役割分担、どこに置くか(細かく置く/全体に1つ)の比較、境界が捕まえない4つ(イベントハンドラ・非同期・サーバー側・境界自身)をそれぞれ実演して確認する。後半はlazy + Suspenseでコード分割し、fallbackが出るところをネットワークを絞って見て、ErrorBoundaryと組み合わせる。データ取得のSuspenseには対応したライブラリが要ることまで。 -
React 深掘り
Reactのスタイリング — CSSの当て方を1つに決める
Reactには「CSSはこう当てる」という標準が無い。だから調べるほど選択肢が増えて、決まらないまま4種類が混ざったプロジェクトができあがる。この記事では同じボタンを、素のCSSファイル・CSS Modules・インラインスタイル・Tailwind の4通りで実際に書き、クラス名の衝突を目の前で起こし、CSS Modules が名前を変える様子を開発者ツールで確認し、インラインスタイルでは :hover もメディアクエリも書けないことを確かめる。さらに style={{}} が毎回新しいオブジェクトを作って再描画を増やすことを、再描画の回で使った数え方でそのまま数える。動的な値はクラスの切り替えかCSS変数へ流し込むのが正解で、クラス名を文字列で組み立てるのは壊れる。最後に「小さい/チーム/デザインシステムがある/パフォーマンス重視」の判断表を作り、決めたら混ぜない、という結論まで持っていく。 -
React 深掘り
条件分岐の書き方 — 三項演算子が5段ネストした
画面に条件を足していったら、&& と三項演算子が5段ネストして、閉じ括弧の対応が誰にも読めなくなった。まず条件分岐の書き方4つ(&& / 三項 / 早期return / 変数に入れる)の向き不向きを表にして、&& は「出す・出さない」、三項は「AかB」だけに使うと決める。そのうえで ~/reactlab をポート5188で新しく作り、実際に5段ネストを書いてから早期returnに直し、さらにコンポーネントへ切り出して行数を before/after で比べる。次に isLoading・error・data の3つを status ひとつにまとめ、switch で全部の場合を書いて抜けに気づけるようにする。最後にコンポーネントを分ける4つの基準、分けすぎの害、children と名前付きの穴による合成、フラグprops が増えたときの畳み方まで。 -
React 深掘り
useRefの2つの用途 — 中身がnullで落ちる
useRef は名前が1つなのに、まったく違う2つの用途に使われている。①DOM要素への参照と、②再描画を起こさない箱。混ざったまま覚えると、どちらも分からなくなる。この記事では2つを先に表で切り分け、入力欄へのフォーカスで実際に current が null を踏み、なぜ描画の前は null なのかを確かめる。次にカウントを useRef で持って画面が更新されないところを作り、「描画に使う値を入れてはいけない」を体で覚える。さらに ref が props ではないこと、React 19 と forwardRef の違い、useImperativeHandle、要素がついた瞬間に動くコールバック ref までを、~/reactlab をポート5178で新しく作って一つずつ動かす。 -
React 深掘り
データ取得とTanStack Query — 取得コードが200行になる
useEffect + fetch で一覧画面を書いたら、読み込み中・エラー・空・競合状態・再取得・キャッシュの世話で200行になっていた。まず「自分で書くと何が必要になるか」を10項目の表にして数える。そのうえで ~/reactlab をポート5182で新しく作り、Node.js 組み込みの http だけで「わざと遅く、わざと失敗する」練習用APIを立て、同じ画面を TanStack Query で書き直して行数を before/after で比べる。staleTime と gcTime、画面に戻ると再取得する既定の是非、queryKey に引数を入れ忘れて古いデータが出るところ、useMutation と invalidateQueries で登録後に一覧が自動更新されるところ、リトライの既定と retry: false にすべき場合まで。最後に「入れるべきか」の判断と、サーバー側で取るならそもそも要らない話。 -
React 深掘り
カスタムフック — 似ているだけでは共通化しない
「同じような処理が2箇所にあるから共通化しよう」で切り出した自作フックが、結局どこでも使えず、引数だけが増えていった。原因は「見た目が同じ」と「意味が同じ」を取り違えたことにある。この記事では ~/reactlab を新しく作り、切り出してよいものと、よくないものの境目を実物で確かめる。そのうえで useToggle・useLocalStorage・useDebounce の3つを実際に作り、使う側のコードが before/after でどう短くなるかを見る。さらに「同じフックを2箇所で呼んでも状態は共有されない」ことを実演し、返り値を配列にするかオブジェクトにするかの判断基準と、renderHook を使ったテストの書き方までやる。