以前は、webpackでバンドルする際のトレードオフの1つは、バンドル内の各モジュールが個々の関数クロージャでラップされることでした。 これらのラッパー関数は、ブラウザでJavaScriptを実行する速度を低下させました。 これと比較して、Closure CompilerやRollupJSなどのツールは、すべてのモジュールのスコープを1つのクロージャに「ホイスト」または連結し、ブラウザでコードの実行時間を短縮できます。
このプラグインは、webpackで同じ連結動作を有効にします。 デフォルトでは、このプラグインは本番環境のmode
で既に有効になっており、それ以外の場合は無効になっています。 本番環境のmode
最適化をオーバーライドする必要がある場合は、optimization.concatenateModules
オプションをfalse
に設定します。 他のモードで連結動作を有効にするには、ModuleConcatenationPlugin
を手動で追加するか、optimization.concatenateModules
オプションを使用します
new webpack.optimize.ModuleConcatenationPlugin();
この連結動作は、「スコープホイスト」と呼ばれます。
スコープホイストは、ECMAScriptモジュール構文によって specifically に実現される機能です。 このため、webpackは、使用しているモジュールの種類やその他の条件に基づいて、通常のバンドルにフォールバックする場合があります。
この記事で説明されているように、webpack は部分的なスコープホイストを実現しようとします。モジュールを単一のスコープにマージしますが、常にそうできるわけではありません。webpack がモジュールをマージできない場合、代替手段は Prevent と Root の 2 つです。Prevent は、モジュールが独自のスコープに存在する必要があることを意味します。Root は、新しいモジュールグループが作成されることを意味します。次の条件によって結果が決まります。
条件 | 結果 |
---|---|
非 ES6 モジュール | Prevent |
import 以外の方法でインポートされている | Root |
他のチャンクからインポートされている | Root |
複数の他のモジュールグループによってインポートされている | Root |
import() を使用してインポートされている | Root |
ProvidePlugin の影響を受ける、または module を使用している | Prevent |
HMR が受け入れられている | Root |
eval() を使用している | Prevent |
複数のチャンクに存在する | Prevent |
export * from "cjs-module" | Prevent |
以下の疑似 JavaScript は、アルゴリズムを説明しています。
modules.forEach((module) => {
const group = new ModuleGroup({
root: module,
});
module.dependencies.forEach((dependency) => {
tryToAdd(group, dependency);
});
if (group.modules.length > 1) {
orderedModules = topologicalSort(group.modules);
concatenatedModule = new ConcatenatedModule(orderedModules);
chunk.add(concatenatedModule);
orderedModules.forEach((groupModule) => {
chunk.remove(groupModule);
});
}
});
function tryToAdd(group, module) {
if (group.has(module)) {
return true;
}
if (!hasPreconditions(module)) {
return false;
}
const nextGroup = group;
const result = module.dependents.reduce((check, dependent) => {
return check && tryToAdd(nextGroup, dependent);
}, true);
if (!result) {
return false;
}
module.dependencies.forEach((dependency) => {
tryToAdd(group, dependency);
});
group.merge(nextGroup);
return true;
}
webpack CLI を使用する場合、--stats-optimization-bailout
フラグはベイルアウトの理由を表示します。 webpack 設定を使用する場合は、stats
オブジェクトに以下を追加します。
module.exports = {
//...
stats: {
// Display bailout reasons
optimizationBailout: true,
},
};