Lighthouseの未使用JavaScript警告を、3つの手法すべてで削減できなかった記録
著者: ClaudeMix Team |
未使用CSSの削減に成功した手法をJavaScriptに適用したが、3つの手法すべてで未使用JavaScript39 KiBを削減できなかった。
① やったこと
Before: Lighthouseで「使用していないJavaScript: 39 KiB」の警告が出ていた。BlogHeaderやNavigationMenu等の共通コンポーネントが、全ルートで共有バンドルとして自動生成されていた。
// app/routes/blog.posts.tsx(変更前)
import { PostsSection } from "~/components/blog/posts/PostsSection";After: lazy loading・manual chunk splitting・prefetch無効化の3手法を順に試したが、いずれも39 KiBから変化しなかった。
// app/routes/blog.posts.tsx(試行: lazy loading。効果なし)
const PostsSection = lazy(() =>
import("~/components/blog/posts/PostsSection").then((m) => ({ default: m.PostsSection })),
);// vite.config.ts(試行: manual chunk splitting。効果なし)
export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks: (id) => {
if (id.includes("/components/blog/common")) return "blog-common";
},
},
},
},
});ビルドログを確認すると、個別に分割したチャンクもRemixによって共有バンドルへ自動的にマージされており、3手法とも数値に影響しなかった。最終的に、この分割設定は撤回し、デフォルトの共有バンドル戦略をそのまま採用する状態に戻した。
② 設計判断
- 【優先した価値】: Remix/Viteの共有バンドル戦略(ルート間のコード重複を防ぐ全体最適化設計)を尊重すること
- 【犠牲にした価値】: 個別ルートの未使用JavaScriptを削減するという、目に見える数値改善の機会。39 KiBは削減せず残す判断をした
③ 技術的負債
- 【解消した負債】: 「なぜ39 KiBが消せないのか」という原因不明の調査コスト。実測: 試行した削減手法の数 3種類(lazy loading・manual chunk splitting・prefetch無効化)を検証し尽くした上で、Remixの共有バンドル戦略という結論に到達し、以降の見当違いな再試行を防止した
- 【新たに生まれた負債】: 未使用JavaScript39 KiBが技術的負債として残存する。Remixのバンドル戦略が変わらない限り、個別ルートでの削減はできない
④ 経営翻訳
共有の什器・備品を複数の部門が相乗りで使う制度になっており、ある一部門だけがその中の不要な備品を処分しようとしている状況に相当する。
実際には不要備品の量は全く変わらず、39 KiB相当のまま残った。共有制度の設計上、一部門だけを対象にした処分ができなかった。
この「39 KiBは削減しない」という判断を経て、当時導入していた機能追加後のスコア変化を体系的に調査した記録は過去に導入していた認証機能がLighthouseスコアに与えた影響の実測記録にまとめている。
共有の什器・備品を複数の部門が相乗りで使う制度になっており、ある一部門だけがその中の 不要な備品を処分しようと、3つの異なる処分手続きを順番に試している。
その部門が抱える不要備品の量: 39 KiB相当