JavaScript開発においてバンドルサイズの最適化は、ユーザー体験向上の重要な要素です。
しかし、多くの開発者が見落としているのが「重複モジュール」の問題です。この記事では、JavaScript バンドル内の重複モジュールを効果的に削除する方法を、初心者の方にもわかりやすく解説します。
目次
重複モジュールとは？なぜ発生するのか
重複モジュールの定義と発生原因
重複モジュールとは、同一のJavaScriptコードが複数のバンドルファイルに含まれている状態のことを指します。これは現代のWebアプリケーション開発において、想像以上に頻繁に発生する問題なんです。
主な発生原因は以下の3つです：
1. 同じパッケージからの同一コード 複数のエントリーポイントで同じライブラリを使用している場合、そのライブラリのコードが各バンドルに重複して含まれます。
2. 類似パッケージからの似たコード 機能が似ているパッケージを複数使用している場合、内部的に同じような処理をするコードが重複することがあります。
3. 異なるパッケージからの同一コード 異なるパッケージが内部的に同じユーティリティ関数を持っている場合、それらが重複してバンドルに含まれます。
重複モジュールがパフォーマンスに与える影響
重複モジュールは以下のような深刻な問題を引き起こします：
- ダウンロード時間の増加：同じコードを複数回ダウンロードすることで、初期読み込み時間が大幅に増加
- メモリ使用量の増加：ブラウザが同じコードを複数回解析・実行することで、メモリ効率が悪化
- キャッシュ効率の低下：共通コードを分離できていないため、キャッシュを効果的に活用できない
実際の例を見てみましょう。例えば、jQueryを使用する2つのページがあった場合：
Copy// page1.js
import $ from 'jquery';
import velocity from 'velocity-animate';
// ページ1固有の処理
// page2.js
import $ from 'jquery';
import velocity from 'velocity-animate';
// ページ2固有の処理
この場合、jQueryとvelocity-animateのコードが両方のバンドルに含まれ、全体のファイルサイズが大幅に増加してしまいます。
Webpackを使用した重複モジュールの削除方法
optimization.splitChunksの基本設定
Webpack 4以降では、optimization.splitChunksという強力な機能が提供されています。この機能を使用することで、共通モジュールを効率的に分離できます。
基本的な設定は以下の通りです：
Copy// webpack.config.js
const path = require('path');
module.exports = {
entry: {
app: './src/js/app.js',
app2: './src/js/app2.js',
app3: './src/js/app3.js',
},
output: {
filename: '[name].bundle.js',
path: path.join(__dirname, 'public/js'),
},
optimization: {
splitChunks: {
name: 'vendor',
chunks: 'initial',
}
}
};
この設定により、複数のエントリーポイント間で共通して使用されているモジュールが自動的にvendor.bundle.jsとして分離されます。
詳細な設定オプション
より細かい制御を行いたい場合は、以下のようにcacheGroupsを使用します：
Copyoptimization: {
splitChunks: {
cacheGroups: {
vendor: {
test: /node_modules/,
name: 'vendor',
chunks: 'initial',
enforce: true
},
common: {
test: /src\/js\/common/,
name: 'common',
chunks: 'initial',
enforce: true
}
}
}
}
この設定では：
node_modules配下のモジュールはvendor.bundle.jsにsrc/js/common配下のモジュールはcommon.bundle.jsに
それぞれ分離されます。
実際の効果測定
optimization.splitChunksを適用した場合の効果を見てみましょう：
適用前：
app.bundle.js 131 KiB
app2.bundle.js 131 KiB
app3.bundle.js 991 bytes
合計: 約263 KiB
適用後：
vendor.bundle.js 130 KiB
app.bundle.js 1.57 KiB
app2.bundle.js 1.57 KiB
app3.bundle.js 991 bytes
合計: 約134 KiB
なんと、全体のファイルサイズが約50%削減されました！
Tree Shakingによる未使用コードの削除
Tree Shakingの基本概念
Tree Shakingは、使用されていないコードを自動的に削除する機能です。これにより、必要なコードのみをバンドルに含めることができます。
効果的なTree Shakingを実現するには、以下の条件が必要です：
- ES6モジュールの使用
Copy// 良い例：名前付きインポート
import { unique, implode, explode } from "array-utils";
// 悪い例：全体インポート
import * as arrayUtils from "array-utils";
- Babelの適切な設定
Copy// babel.config.js
export default {
presets: [
[
"@babel/preset-env", {
modules: false // 重要：ES6モジュールを保持
}
]
]
}
- package.jsonでのsideEffects設定
Copy{
"name": "your-project",
"sideEffects": false
}
Tree Shakingの実践例
実際の効果を確認してみましょう。以下のようなutils.jsファイルがあった場合：
Copy// utils.js
export function simpleSort(array, key, order) {
// ソート処理
}
export function complexCalculation(data) {
// 複雑な計算処理（使用されていない）
}
export function formatDate(date) {
// 日付フォーマット処理（使用されていない）
}
アプリケーションでsimpleSortのみを使用している場合：
Copy// app.js
import { simpleSort } from './utils/utils';
// simpleSort のみを使用
json = simpleSort(json, "model", this.state.sortOrder);
Tree Shakingが適切に機能すれば、complexCalculationとformatDateはバンドルから除外され、大幅なサイズ削減が期待できます。
重複モジュール検出ツールの活用
webpack-bundle-analyzerの使用
重複モジュールを視覚的に確認するには、webpack-bundle-analyzerが非常に有効です。
Copynpm install --save-dev webpack-bundle-analyzer
Copy// webpack.config.js
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
module.exports = {
plugins: [
new BundleAnalyzerPlugin({
analyzerMode: 'static',
openAnalyzer: false,
reportFilename: 'bundle-report.html'
})
]
};
このツールを使用することで、バンドル内のモジュール構成を詳細に把握し、重複箇所を特定できます。
webpack-stats-duplicatesの活用
より専門的な重複検出には、webpack-stats-duplicatesが効果的です：
Copynpm install --save-dev webpack-stats-duplicates
Copyconst WebpackStatsDuplicates = require('webpack-stats-duplicates');
// webpack 統計情報を解析
const duplicates = new WebpackStatsDuplicates(stats);
console.log(duplicates.getReport());
GTmetrixでの重複モジュール検出
GTmetrixは、Webサイトのパフォーマンスを総合的に評価するツールですが、JavaScript重複モジュールの検出機能も提供しています。
重複モジュールによる無駄な帯域幅が1KB以上の場合、この監査が実行されます。検出された重複モジュールは、具体的な削減可能サイズとともに表示されるため、優先度の高い最適化ポイントを特定できます。
Rollupでの重複モジュール対策
Rollupの基本設定
Rollupは、ES6モジュールシステムを前提として設計されたバンドラーで、標準でTree Shakingが効率的に動作します。
Copy// rollup.config.js
import { nodeResolve } from '@rollup/plugin-node-resolve';
import commonjs from '@rollup/plugin-commonjs';
import { terser } from 'rollup-plugin-terser';
export default {
input: 'src/main.js',
output: {
file: 'dist/bundle.js',
format: 'iife',
name: 'MyApp'
},
plugins: [
nodeResolve(),
commonjs(),
terser()
],
external: ['react', 'lodash'] // 外部依存として除外
};
peer dependencies の活用
Rollupでの重複排除には、rollup-plugin-peer-deps-externalが有効です：
Copyimport peerDepsExternal from 'rollup-plugin-peer-deps-external';
export default {
plugins: [
peerDepsExternal(), // 重複した依存関係を削除
// その他のプラグイン
]
};
最新のツールとベストプラクティス
ViteとRollupの組み合わせ
最新の開発環境では、ViteとRollupを組み合わせることで、開発時のパフォーマンスと本番環境での最適化を両立できます。
Copy// vite.config.js
import { defineConfig } from 'vite';
export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks: {
vendor: ['react', 'react-dom'],
utils: ['lodash', 'moment']
}
}
}
}
});
ESBuildの活用
ESBuildは、Go言語で書かれた高速なJavaScriptバンドラーです。重複モジュールの削除において、以下のような利点があります：
Copy// esbuild.config.js
const esbuild = require('esbuild');
esbuild.build({
entryPoints: ['src/app.js'],
bundle: true,
outfile: 'dist/bundle.js',
external: ['react', 'lodash'], // 外部モジュールとして除外
treeShaking: true, // Tree Shakingを有効化
minify: true
});
実践的な最適化戦略
段階的な最適化アプローチ
- 現状分析
- webpack-bundle-analyzerで現在の状況を把握
- 重複モジュールの特定と影響度評価
- 基本的な最適化
- optimization.splitChunksの導入
- Tree Shakingの有効化
- 詳細な調整
- cacheGroupsの細かい設定
- 外部依存関係の最適化
- 継続的な監視
- 定期的なバンドル分析
- パフォーマンス指標の追跡
ファイルサイズ削減の実例
実際のプロジェクトでの改善例を見てみましょう：
改善前：
- メインバンドル: 2.1MB
- 重複モジュール: 890KB
- 初期読み込み時間: 8.5秒
改善後：
- メインバンドル: 1.2MB
- 共通チャンク: 450KB
- 初期読み込み時間: 3.2秒
約60%のパフォーマンス向上を達成できました。
LandingHubでの表示速度最適化
LandingHubの特徴
LandingHubは、表示速度の最適化に特化したランディングページ作成プラットフォームです。JavaScript重複モジュールの削除をはじめとする、様々な最適化手法が標準で組み込まれています。
自動最適化機能
LandingHubでは、以下の最適化が自動で実行されます：
- 自動バンドル分割：共通モジュールの自動検出と分離
- Tree Shakingの最適化：未使用コードの自動削除
- レイジーローディング：必要に応じたモジュールの動的読み込み
開発者向けの高度な機能
技術的なカスタマイズが必要な場合でも、LandingHubは以下の機能を提供します：
- カスタムバンドル設定：独自の最適化ルールの設定
- パフォーマンス監視：リアルタイムでの表示速度計測
- A/Bテスト機能：最適化効果の定量的評価
まとめ：継続的な最適化の重要性
JavaScript バンドル内の重複モジュールの削除は、Webアプリケーションのパフォーマンス向上において極めて重要な施策です。本記事で紹介した手法を組み合わせることで、大幅なファイルサイズ削減と読み込み速度の改善を実現できます。
重要なポイントを振り返ると：
- 現状把握：適切なツールを使用して重複モジュールを特定
- 基本設定：webpack の optimization.splitChunks を適切に設定
- Tree Shaking：未使用コードの削除を確実に実行
- 継続的監視：定期的なパフォーマンス測定と改善
特に、初心者の方が陥りやすい落とし穴として、設定はしたものの効果を測定していない、というケースがあります。必ず実際の数値で効果を確認し、継続的な改善を心がけてください。
表示速度の最適化は、ユーザー体験の向上だけでなく、SEO効果やコンバージョン率の改善にも直結します。この記事の内容を参考に、ぜひ実践してみてください。
より専門的な最適化や、包括的な表示速度改善をお求めの場合は、LandingHubのような専門プラットフォームの活用も検討してみてください。自動最適化機能により、技術的な詳細を意識することなく、最適なパフォーマンスを実現できます。
