webpack 5.91.0 → 5.92.1

package/lib/HotModuleReplacementPlugin.js

@@ -42,19 +42,28 @@ const {
 	WEBPACK_MODULE_TYPE_RUNTIME
 } = require("./ModuleTypeConstants");
 
+/** @typedef {import("estree").CallExpression} CallExpression */
+/** @typedef {import("estree").Expression} Expression */
 /** @typedef {import("./Chunk")} Chunk */
+/** @typedef {import("./Chunk").ChunkId} ChunkId */
 /** @typedef {import("./Compilation").AssetInfo} AssetInfo */
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("./Module")} Module */
+/** @typedef {import("./Module").BuildInfo} BuildInfo */
 /** @typedef {import("./RuntimeModule")} RuntimeModule */
+/** @typedef {import("./javascript/BasicEvaluatedExpression")} BasicEvaluatedExpression */
+/** @typedef {import("./javascript/JavascriptParserHelpers").Range} Range */
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
 /**
- * @typedef {Object} HMRJavascriptParserHooks
+ * @typedef {object} HMRJavascriptParserHooks
  * @property {SyncBailHook<[TODO, string[]], void>} hotAcceptCallback
  * @property {SyncBailHook<[TODO, string[]], void>} hotAcceptWithoutCallback
  */
 
+/** @typedef {Map<string, { updatedChunkIds: Set<ChunkId>, removedChunkIds: Set<ChunkId>, removedModules: Set<Module>, filename: string, assetInfo: AssetInfo }>} HotUpdateMainContentByRuntime */
+
 /** @type {WeakMap<JavascriptParser, HMRJavascriptParserHooks>} */
 const parserHooksMap = new WeakMap();
 
@@ -82,6 +91,9 @@ class HotModuleReplacementPlugin {
 		return hooks;
 	}
 
+	/**
+	 * @param {object=} options options
+	 */
 	constructor(options) {
 		this.options = options || {};
 	}
