webpack/lib/node/CommonJsChunkLoadingPlugin.js

118 lines
3.8 KiB
JavaScript
Raw Normal View History

/*
MIT License http://www.opensource.org/licenses/mit-license.php
Author Tobias Koppers @sokra
*/
"use strict";
const RuntimeGlobals = require("../RuntimeGlobals");
const StartupChunkDependenciesPlugin = require("../runtime/StartupChunkDependenciesPlugin");
2023-05-26 02:31:28 +08:00
/** @typedef {import("../Chunk")} Chunk */
/** @typedef {import("../Compiler")} Compiler */
2024-06-11 20:32:02 +08:00
/**
2024-06-11 21:09:50 +08:00
* @typedef {object} CommonJsChunkLoadingPluginOptions
2025-04-16 22:04:11 +08:00
* @property {boolean=} asyncChunkLoading enable async chunk loading
2023-05-26 02:31:28 +08:00
*/
2025-04-23 20:03:37 +08:00
const PLUGIN_NAME = "CommonJsChunkLoadingPlugin";
class CommonJsChunkLoadingPlugin {
2023-05-26 02:31:28 +08:00
/**
2025-04-16 22:04:11 +08:00
* @param {CommonJsChunkLoadingPluginOptions=} options options
2023-05-26 02:31:28 +08:00
*/
2023-05-26 03:29:51 +08:00
constructor(options = {}) {
this._asyncChunkLoading = options.asyncChunkLoading;
}
/**
* Apply the plugin
* @param {Compiler} compiler the compiler instance
* @returns {void}
*/
apply(compiler) {
const ChunkLoadingRuntimeModule = this._asyncChunkLoading
? require("./ReadFileChunkLoadingRuntimeModule")
: require("./RequireChunkLoadingRuntimeModule");
const chunkLoadingValue = this._asyncChunkLoading
? "async-node"
: "require";
new StartupChunkDependenciesPlugin({
chunkLoading: chunkLoadingValue,
asyncChunkLoading: this._asyncChunkLoading
}).apply(compiler);
compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
2025-04-23 20:03:37 +08:00
const globalChunkLoading = compilation.outputOptions.chunkLoading;
/**
* @param {Chunk} chunk chunk
* @returns {boolean} true, if wasm loading is enabled for the chunk
*/
const isEnabledForChunk = (chunk) => {
2025-04-23 20:03:37 +08:00
const options = chunk.getEntryOptions();
const chunkLoading =
options && options.chunkLoading !== undefined
? options.chunkLoading
: globalChunkLoading;
return chunkLoading === chunkLoadingValue;
};
const onceForChunkSet = new WeakSet();
/**
* @param {Chunk} chunk chunk
* @param {Set<string>} set runtime requirements
*/
const handler = (chunk, set) => {
if (onceForChunkSet.has(chunk)) return;
onceForChunkSet.add(chunk);
if (!isEnabledForChunk(chunk)) return;
set.add(RuntimeGlobals.moduleFactoriesAddOnly);
set.add(RuntimeGlobals.hasOwnProperty);
compilation.addRuntimeModule(chunk, new ChunkLoadingRuntimeModule(set));
};
2025-04-23 20:03:37 +08:00
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.ensureChunkHandlers)
.tap(PLUGIN_NAME, handler);
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.hmrDownloadUpdateHandlers)
.tap(PLUGIN_NAME, handler);
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.hmrDownloadManifest)
.tap(PLUGIN_NAME, handler);
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.baseURI)
.tap(PLUGIN_NAME, handler);
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.externalInstallChunk)
.tap(PLUGIN_NAME, handler);
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.onChunksLoaded)
.tap(PLUGIN_NAME, handler);
2025-04-23 20:03:37 +08:00
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.ensureChunkHandlers)
.tap(PLUGIN_NAME, (chunk, set) => {
if (!isEnabledForChunk(chunk)) return;
set.add(RuntimeGlobals.getChunkScriptFilename);
});
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.hmrDownloadUpdateHandlers)
.tap(PLUGIN_NAME, (chunk, set) => {
if (!isEnabledForChunk(chunk)) return;
set.add(RuntimeGlobals.getChunkUpdateScriptFilename);
set.add(RuntimeGlobals.moduleCache);
set.add(RuntimeGlobals.hmrModuleData);
set.add(RuntimeGlobals.moduleFactoriesAddOnly);
});
compilation.hooks.runtimeRequirementInTree
.for(RuntimeGlobals.hmrDownloadManifest)
.tap(PLUGIN_NAME, (chunk, set) => {
if (!isEnabledForChunk(chunk)) return;
set.add(RuntimeGlobals.getUpdateManifestFilename);
});
});
}
}
module.exports = CommonJsChunkLoadingPlugin;