webpack/lib/ids/DeterministicChunkIdsPlugin.js

/*
	MIT License http://www.opensource.org/licenses/mit-license.php
	Author Florent Cailhol @ooflorent
*/

"use strict";

const { compareChunksNatural } = require("../util/comparators");
const {
	assignDeterministicIds,
	getFullChunkName,
	getUsedChunkIds
} = require("./IdHelpers");

/** @typedef {import("../Compiler")} Compiler */
/** @typedef {import("../Module")} Module */

/**
 * @typedef {object} DeterministicChunkIdsPluginOptions
 * @property {string=} context context for ids
 * @property {number=} maxLength maximum length of ids
 */

const PLUGIN_NAME = "DeterministicChunkIdsPlugin";

class DeterministicChunkIdsPlugin {
	/**
	 * @param {DeterministicChunkIdsPluginOptions=} options options
	 */
	constructor(options = {}) {
		this.options = options;
	}

	/**
	 * Apply the plugin
	 * @param {Compiler} compiler the compiler instance
	 * @returns {void}
	 */
	apply(compiler) {
		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
			compilation.hooks.chunkIds.tap(PLUGIN_NAME, chunks => {
				const chunkGraph = compilation.chunkGraph;
				const context = this.options.context
					? this.options.context
					: compiler.context;
				const maxLength = this.options.maxLength || 3;

				const compareNatural = compareChunksNatural(chunkGraph);

				const usedIds = getUsedChunkIds(compilation);
				assignDeterministicIds(
					[...chunks].filter(chunk => chunk.id === null),
					chunk => getFullChunkName(chunk, chunkGraph, context, compiler.root),
					compareNatural,
					(chunk, id) => {
						const size = usedIds.size;
						usedIds.add(`${id}`);
						if (size === usedIds.size) return false;
						chunk.id = id;
						chunk.ids = [id];
						return true;
					},
					[10 ** maxLength],
					10,
					usedIds.size
				);
			});
		});
	}
}

module.exports = DeterministicChunkIdsPlugin;