@@ -97,6 +109,11 @@ class HotModuleReplacementPlugin {
 			compiler.options.output.strictModuleErrorHandling = true;
 		const runtimeRequirements = [RuntimeGlobals.module];
 
+		/**
+		 * @param {JavascriptParser} parser the parser
+		 * @param {typeof ModuleHotAcceptDependency} ParamDependency dependency
+		 * @returns {(expr: CallExpression) => boolean | undefined} callback
+		 */
 		const createAcceptHandler = (parser, ParamDependency) => {
 			const { hotAcceptCallback, hotAcceptWithoutCallback } =
 				HotModuleReplacementPlugin.getParserHooks(parser);
@@ -105,27 +122,38 @@ class HotModuleReplacementPlugin {
 				const module = parser.state.module;
 				const dep = new ConstDependency(
 					`${module.moduleArgument}.hot.accept`,
-					expr.callee.range,
+					/** @type {Range} */ (expr.callee.range),
 					runtimeRequirements
 				);
-				dep.loc = expr.loc;
+				dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 				module.addPresentationalDependency(dep);
-				module.buildInfo.moduleConcatenationBailout = "Hot Module Replacement";
+				/** @type {BuildInfo} */
+				(module.buildInfo).moduleConcatenationBailout =
+					"Hot Module Replacement";
 				if (expr.arguments.length >= 1) {
 					const arg = parser.evaluateExpression(expr.arguments[0]);
+					/** @type {BasicEvaluatedExpression[]} */
 					let params = [];
-					let requests = [];
 					if (arg.isString()) {
 						params = [arg];
 					} else if (arg.isArray()) {
-						params = arg.items.filter(param => param.isString());
+						params =
+							/** @type {BasicEvaluatedExpression[]} */
+							(arg.items).filter(param => param.isString());
 					}
+					/** @type {string[]} */
+					let requests = [];
 					if (params.length > 0) {
 						params.forEach((param, idx) => {
-							const request = param.string;
-							const dep = new ParamDependency(request, param.range);
+							const request = /** @type {string} */ (param.string);
+							const dep = new ParamDependency(
+								request,
+								/** @type {Range} */ (param.range)
+							);
 							dep.optional = true;
-							dep.loc = Object.create(expr.loc);
+							dep.loc = Object.create(
+								/** @type {DependencyLocation} */ (expr.loc)
+							);
 							dep.loc.index = idx;
 							module.addDependency(dep);
 							requests.push(request);
@@ -147,28 +175,40 @@ class HotModuleReplacementPlugin {
 			};
 		};
 
+		/**
+		 * @param {JavascriptParser} parser the parser
+		 * @param {typeof ModuleHotDeclineDependency} ParamDependency dependency
+		 * @returns {(expr: CallExpression) => boolean | undefined} callback
+		 */
 		const createDeclineHandler = (parser, ParamDependency) => expr => {
 			const module = parser.state.module;
 			const dep = new ConstDependency(
 				`${module.moduleArgument}.hot.decline`,
-				expr.callee.range,
+				/** @type {Range} */ (expr.callee.range),
 				runtimeRequirements
 			);
-			dep.loc = expr.loc;
+			dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 			module.addPresentationalDependency(dep);
-			module.buildInfo.moduleConcatenationBailout = "Hot Module Replacement";
+			/** @type {BuildInfo} */
+			(module.buildInfo).moduleConcatenationBailout = "Hot Module Replacement";
 			if (expr.arguments.length === 1) {
 				const arg = parser.evaluateExpression(expr.arguments[0]);
+				/** @type {BasicEvaluatedExpression[]} */
 				let params = [];
 				if (arg.isString()) {
 					params = [arg];
 				} else if (arg.isArray()) {
-					params = arg.items.filter(param => param.isString());
+					params =
+						/** @type {BasicEvaluatedExpression[]} */
+						(arg.items).filter(param => param.isString());
 				}
 				params.forEach((param, idx) => {
-					const dep = new ParamDependency(param.string, param.range);
+					const dep = new ParamDependency(
+						/** @type {string} */ (param.string),
+						/** @type {Range} */ (param.range)
+					);
 					dep.optional = true;
-					dep.loc = Object.create(expr.loc);
+					dep.loc = Object.create(/** @type {DependencyLocation} */ (expr.loc));
 					dep.loc.index = idx;
 					module.addDependency(dep);
 				});
@@ -176,16 +216,21 @@ class HotModuleReplacementPlugin {
 			return true;
 		};
 
+		/**
+		 * @param {JavascriptParser} parser the parser
+		 * @returns {(expr: Expression) => boolean | undefined} callback
+		 */
 		const createHMRExpressionHandler = parser => expr => {
 			const module = parser.state.module;
 			const dep = new ConstDependency(
 				`${module.moduleArgument}.hot`,
-				expr.range,
+				/** @type {Range} */ (expr.range),
 				runtimeRequirements
 			);
-			dep.loc = expr.loc;
+			dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 			module.addPresentationalDependency(dep);
-			module.buildInfo.moduleConcatenationBailout = "Hot Module Replacement";
+			/** @type {BuildInfo} */
+			(module.buildInfo).moduleConcatenationBailout = "Hot Module Replacement";
 			return true;
 		};
 
@@ -303,7 +348,9 @@ class HotModuleReplacementPlugin {
 				//#endregion
 
 				let hotIndex = 0;
+				/** @type {Record<string, string>} */
 				const fullHashChunkModuleHashes = {};
+				/** @type {Record<string, string>} */
 				const chunkModuleHashes = {};
 
 				compilation.hooks.record.tap(PLUGIN_NAME, (compilation, records) => {
@@ -316,18 +363,20 @@ class HotModuleReplacementPlugin {
 					records.chunkHashes = {};
 					records.chunkRuntime = {};
 					for (const chunk of compilation.chunks) {
-						records.chunkHashes[chunk.id] = chunk.hash;
-						records.chunkRuntime[chunk.id] = getRuntimeKey(chunk.runtime);
+						const chunkId = /** @type {ChunkId} */ (chunk.id);
+						records.chunkHashes[chunkId] = chunk.hash;
+						records.chunkRuntime[chunkId] = getRuntimeKey(chunk.runtime);
 					}
 					records.chunkModuleIds = {};
 					for (const chunk of compilation.chunks) {
-						records.chunkModuleIds[chunk.id] = Array.from(
-							chunkGraph.getOrderedChunkModulesIterable(
-								chunk,
-								compareModulesById(chunkGraph)
-							),
-							m => chunkGraph.getModuleId(m)
-						);
+						records.chunkModuleIds[/** @type {ChunkId} */ (chunk.id)] =
+							Array.from(
+								chunkGraph.getOrderedChunkModulesIterable(
+									chunk,
+									compareModulesById(chunkGraph)
+								),
+								m => chunkGraph.getModuleId(m)
+							);
 					}
 				});
 				/** @type {TupleSet<[Module, Chunk]>} */
@@ -340,6 +389,10 @@ class HotModuleReplacementPlugin {
 					const chunkGraph = compilation.chunkGraph;
 					const records = compilation.records;
 					for (const chunk of compilation.chunks) {
+						/**
+						 * @param {Module} module module
+						 * @returns {string} module hash
+						 */
 						const getModuleHash = module => {
 							if (
 								compilation.codeGenerationResults.has(module, chunk.runtime)
@@ -454,7 +507,7 @@ class HotModuleReplacementPlugin {
 							chunkModuleHashes[key] = hash;
 						}
 
-						/** @type {Map<string, { updatedChunkIds: Set<string|number>, removedChunkIds: Set<string|number>, removedModules: Set<Module>, filename: string, assetInfo: AssetInfo }>} */
+						/** @type {HotUpdateMainContentByRuntime} */
 						const hotUpdateMainContentByRuntime = new Map();
 						let allOldRuntime;
 						for (const key of Object.keys(records.chunkRuntime)) {
@@ -470,13 +523,16 @@ class HotModuleReplacementPlugin {
 										runtime
 									}
 								);
-							hotUpdateMainContentByRuntime.set(runtime, {
-								updatedChunkIds: new Set(),
-								removedChunkIds: new Set(),
-								removedModules: new Set(),
-								filename,
-								assetInfo
-							});
+							hotUpdateMainContentByRuntime.set(
+								/** @type {string} */ (runtime),
+								{
+									updatedChunkIds: new Set(),
+									removedChunkIds: new Set(),
+									removedModules: new Set(),
+									filename,
+									assetInfo
+								}
+							);
 						});
 						if (hotUpdateMainContentByRuntime.size === 0) return;
 
@@ -506,6 +562,7 @@ class HotModuleReplacementPlugin {
 								}
 							}
 
+							/** @type {ChunkId | null} */
 							let chunkId;
 							let newModules;
 							let newRuntimeModules;
@@ -554,9 +611,10 @@ class HotModuleReplacementPlugin {
 							if (removedFromRuntime) {
 								// chunk was removed from some runtimes
 								forEachRuntime(removedFromRuntime, runtime => {
-									hotUpdateMainContentByRuntime
-										.get(runtime)
-										.removedChunkIds.add(chunkId);
+									const item = hotUpdateMainContentByRuntime.get(
+										/** @type {string} */ (runtime)
+									);
+									item.removedChunkIds.add(/** @type {ChunkId} */ (chunkId));
 								});
 								// dispose modules from the chunk in these runtimes
 								// where they are no longer in this runtime
@@ -597,12 +655,16 @@ class HotModuleReplacementPlugin {
 												if (typeof moduleRuntime === "string") {
 													if (moduleRuntime === runtime) return;
 												} else if (moduleRuntime !== undefined) {
-													if (moduleRuntime.has(runtime)) return;
+													if (
+														moduleRuntime.has(/** @type {string} */ (runtime))
+													)
+														return;
 												}
 											}
-											hotUpdateMainContentByRuntime
-												.get(runtime)
-												.removedModules.add(module);
+											const item = hotUpdateMainContentByRuntime.get(
+												/** @type {string} */ (runtime)
+											);
+											item.removedModules.add(module);
 										});
 									}
 								}
@@ -676,9 +738,10 @@ class HotModuleReplacementPlugin {
 									}
 								}
 								forEachRuntime(newRuntime, runtime => {
-									hotUpdateMainContentByRuntime
-										.get(runtime)
-										.updatedChunkIds.add(chunkId);
+									const item = hotUpdateMainContentByRuntime.get(
+										/** @type {string} */ (runtime)
+									);
+									item.updatedChunkIds.add(/** @type {ChunkId} */ (chunkId));
 								});
 							}
 						}

package/lib/IgnorePlugin.js

@@ -28,7 +28,10 @@ class IgnorePlugin {
 		validate(options);
 		this.options = options;
 
-		/** @private @type {Function} */
+		/**
+		 * @private
+		 * @type {Function}
+		 */
 		this.checkIgnore = this.checkIgnore.bind(this);
 	}
 

package/lib/LibManifestPlugin.js

@@ -16,14 +16,14 @@ const { dirname, mkdirp } = require("./util/fs");
 /** @typedef {import("./Module").BuildMeta} BuildMeta */
 
 /**
- * @typedef {Object} ManifestModuleData
+ * @typedef {object} ManifestModuleData
  * @property {string | number} id
  * @property {BuildMeta} buildMeta
  * @property {boolean | string[] | undefined} exports
  */
 
 /**
- * @typedef {Object} LibManifestPluginOptions
+ * @typedef {object} LibManifestPluginOptions
  * @property {string=} context Context of requests in the manifest file (defaults to the webpack context).
  * @property {boolean=} entryOnly If true, only entry points will be exposed (default: true).
  * @property {boolean=} format If true, manifest json file (output) will be formatted.

package/lib/Module.js

@@ -45,7 +45,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
 /**
- * @typedef {Object} SourceContext
+ * @typedef {object} SourceContext
  * @property {DependencyTemplates} dependencyTemplates the dependency templates
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
  * @property {ModuleGraph} moduleGraph the module graph
@@ -56,13 +56,12 @@ const makeSerializable = require("./util/makeSerializable");
 
 // TODO webpack 6: compilation will be required in CodeGenerationContext
 /**
- * @typedef {Object} CodeGenerationContext
+ * @typedef {object} CodeGenerationContext
  * @property {DependencyTemplates} dependencyTemplates the dependency templates
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
  * @property {ModuleGraph} moduleGraph the module graph
  * @property {ChunkGraph} chunkGraph the chunk graph
- * @property {RuntimeSpec} runtime the runtime code should be generated for
- * @property {RuntimeSpec[]} [runtimes] the runtimes code should be generated for
+ * @property {RuntimeSpec} runtime the runtimes code should be generated for
  * @property {ConcatenationScope=} concatenationScope when in concatenated module, information about other concatenated modules
  * @property {CodeGenerationResults | undefined} codeGenerationResults code generation results of other modules (need to have a codeGenerationDependency to use that)
  * @property {Compilation=} compilation the compilation
@@ -70,7 +69,7 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
- * @typedef {Object} ConcatenationBailoutReasonContext
+ * @typedef {object} ConcatenationBailoutReasonContext
  * @property {ModuleGraph} moduleGraph the module graph
  * @property {ChunkGraph} chunkGraph the chunk graph
  */
@@ -79,7 +78,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {ReadonlySet<string>} ReadOnlyRuntimeRequirements */
 
 /**
- * @typedef {Object} CodeGenerationResult
+ * @typedef {object} CodeGenerationResult
  * @property {Map<string, Source>} sources the resulting sources for all source types
  * @property {Map<string, any>=} data the resulting data for all source types
  * @property {ReadOnlyRuntimeRequirements} runtimeRequirements the runtime requirements
@@ -87,13 +86,13 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
- * @typedef {Object} LibIdentOptions
+ * @typedef {object} LibIdentOptions
  * @property {string} context absolute context path to which lib ident is relative to
- * @property {Object=} associatedObjectForCache object for caching
+ * @property {object=} associatedObjectForCache object for caching
  */
 
 /**
- * @typedef {Object} KnownBuildMeta
+ * @typedef {object} KnownBuildMeta
  * @property {string=} moduleArgument
  * @property {string=} exportsArgument
  * @property {boolean=} strict
@@ -106,7 +105,7 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
- * @typedef {Object} KnownBuildInfo
+ * @typedef {object} KnownBuildInfo
  * @property {boolean=} cacheable
  * @property {boolean=} parsed
  * @property {LazySet<string>=} fileDependencies
@@ -121,7 +120,7 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
- * @typedef {Object} NeedBuildContext
+ * @typedef {object} NeedBuildContext
  * @property {Compilation} compilation
  * @property {FileSystemInfo} fileSystemInfo
  * @property {Map<string, string | Set<string>>} valueCacheVersions
@@ -131,7 +130,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {KnownBuildInfo & Record<string, any>} BuildInfo */
 
 /**
- * @typedef {Object} FactoryMeta
+ * @typedef {object} FactoryMeta
  * @property {boolean=} sideEffectFree
  */
 

package/lib/ModuleFactory.js

@@ -10,7 +10,7 @@
 /** @typedef {import("./Module")} Module */
 
 /**
- * @typedef {Object} ModuleFactoryResult
+ * @typedef {object} ModuleFactoryResult
  * @property {Module=} module the created module or unset if no module was created
  * @property {Set<string>=} fileDependencies
  * @property {Set<string>=} contextDependencies
@@ -19,14 +19,14 @@
  */
 
 /**
- * @typedef {Object} ModuleFactoryCreateDataContextInfo
+ * @typedef {object} ModuleFactoryCreateDataContextInfo
  * @property {string} issuer
  * @property {string | null=} issuerLayer
  * @property {string} compiler
  */
 
 /**
- * @typedef {Object} ModuleFactoryCreateData
+ * @typedef {object} ModuleFactoryCreateData
  * @property {ModuleFactoryCreateDataContextInfo} contextInfo
  * @property {ResolveOptions=} resolveOptions
  * @property {string} context

package/lib/ModuleFilenameHelpers.js

@@ -46,11 +46,13 @@ ModuleFilenameHelpers.REGEXP_HASH = /\[hash\]/gi;
 ModuleFilenameHelpers.NAMESPACE = "[namespace]";
 ModuleFilenameHelpers.REGEXP_NAMESPACE = /\[namespace\]/gi;
 
+/** @typedef {() => string} ReturnStringCallback */
+
 /**
  * Returns a function that returns the part of the string after the token
- * @param {() => string} strFn the function to get the string
+ * @param {ReturnStringCallback} strFn the function to get the string
  * @param {string} token the token to search for
- * @returns {() => string} a function that returns the part of the string after the token
+ * @returns {ReturnStringCallback} a function that returns the part of the string after the token
  */
 const getAfter = (strFn, token) => {
 	return () => {
@@ -62,9 +64,9 @@ const getAfter = (strFn, token) => {
 
 /**
  * Returns a function that returns the part of the string before the token
- * @param {() => string} strFn the function to get the string
+ * @param {ReturnStringCallback} strFn the function to get the string
  * @param {string} token the token to search for
- * @returns {() => string} a function that returns the part of the string before the token
+ * @returns {ReturnStringCallback} a function that returns the part of the string before the token
  */
 const getBefore = (strFn, token) => {
 	return () => {
@@ -76,11 +78,11 @@ const getBefore = (strFn, token) => {
 
 /**
  * Returns a function that returns a hash of the string
- * @param {() => string} strFn the function to get the string
- * @param {string | Hash} hashFunction the hash function to use
- * @returns {() => string} a function that returns the hash of the string
+ * @param {ReturnStringCallback} strFn the function to get the string
+ * @param {string | Hash=} hashFunction the hash function to use
+ * @returns {ReturnStringCallback} a function that returns the hash of the string
  */
-const getHash = (strFn, hashFunction) => {
+const getHash = (strFn, hashFunction = "md4") => {
 	return () => {
 		const hash = createHash(hashFunction);
 		hash.update(strFn());
@@ -116,7 +118,7 @@ const asRegExp = test => {
  * Returns a lazy object. The object is lazy in the sense that the properties are
  * only evaluated when they are accessed. This is only obtained by setting a function as the value for each key.
  * @param {Record<string, () => T>} obj the object to convert to a lazy access object
- * @returns {Object} the lazy access object
+ * @returns {object} the lazy access object
  */
 const lazyObject = obj => {
 	const newObj = {};
@@ -144,10 +146,10 @@ const SQUARE_BRACKET_TAG_REGEXP = /\[\\*([\w-]+)\\*\]/gi;
  *
  * @param {Module | string} module the module
  * @param {TODO} options options
- * @param {Object} contextInfo context info
+ * @param {object} contextInfo context info
  * @param {RequestShortener} contextInfo.requestShortener requestShortener
  * @param {ChunkGraph} contextInfo.chunkGraph chunk graph
- * @param {string | Hash} contextInfo.hashFunction the hash function to use
+ * @param {string | Hash=} contextInfo.hashFunction the hash function to use
  * @returns {string} the filename
  */
 ModuleFilenameHelpers.createFilename = (
@@ -167,11 +169,16 @@ ModuleFilenameHelpers.createFilename = (
 
 	let absoluteResourcePath;
 	let hash;
+	/** @type {ReturnStringCallback} */
 	let identifier;
+	/** @type {ReturnStringCallback} */
 	let moduleId;
+	/** @type {ReturnStringCallback} */
 	let shortIdentifier;
 	if (typeof module === "string") {
-		shortIdentifier = memoize(() => requestShortener.shorten(module));
+		shortIdentifier =
+			/** @type {ReturnStringCallback} */
+			(memoize(() => requestShortener.shorten(module)));
 		identifier = shortIdentifier;
 		moduleId = () => "";
 		absoluteResourcePath = () => module.split("!").pop();
@@ -180,15 +187,21 @@ ModuleFilenameHelpers.createFilename = (
 		shortIdentifier = memoize(() =>
 			module.readableIdentifier(requestShortener)
 		);
-		identifier = memoize(() => requestShortener.shorten(module.identifier()));
-		moduleId = () => chunkGraph.getModuleId(module);
+		identifier =
+			/** @type {ReturnStringCallback} */
+			(memoize(() => requestShortener.shorten(module.identifier())));
+		moduleId =
+			/** @type {ReturnStringCallback} */
+			(() => chunkGraph.getModuleId(module));
 		absoluteResourcePath = () =>
 			module instanceof NormalModule
 				? module.resource
 				: module.identifier().split("!").pop();
 		hash = getHash(identifier, hashFunction);
 	}
-	const resource = memoize(() => shortIdentifier().split("!").pop());
+	const resource =
+		/** @type {ReturnStringCallback} */
+		(memoize(() => shortIdentifier().split("!").pop()));
 
 	const loaders = getBefore(shortIdentifier, "!");
 	const allLoaders = getBefore(identifier, "!");
@@ -249,7 +262,7 @@ ModuleFilenameHelpers.createFilename = (
 	]);
 
 	// TODO webpack 6: consider removing weird double placeholders
-	return opts.moduleFilenameTemplate
+	return /** @type {string} */ (opts.moduleFilenameTemplate)
 		.replace(ModuleFilenameHelpers.REGEXP_ALL_LOADERS_RESOURCE, "[identifier]")
 		.replace(
 			ModuleFilenameHelpers.REGEXP_LOADERS_RESOURCE,

package/lib/ModuleGraph.js

@@ -132,7 +132,7 @@ class ModuleGraph {
 		 */
 		this._moduleMap = new Map();
 		/**
-		 * @type {WeakMap<any, Object>}
+		 * @type {WeakMap<any, object>}
 		 * @private
 		 */
 		this._metaMap = new WeakMap();
@@ -757,20 +757,20 @@ class ModuleGraph {
 
 	/**
 	 * @param {any} thing any thing
-	 * @returns {Object} metadata
+	 * @returns {object} metadata
 	 */
 	getMeta(thing) {
 		let meta = this._metaMap.get(thing);
 		if (meta === undefined) {
 			meta = Object.create(null);
-			this._metaMap.set(thing, /** @type {Object} */ (meta));
+			this._metaMap.set(thing, /** @type {object} */ (meta));
 		}
-		return /** @type {Object} */ (meta);
+		return /** @type {object} */ (meta);
 	}
 
 	/**
 	 * @param {any} thing any thing
-	 * @returns {Object | undefined} metadata
+	 * @returns {object | undefined} metadata
 	 */
 	getMetaIfExisting(thing) {
 		return this._metaMap.get(thing);

package/lib/MultiCompiler.js

@@ -11,6 +11,7 @@ const { SyncHook, MultiHook } = require("tapable");
 const ConcurrentCompilationError = require("./ConcurrentCompilationError");
 const MultiStats = require("./MultiStats");
 const MultiWatching = require("./MultiWatching");
+const WebpackError = require("./WebpackError");
 const ArrayQueue = require("./util/ArrayQueue");
 
 /** @template T @typedef {import("tapable").AsyncSeriesHook<T>} AsyncSeriesHook<T> */
@@ -39,7 +40,7 @@ const ArrayQueue = require("./util/ArrayQueue");
  */
 
 /**
- * @typedef {Object} MultiCompilerOptions
+ * @typedef {object} MultiCompilerOptions
  * @property {number=} parallelism how many Compilers are allows to run at the same time in parallel
  */
 
@@ -109,6 +110,40 @@ module.exports = class MultiCompiler {
 				}
 			});
 		}
+		this._validateCompilersOptions();
+	}
+
+	_validateCompilersOptions() {
+		if (this.compilers.length < 2) return;
+		/**
+		 * @param {Compiler} compiler compiler
+		 * @param {WebpackError} warning warning
+		 */
+		const addWarning = (compiler, warning) => {
+			compiler.hooks.thisCompilation.tap("MultiCompiler", compilation => {
+				compilation.warnings.push(warning);
+			});
+		};
+		const cacheNames = new Set();
+		for (const compiler of this.compilers) {
+			if (compiler.options.cache && "name" in compiler.options.cache) {
+				const name = compiler.options.cache.name;
+				if (cacheNames.has(name)) {
+					addWarning(
+						compiler,
+						new WebpackError(
+							`${
+								compiler.name
+									? `Compiler with name "${compiler.name}" doesn't use unique cache name. `
+									: ""
+							}Please set unique "cache.name" option. Name "${name}" already used.`
+						)
+					);
+				} else {
+					cacheNames.add(name);
+				}
+			}
+		}
 	}
 
 	get options() {