Method apply

lib/ids/DeterministicModuleIdsPlugin.js:48–97

* Applies the plugin by registering its hooks on the compiler. * @param {Compiler} compiler the compiler instance * @returns {void}

(compiler)

	 * @returns {void}
	 */
	apply(compiler) {
		compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
			compilation.hooks.moduleIds.tap(PLUGIN_NAME, () => {
				const chunkGraph = compilation.chunkGraph;
				const context = this.options.context
					? this.options.context
					: compiler.context;
				const maxLength = this.options.maxLength || 3;
				const failOnConflict = this.options.failOnConflict || false;
				const fixedLength = this.options.fixedLength || false;
				const salt = this.options.salt || 0;
				let conflicts = 0;

				const [usedIds, modules] = getUsedModuleIdsAndModules(
					compilation,
					this.options.test
				);
				assignDeterministicIds(
					modules,
					(module) => getFullModuleName(module, context, compiler.root),
					failOnConflict
						? () => 0
						: compareModulesByPreOrderIndexOrIdentifier(
								compilation.moduleGraph
							),
					(module, id) => {
						const size = usedIds.size;
						usedIds.add(`${id}`);
						if (size === usedIds.size) {
							conflicts++;
							return false;
						}
						chunkGraph.setModuleId(module, id);
						return true;
					},
					[10 ** maxLength],
					fixedLength ? 0 : 10,
					usedIds.size,
					salt
				);
				if (failOnConflict && conflicts) {
					throw new Error(
						`Assigning deterministic module ids has lead to ${conflicts} conflict${
							conflicts > 1 ? "s" : ""
						}.\nIncrease the 'maxLength' to increase the id space and make conflicts less likely (recommended when there are many conflicts or application is expected to grow), or add an 'salt' number to try another hash starting value in the same id space (recommended when there is only a single conflict).`
					);
				}
			});
		});
	}
}

module.exports = DeterministicModuleIdsPlugin;