modulepreloadは何を優先したのか:発見コストをビルド時に前払いするという価値選択
<link rel="modulepreload"> は、JSモジュールの依存解決をブラウザの実行時発見からHTMLでの事前宣言へ前倒しすることを優先している。
① modulepreloadは何を優先したか
一般的なコード分割済みのアプリでは、ブラウザはJSを実行しながら次に必要なチャンクを発見する。entry.js を実行して初めて「reactが必要」と分かり、fetchが始まる。react-routerが必要だと分かるのはreactの実行後だ。各fetchは前のモジュールの実行を待つ、直列のウォーターフォールになる。
modulepreload はこの「実行しながら発見する」を、HTMLに全チャンクのURLを事前宣言する方式へ置き換える。HTMLが届いた瞬間、JSを一行も実行する前に全チャンクの並列fetchが始まる。
- 【優先した価値】: レンダリングの透明性と並列化の確実性。何が必要かをHTMLという最初の文書で宣言し、JSの実行タイミングに依存しない
- 【犠牲にした価値】: フレームワークへの委譲とビルドの単純さ。chunk URLにはハッシュが含まれるため手書きできず、マニフェストから抽出する仕組みが必要になる
② ClaudeMixでやったこと
Before: ビルド設定に modulepreload 関連の処理は存在せず、React Routerが内部で注入する分のみに依存していた。
// app/root.tsx(現状)
export const links: LinksFunction = () => [
// CSS・フォントpreloadのみ
];After: 実装を見送り、現状を維持することにした。理由を確認するため、Viteのビルドマニフェスト(build/client/.vite/manifest.json)とLighthouseのウォーターフォールチャートを確認した。
// build/client/.vite/manifest.json(vendor chunk確認用に参照した箇所)
{
"app/root.tsx": {
"file": "assets/root-xyz789.js",
"isEntry": true,
"imports": ["_vendor-react-abc123.js", "_vendor-react-router-def456.js"]
}
}vendor chunkは react・react-router・フォームバリデーションのみで、marked(Markdownパーサー)と shiki(シンタックスハイライター)は .server.ts ファイルに閉じておりクライアントに送られていない。ウォーターフォールチャートで問題になるレベルの直列待機は観測されなかった。
③ 技術的負債
- 【解消した負債】: なし(未導入のため発生していない)
- 【新たに生まれた負債(あれば)】: なし。ただしLPにアニメーションライブラリを導入したとき、ブログにコードエディター等のインタラクティブなクライアントJSを追加したとき、あるいはLighthouseのWaterfallで直列パターンが観測されたときは、この判断を再評価する必要がある
本文から独立に数え直せる定量値が存在しない(「ウォーターフォールを確認したが直列待機は観測されなかった」という定性的な確認結果のみ)ため、実測値による比較は行わない。
④ 経営翻訳
各部署が必要な資材を発注のたびに個別に確認し取り寄せる体制と、あらかじめ全部署分の資材リストを事前に共有しておく体制、どちらを取るかという選択に相当する。現在の部署数と発注量では、個別確認のままでも待ち時間の問題は表面化していない。資材リストの事前共有を今すぐ整備するコストに見合う効果が、今のところ確認できていない。
将来、扱う資材の種類が増え、発注のたびに待ち時間が発生するようになった時点で、事前共有の体制に切り替える判断にした。