Next.jsビルドへesbuild-loaderを適用しビルドを高速化を実現する方法
この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。
Next.jsのビルドへesbuild-loaderを適応してビルド速度を5%の高速化を実現したためメモしました。
経緯
ビルド時間の高速化をはかりたく試してみたところ改善することが出来たため 導入することにしました。
環境
- Next.js 7.0
- TypeScript 3.0.3
- NodeJS 14.17.1
改善結果
先に改善結果から共有します。
現在のビルド時間
zsh$ time yarn build
yarn run v1.22.10
$ NODE_ENV=production next build src
// 中略
✨ Done in 88.85s.
yarn build 92.51s user 3.76s system 107% cpu 1:29.19 total
5回実施した平均値
変更前
5回実施して平均は92.97sでした。
| 回数 | ビルド速度 |
|---|---|
| 1 | 92.51s |
| 2 | 94.69s |
| 3 | 89.26s |
| 4 | 95.16s |
| 5 | 93.24s |
| 平均 | 92.97s |
変更後
5回実施して平均は87.63sでした。
| 回数 | ビルド速度 |
|---|---|
| 1 | 86.32s |
| 2 | 92.55s |
| 3 | 80.49s |
| 4 | 90.17s |
| 5 | 88.64s |
| 平均 | 87.63s |
約5%のビルド速度の改善効果が得られました。
esbuild-loaderの導入
esbuild-loaderパッケージのインストール
esbuild-loaderパッケージをインストールします。
zsh$ yarn add -D esbuild-loader
next.config.jsの変更
現状について
Next.jsバージョン7系のプロジェクトでTypeScriptを利用しています。
next.config.js
next.config.jsのwebpackの設定です。
javascript# next.config.js
module.exports = withTypescript({
webpack(config, options) {
config.plugins.push(new webpack.EnvironmentPlugin(process.env));
if (options.isServer) {
config.plugins.push(
new ForkTsCheckerWebpackPlugin({
tsconfig: path.resolve("./tsconfig.json"),
memoryLimit: 1024
})
);
}
if (process.env.NODE_ENV && process.env.NODE_ENV === "production") {
config.optimization.minimize = true;
config.optimization.minimizer = [
new TerserPlugin({
terserOptions: {
compress: { drop_console: true }
},
extractComments: "all"
})
];
}
return config;
}
})
変更後
useEsbuildLoaderを追加して読み込んでいます。
javascript# next.config.js
function useEsbuildLoader(config, options) {
const jsLoader = config.module.rules.find(
rule => rule.test && rule.test.test(".js")
);
if (jsLoader) {
jsLoader.use.loader = "esbuild-loader";
jsLoader.use.options = options;
}
}
module.exports = withTypescript({
webpack(config, options) {
config.plugins.push(new webpack.EnvironmentPlugin(process.env));
config.plugins.push(
new webpack.ProvidePlugin({
React: "react"
})
);
useEsbuildLoader(config, {
loader: "tsx",
target: "es2017"
});
if (options.isServer) {
config.plugins.push(
new ForkTsCheckerWebpackPlugin({
tsconfig: path.resolve("./tsconfig.json"),
memoryLimit: 1024
})
);
}
if (process.env.NODE_ENV && process.env.NODE_ENV === "production") {
config.optimization.minimize = true;
config.optimization.minimizer = [
new TerserPlugin({
terserOptions: {
compress: { drop_console: true }
},
extractComments: "all"
})
];
}
return config;
}
})
tsconfig.jsonの追記
tsconfig.jsonへ下記オプションを追加します。
json# tsconfig.json
"isolatedModules": true,
"esModuleInterop": true
その他
未サポート
tsconfigの下記のオプションはサポートされていないようです。
- emitDecoratorMetadata
- TSの型情報に依存した出力が必要なため
- const enum
- コンパイル時に普通の enum に変換される
ESBuildMinifyPlugin
TerserPlugin→ESBuildMinifyPluginを試したのですがビルド時に下記のエラーのため
適応できませんでした。
追加したwebpackの設定
javascript# next.config.js
config.optimization.minimize = true;
config.optimization.minimizer = [new ESBuildMinifyPlugin()];
ビルド実行
ビルド実行時に下記エラー
consoleTypeError: compilation.getAssets is not a function
webpack5系へ変更
webpackのバージョンが古いためエラーが出ているケースがある記事を参考にwebpackを最新にしてみましたが下記エラーが発生しました。
consoleTypeError: Cannot read property 'get' of undefined
引き続きエラーの原因調査し解決したら記事にしようと思います。
エラーを修正してESBuildMinifyPluginへ置き換えられるともう少し早くなりそうです。
参考文献
Github
esbuild-loader-examples/examples/next at master · privatenumber/esbuild-loader-examples
esbuild 公式
articleNext.js の キャッシュ無効化設計:タグ・パス・スケジュールの 3 軸でコントロール
articleNext.js Metadata API 逆引き:`robots`/`alternates`/`openGraph`/`twitter` の記入例
articleNext.js を Bun で動かす開発環境:起動速度・互換性・落とし穴
articleNext.js Edge Runtime vs Node Runtime:TTFB・コールドスタート・コストを実測検証
articleNext.js の Route Handlers で multipart/form-data が受け取れない問題の切り分け術
articleNext.js Server Components 時代のデータ取得戦略:fetch キャッシュと再検証の新常識
articleWebSocket Close コード早見表:正常終了・プロトコル違反・ポリシー違反の実務対応
articleStorybook 品質ゲート運用:Lighthouse/A11y/ビジュアル差分を PR で自動承認
articleWebRTC で高精細 1080p/4K 画面共有:contentHint「detail」と DPI 最適化
articleSolidJS フォーム設計の最適解:コントロール vs アンコントロールドの棲み分け
articleWebLLM 使い方入門:チャット UI を 100 行で実装するハンズオン
articleShell Script と Ansible/Make/Taskfile の比較:小規模自動化の最適解を検証
blogiPhone 17シリーズの発表!全モデルiPhone 16から進化したポイントを見やすく整理
blogGoogleストアから訂正案内!Pixel 10ポイント有効期限「1年」表示は誤りだった
blog【2025年8月】Googleストア「ストアポイント」は1年表記はミス?2年ルールとの整合性を検証
blogGoogleストアの注文キャンセルはなぜ起きる?Pixel 10購入前に知るべき注意点
blogPixcel 10シリーズの発表!全モデル Pixcel 9 から進化したポイントを見やすく整理
blogフロントエンドエンジニアの成長戦略:コーチングで最速スキルアップする方法
review今の自分に満足していますか?『持たざる者の逆襲 まだ何者でもない君へ』溝口勇児
reviewついに語られた業界の裏側!『フジテレビの正体』堀江貴文が描くテレビ局の本当の姿
review愛する勇気を持てば人生が変わる!『幸せになる勇気』岸見一郎・古賀史健のアドラー実践編で真の幸福を手に入れる
review週末を変えれば年収も変わる!『世界の一流は「休日」に何をしているのか』越川慎司の一流週末メソッド
review新しい自分に会いに行こう!『自分の変え方』村岡大樹の認知科学コーチングで人生リセット
review科学革命から AI 時代へ!『サピエンス全史 下巻』ユヴァル・ノア・ハラリが予見する人類の未来