/*
|
|
MIT License http://www.opensource.org/licenses/mit-license.php
|
|
Author Tobias Koppers @sokra
|
|
*/
|
|
"use strict";
|
|
|
|
const asyncLib = require("neo-async");
|
|
const util = require("util");
|
|
const { CachedSource } = require("webpack-sources");
|
|
const {
|
|
Tapable,
|
|
SyncHook,
|
|
SyncBailHook,
|
|
SyncWaterfallHook,
|
|
AsyncSeriesHook
|
|
} = require("tapable");
|
|
const EntryModuleNotFoundError = require("./EntryModuleNotFoundError");
|
|
const ModuleNotFoundError = require("./ModuleNotFoundError");
|
|
const ModuleDependencyWarning = require("./ModuleDependencyWarning");
|
|
const ModuleDependencyError = require("./ModuleDependencyError");
|
|
const ChunkGroup = require("./ChunkGroup");
|
|
const Chunk = require("./Chunk");
|
|
const Entrypoint = require("./Entrypoint");
|
|
const MainTemplate = require("./MainTemplate");
|
|
const ChunkTemplate = require("./ChunkTemplate");
|
|
const HotUpdateChunkTemplate = require("./HotUpdateChunkTemplate");
|
|
const ModuleTemplate = require("./ModuleTemplate");
|
|
const RuntimeTemplate = require("./RuntimeTemplate");
|
|
const ChunkRenderError = require("./ChunkRenderError");
|
|
const Stats = require("./Stats");
|
|
const Semaphore = require("./util/Semaphore");
|
|
const createHash = require("./util/createHash");
|
|
const SortableSet = require("./util/SortableSet");
|
|
const GraphHelpers = require("./GraphHelpers");
|
|
const ModuleDependency = require("./dependencies/ModuleDependency");
|
|
const compareLocations = require("./compareLocations");
|
|
const { Logger, LogType } = require("./logging/Logger");
|
|
const ErrorHelpers = require("./ErrorHelpers");
|
|
const buildChunkGraph = require("./buildChunkGraph");
|
|
const WebpackError = require("./WebpackError");
|
|
|
|
/** @typedef {import("./Module")} Module */
|
|
/** @typedef {import("./Compiler")} Compiler */
|
|
/** @typedef {import("webpack-sources").Source} Source */
|
|
/** @typedef {import("./DependenciesBlockVariable")} DependenciesBlockVariable */
|
|
/** @typedef {import("./dependencies/SingleEntryDependency")} SingleEntryDependency */
|
|
/** @typedef {import("./dependencies/MultiEntryDependency")} MultiEntryDependency */
|
|
/** @typedef {import("./dependencies/DllEntryDependency")} DllEntryDependency */
|
|
/** @typedef {import("./dependencies/DependencyReference")} DependencyReference */
|
|
/** @typedef {import("./DependenciesBlock")} DependenciesBlock */
|
|
/** @typedef {import("./AsyncDependenciesBlock")} AsyncDependenciesBlock */
|
|
/** @typedef {import("./Dependency")} Dependency */
|
|
/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
|
|
/** @typedef {import("./Dependency").DependencyTemplate} DependencyTemplate */
|
|
/** @typedef {import("./util/createHash").Hash} Hash */
|
|
|
|
// TODO use @callback
|
|
/** @typedef {{[assetName: string]: Source}} CompilationAssets */
|
|
/** @typedef {(err: Error|null, result?: Module) => void } ModuleCallback */
|
|
/** @typedef {(err?: Error|null, result?: Module) => void } ModuleChainCallback */
|
|
/** @typedef {(module: Module) => void} OnModuleCallback */
|
|
/** @typedef {(err?: Error|null) => void} Callback */
|
|
/** @typedef {(d: Dependency) => any} DepBlockVarDependenciesCallback */
|
|
/** @typedef {new (...args: any[]) => Dependency} DepConstructor */
|
|
/** @typedef {{apply: () => void}} Plugin */
|
|
|
|
/**
|
|
* @typedef {Object} ModuleFactoryCreateDataContextInfo
|
|
* @property {string} issuer
|
|
* @property {string} compiler
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} ModuleFactoryCreateData
|
|
* @property {ModuleFactoryCreateDataContextInfo} contextInfo
|
|
* @property {any=} resolveOptions
|
|
* @property {string} context
|
|
* @property {Dependency[]} dependencies
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} ModuleFactory
|
|
* @property {(data: ModuleFactoryCreateData, callback: ModuleCallback) => any} create
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} SortedDependency
|
|
* @property {ModuleFactory} factory
|
|
* @property {Dependency[]} dependencies
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} DependenciesBlockLike
|
|
* @property {Dependency[]} dependencies
|
|
* @property {AsyncDependenciesBlock[]} blocks
|
|
* @property {DependenciesBlockVariable[]} variables
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} LogEntry
|
|
* @property {string} type
|
|
* @property {any[]} args
|
|
* @property {number} time
|
|
* @property {string[]=} trace
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} AssetInfo
|
|
* @property {boolean=} immutable true, if the asset can be long term cached forever (contains a hash)
|
|
* @property {number=} size size in bytes, only set after asset has been emitted
|
|
* @property {boolean=} development true, when asset is only used for development and doesn't count towards user-facing assets
|
|
* @property {boolean=} hotModuleReplacement true, when asset ships data for updating an existing application (HMR)
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} Asset
|
|
* @property {string} name the filename of the asset
|
|
* @property {Source} source source of the asset
|
|
* @property {AssetInfo} info info about the asset
|
|
*/
|
|
|
|
/**
|
|
* @param {Chunk} a first chunk to sort by id
|
|
* @param {Chunk} b second chunk to sort by id
|
|
* @returns {-1|0|1} sort value
|
|
*/
|
|
const byId = (a, b) => {
|
|
if (typeof a.id !== typeof b.id) {
|
|
return typeof a.id < typeof b.id ? -1 : 1;
|
|
}
|
|
if (a.id < b.id) return -1;
|
|
if (a.id > b.id) return 1;
|
|
return 0;
|
|
};
|
|
|
|
/**
|
|
* @param {Module} a first module to sort by
|
|
* @param {Module} b second module to sort by
|
|
* @returns {-1|0|1} sort value
|
|
*/
|
|
const byIdOrIdentifier = (a, b) => {
|
|
if (typeof a.id !== typeof b.id) {
|
|
return typeof a.id < typeof b.id ? -1 : 1;
|
|
}
|
|
if (a.id < b.id) return -1;
|
|
if (a.id > b.id) return 1;
|
|
const identA = a.identifier();
|
|
const identB = b.identifier();
|
|
if (identA < identB) return -1;
|
|
if (identA > identB) return 1;
|
|
return 0;
|
|
};
|
|
|
|
/**
|
|
* @param {Module} a first module to sort by
|
|
* @param {Module} b second module to sort by
|
|
* @returns {-1|0|1} sort value
|
|
*/
|
|
const byIndexOrIdentifier = (a, b) => {
|
|
if (a.index < b.index) return -1;
|
|
if (a.index > b.index) return 1;
|
|
const identA = a.identifier();
|
|
const identB = b.identifier();
|
|
if (identA < identB) return -1;
|
|
if (identA > identB) return 1;
|
|
return 0;
|
|
};
|
|
|
|
/**
|
|
* @param {Compilation} a first compilation to sort by
|
|
* @param {Compilation} b second compilation to sort by
|
|
* @returns {-1|0|1} sort value
|
|
*/
|
|
const byNameOrHash = (a, b) => {
|
|
if (a.name < b.name) return -1;
|
|
if (a.name > b.name) return 1;
|
|
if (a.fullHash < b.fullHash) return -1;
|
|
if (a.fullHash > b.fullHash) return 1;
|
|
return 0;
|
|
};
|
|
|
|
/**
|
|
* @param {DependenciesBlockVariable[]} variables DepBlock Variables to iterate over
|
|
* @param {DepBlockVarDependenciesCallback} fn callback to apply on iterated elements
|
|
* @returns {void}
|
|
*/
|
|
const iterationBlockVariable = (variables, fn) => {
|
|
for (
|
|
let indexVariable = 0;
|
|
indexVariable < variables.length;
|
|
indexVariable++
|
|
) {
|
|
const varDep = variables[indexVariable].dependencies;
|
|
for (let indexVDep = 0; indexVDep < varDep.length; indexVDep++) {
|
|
fn(varDep[indexVDep]);
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @template T
|
|
* @param {T[]} arr array of elements to iterate over
|
|
* @param {function(T): void} fn callback applied to each element
|
|
* @returns {void}
|
|
*/
|
|
const iterationOfArrayCallback = (arr, fn) => {
|
|
for (let index = 0; index < arr.length; index++) {
|
|
fn(arr[index]);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @template T
|
|
* @param {Set<T>} set set to add items to
|
|
* @param {Set<T>} otherSet set to add items from
|
|
* @returns {void}
|
|
*/
|
|
const addAllToSet = (set, otherSet) => {
|
|
for (const item of otherSet) {
|
|
set.add(item);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @param {Source} a a source
|
|
* @param {Source} b another source
|
|
* @returns {boolean} true, when both sources are equal
|
|
*/
|
|
const isSourceEqual = (a, b) => {
|
|
if (a === b) return true;
|
|
// TODO webpack 5: check .buffer() instead, it's called anyway during emit
|
|
/** @type {Buffer|string} */
|
|
let aSource = a.source();
|
|
/** @type {Buffer|string} */
|
|
let bSource = b.source();
|
|
if (aSource === bSource) return true;
|
|
if (typeof aSource === "string" && typeof bSource === "string") return false;
|
|
if (!Buffer.isBuffer(aSource)) aSource = Buffer.from(aSource, "utf-8");
|
|
if (!Buffer.isBuffer(bSource)) bSource = Buffer.from(bSource, "utf-8");
|
|
return aSource.equals(bSource);
|
|
};
|
|
|
|
class Compilation extends Tapable {
|
|
/**
|
|
* Creates an instance of Compilation.
|
|
* @param {Compiler} compiler the compiler which created the compilation
|
|
*/
|
|
constructor(compiler) {
|
|
super();
|
|
this.hooks = {
|
|
/** @type {SyncHook<Module>} */
|
|
buildModule: new SyncHook(["module"]),
|
|
/** @type {SyncHook<Module>} */
|
|
rebuildModule: new SyncHook(["module"]),
|
|
/** @type {SyncHook<Module, Error>} */
|
|
failedModule: new SyncHook(["module", "error"]),
|
|
/** @type {SyncHook<Module>} */
|
|
succeedModule: new SyncHook(["module"]),
|
|
|
|
/** @type {SyncHook<Dependency, string>} */
|
|
addEntry: new SyncHook(["entry", "name"]),
|
|
/** @type {SyncHook<Dependency, string, Error>} */
|
|
failedEntry: new SyncHook(["entry", "name", "error"]),
|
|
/** @type {SyncHook<Dependency, string, Module>} */
|
|
succeedEntry: new SyncHook(["entry", "name", "module"]),
|
|
|
|
/** @type {SyncWaterfallHook<DependencyReference, Dependency, Module>} */
|
|
dependencyReference: new SyncWaterfallHook([
|
|
"dependencyReference",
|
|
"dependency",
|
|
"module"
|
|
]),
|
|
|
|
/** @type {AsyncSeriesHook<Module[]>} */
|
|
finishModules: new AsyncSeriesHook(["modules"]),
|
|
/** @type {SyncHook<Module>} */
|
|
finishRebuildingModule: new SyncHook(["module"]),
|
|
/** @type {SyncHook} */
|
|
unseal: new SyncHook([]),
|
|
/** @type {SyncHook} */
|
|
seal: new SyncHook([]),
|
|
|
|
/** @type {SyncHook} */
|
|
beforeChunks: new SyncHook([]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
afterChunks: new SyncHook(["chunks"]),
|
|
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
optimizeDependenciesBasic: new SyncBailHook(["modules"]),
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
optimizeDependencies: new SyncBailHook(["modules"]),
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
optimizeDependenciesAdvanced: new SyncBailHook(["modules"]),
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
afterOptimizeDependencies: new SyncHook(["modules"]),
|
|
|
|
/** @type {SyncHook} */
|
|
optimize: new SyncHook([]),
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
optimizeModulesBasic: new SyncBailHook(["modules"]),
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
optimizeModules: new SyncBailHook(["modules"]),
|
|
/** @type {SyncBailHook<Module[]>} */
|
|
optimizeModulesAdvanced: new SyncBailHook(["modules"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
afterOptimizeModules: new SyncHook(["modules"]),
|
|
|
|
/** @type {SyncBailHook<Chunk[], ChunkGroup[]>} */
|
|
optimizeChunksBasic: new SyncBailHook(["chunks", "chunkGroups"]),
|
|
/** @type {SyncBailHook<Chunk[], ChunkGroup[]>} */
|
|
optimizeChunks: new SyncBailHook(["chunks", "chunkGroups"]),
|
|
/** @type {SyncBailHook<Chunk[], ChunkGroup[]>} */
|
|
optimizeChunksAdvanced: new SyncBailHook(["chunks", "chunkGroups"]),
|
|
/** @type {SyncHook<Chunk[], ChunkGroup[]>} */
|
|
afterOptimizeChunks: new SyncHook(["chunks", "chunkGroups"]),
|
|
|
|
/** @type {AsyncSeriesHook<Chunk[], Module[]>} */
|
|
optimizeTree: new AsyncSeriesHook(["chunks", "modules"]),
|
|
/** @type {SyncHook<Chunk[], Module[]>} */
|
|
afterOptimizeTree: new SyncHook(["chunks", "modules"]),
|
|
|
|
/** @type {SyncBailHook<Chunk[], Module[]>} */
|
|
optimizeChunkModulesBasic: new SyncBailHook(["chunks", "modules"]),
|
|
/** @type {SyncBailHook<Chunk[], Module[]>} */
|
|
optimizeChunkModules: new SyncBailHook(["chunks", "modules"]),
|
|
/** @type {SyncBailHook<Chunk[], Module[]>} */
|
|
optimizeChunkModulesAdvanced: new SyncBailHook(["chunks", "modules"]),
|
|
/** @type {SyncHook<Chunk[], Module[]>} */
|
|
afterOptimizeChunkModules: new SyncHook(["chunks", "modules"]),
|
|
/** @type {SyncBailHook} */
|
|
shouldRecord: new SyncBailHook([]),
|
|
|
|
/** @type {SyncHook<Module[], any>} */
|
|
reviveModules: new SyncHook(["modules", "records"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
optimizeModuleOrder: new SyncHook(["modules"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
advancedOptimizeModuleOrder: new SyncHook(["modules"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
beforeModuleIds: new SyncHook(["modules"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
moduleIds: new SyncHook(["modules"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
optimizeModuleIds: new SyncHook(["modules"]),
|
|
/** @type {SyncHook<Module[]>} */
|
|
afterOptimizeModuleIds: new SyncHook(["modules"]),
|
|
|
|
/** @type {SyncHook<Chunk[], any>} */
|
|
reviveChunks: new SyncHook(["chunks", "records"]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
optimizeChunkOrder: new SyncHook(["chunks"]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
beforeChunkIds: new SyncHook(["chunks"]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
optimizeChunkIds: new SyncHook(["chunks"]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
afterOptimizeChunkIds: new SyncHook(["chunks"]),
|
|
|
|
/** @type {SyncHook<Module[], any>} */
|
|
recordModules: new SyncHook(["modules", "records"]),
|
|
/** @type {SyncHook<Chunk[], any>} */
|
|
recordChunks: new SyncHook(["chunks", "records"]),
|
|
|
|
/** @type {SyncHook} */
|
|
beforeHash: new SyncHook([]),
|
|
/** @type {SyncHook<Chunk>} */
|
|
contentHash: new SyncHook(["chunk"]),
|
|
/** @type {SyncHook} */
|
|
afterHash: new SyncHook([]),
|
|
/** @type {SyncHook<any>} */
|
|
recordHash: new SyncHook(["records"]),
|
|
/** @type {SyncHook<Compilation, any>} */
|
|
record: new SyncHook(["compilation", "records"]),
|
|
|
|
/** @type {SyncHook} */
|
|
beforeModuleAssets: new SyncHook([]),
|
|
/** @type {SyncBailHook} */
|
|
shouldGenerateChunkAssets: new SyncBailHook([]),
|
|
/** @type {SyncHook} */
|
|
beforeChunkAssets: new SyncHook([]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
additionalChunkAssets: new SyncHook(["chunks"]),
|
|
|
|
/** @type {AsyncSeriesHook} */
|
|
additionalAssets: new AsyncSeriesHook([]),
|
|
/** @type {AsyncSeriesHook<Chunk[]>} */
|
|
optimizeChunkAssets: new AsyncSeriesHook(["chunks"]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
afterOptimizeChunkAssets: new SyncHook(["chunks"]),
|
|
/** @type {AsyncSeriesHook<CompilationAssets>} */
|
|
optimizeAssets: new AsyncSeriesHook(["assets"]),
|
|
/** @type {SyncHook<CompilationAssets>} */
|
|
afterOptimizeAssets: new SyncHook(["assets"]),
|
|
|
|
/** @type {SyncBailHook} */
|
|
needAdditionalSeal: new SyncBailHook([]),
|
|
/** @type {AsyncSeriesHook} */
|
|
afterSeal: new AsyncSeriesHook([]),
|
|
|
|
/** @type {SyncHook<Chunk, Hash>} */
|
|
chunkHash: new SyncHook(["chunk", "chunkHash"]),
|
|
/** @type {SyncHook<Module, string>} */
|
|
moduleAsset: new SyncHook(["module", "filename"]),
|
|
/** @type {SyncHook<Chunk, string>} */
|
|
chunkAsset: new SyncHook(["chunk", "filename"]),
|
|
|
|
/** @type {SyncWaterfallHook<string, TODO>} */
|
|
assetPath: new SyncWaterfallHook(["filename", "data"]), // TODO MainTemplate
|
|
|
|
/** @type {SyncBailHook} */
|
|
needAdditionalPass: new SyncBailHook([]),
|
|
|
|
/** @type {SyncHook<Compiler, string, number>} */
|
|
childCompiler: new SyncHook([
|
|
"childCompiler",
|
|
"compilerName",
|
|
"compilerIndex"
|
|
]),
|
|
|
|
/** @type {SyncBailHook<string, LogEntry>} */
|
|
log: new SyncBailHook(["origin", "logEntry"]),
|
|
|
|
// TODO the following hooks are weirdly located here
|
|
// TODO move them for webpack 5
|
|
/** @type {SyncHook<object, Module>} */
|
|
normalModuleLoader: new SyncHook(["loaderContext", "module"]),
|
|
|
|
/** @type {SyncBailHook<Chunk[]>} */
|
|
optimizeExtractedChunksBasic: new SyncBailHook(["chunks"]),
|
|
/** @type {SyncBailHook<Chunk[]>} */
|
|
optimizeExtractedChunks: new SyncBailHook(["chunks"]),
|
|
/** @type {SyncBailHook<Chunk[]>} */
|
|
optimizeExtractedChunksAdvanced: new SyncBailHook(["chunks"]),
|
|
/** @type {SyncHook<Chunk[]>} */
|
|
afterOptimizeExtractedChunks: new SyncHook(["chunks"])
|
|
};
|
|
this._pluginCompat.tap("Compilation", options => {
|
|
switch (options.name) {
|
|
case "optimize-tree":
|
|
case "additional-assets":
|
|
case "optimize-chunk-assets":
|
|
case "optimize-assets":
|
|
case "after-seal":
|
|
options.async = true;
|
|
break;
|
|
}
|
|
});
|
|
/** @type {string=} */
|
|
this.name = undefined;
|
|
/** @type {Compiler} */
|
|
this.compiler = compiler;
|
|
this.resolverFactory = compiler.resolverFactory;
|
|
this.inputFileSystem = compiler.inputFileSystem;
|
|
this.requestShortener = compiler.requestShortener;
|
|
|
|
const options = compiler.options;
|
|
this.options = options;
|
|
this.outputOptions = options && options.output;
|
|
/** @type {boolean=} */
|
|
this.bail = options && options.bail;
|
|
this.profile = options && options.profile;
|
|
this.performance = options && options.performance;
|
|
|
|
this.mainTemplate = new MainTemplate(this.outputOptions);
|
|
this.chunkTemplate = new ChunkTemplate(this.outputOptions);
|
|
this.hotUpdateChunkTemplate = new HotUpdateChunkTemplate(
|
|
this.outputOptions
|
|
);
|
|
this.runtimeTemplate = new RuntimeTemplate(
|
|
this.outputOptions,
|
|
this.requestShortener
|
|
);
|
|
this.moduleTemplates = {
|
|
javascript: new ModuleTemplate(this.runtimeTemplate, "javascript"),
|
|
webassembly: new ModuleTemplate(this.runtimeTemplate, "webassembly")
|
|
};
|
|
|
|
this.semaphore = new Semaphore(options.parallelism || 100);
|
|
|
|
this.entries = [];
|
|
/** @private @type {{name: string, request: string, module: Module}[]} */
|
|
this._preparedEntrypoints = [];
|
|
/** @type {Map<string, Entrypoint>} */
|
|
this.entrypoints = new Map();
|
|
/** @type {Chunk[]} */
|
|
this.chunks = [];
|
|
/** @type {ChunkGroup[]} */
|
|
this.chunkGroups = [];
|
|
/** @type {Map<string, ChunkGroup>} */
|
|
this.namedChunkGroups = new Map();
|
|
/** @type {Map<string, Chunk>} */
|
|
this.namedChunks = new Map();
|
|
/** @type {Module[]} */
|
|
this.modules = [];
|
|
/** @private @type {Map<string, Module>} */
|
|
this._modules = new Map();
|
|
this.cache = null;
|
|
this.records = null;
|
|
/** @type {string[]} */
|
|
this.additionalChunkAssets = [];
|
|
/** @type {CompilationAssets} */
|
|
this.assets = {};
|
|
/** @type {Map<string, AssetInfo>} */
|
|
this.assetsInfo = new Map();
|
|
/** @type {WebpackError[]} */
|
|
this.errors = [];
|
|
/** @type {WebpackError[]} */
|
|
this.warnings = [];
|
|
/** @type {Compilation[]} */
|
|
this.children = [];
|
|
/** @type {Map<string, LogEntry[]>} */
|
|
this.logging = new Map();
|
|
/** @type {Map<DepConstructor, ModuleFactory>} */
|
|
this.dependencyFactories = new Map();
|
|
/** @type {Map<DepConstructor, DependencyTemplate>} */
|
|
this.dependencyTemplates = new Map();
|
|
// TODO refactor this in webpack 5 to a custom DependencyTemplates class with a hash property
|
|
// @ts-ignore
|
|
this.dependencyTemplates.set("hash", "");
|
|
this.childrenCounters = {};
|
|
/** @type {Set<number|string>} */
|
|
this.usedChunkIds = null;
|
|
/** @type {Set<number>} */
|
|
this.usedModuleIds = null;
|
|
/** @type {Map<string, number>=} */
|
|
this.fileTimestamps = undefined;
|
|
/** @type {Map<string, number>=} */
|
|
this.contextTimestamps = undefined;
|
|
/** @type {Set<string>=} */
|
|
this.compilationDependencies = undefined;
|
|
/** @private @type {Map<Module, Callback[]>} */
|
|
this._buildingModules = new Map();
|
|
/** @private @type {Map<Module, Callback[]>} */
|
|
this._rebuildingModules = new Map();
|
|
/** @type {Set<string>} */
|
|
this.emittedAssets = new Set();
|
|
}
|
|
|
|
getStats() {
|
|
return new Stats(this);
|
|
}
|
|
|
|
/**
|
|
* @param {string | (function(): string)} name name of the logger, or function called once to get the logger name
|
|
* @returns {Logger} a logger with that name
|
|
*/
|
|
getLogger(name) {
|
|
if (!name) {
|
|
throw new TypeError("Compilation.getLogger(name) called without a name");
|
|
}
|
|
/** @type {LogEntry[] | undefined} */
|
|
let logEntries;
|
|
return new Logger((type, args) => {
|
|
if (typeof name === "function") {
|
|
name = name();
|
|
if (!name) {
|
|
throw new TypeError(
|
|
"Compilation.getLogger(name) called with a function not returning a name"
|
|
);
|
|
}
|
|
}
|
|
let trace;
|
|
switch (type) {
|
|
case LogType.warn:
|
|
case LogType.error:
|
|
case LogType.trace:
|
|
trace = ErrorHelpers.cutOffLoaderExecution(new Error("Trace").stack)
|
|
.split("\n")
|
|
.slice(3);
|
|
break;
|
|
}
|
|
/** @type {LogEntry} */
|
|
const logEntry = {
|
|
time: Date.now(),
|
|
type,
|
|
args,
|
|
trace
|
|
};
|
|
if (this.hooks.log.call(name, logEntry) === undefined) {
|
|
if (logEntry.type === LogType.profileEnd) {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.profileEnd === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.profileEnd(`[${name}] ${logEntry.args[0]}`);
|
|
}
|
|
}
|
|
if (logEntries === undefined) {
|
|
logEntries = this.logging.get(name);
|
|
if (logEntries === undefined) {
|
|
logEntries = [];
|
|
this.logging.set(name, logEntries);
|
|
}
|
|
}
|
|
logEntries.push(logEntry);
|
|
if (logEntry.type === LogType.profile) {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.profile === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.profile(`[${name}] ${logEntry.args[0]}`);
|
|
}
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @typedef {Object} AddModuleResult
|
|
* @property {Module} module the added or existing module
|
|
* @property {boolean} issuer was this the first request for this module
|
|
* @property {boolean} build should the module be build
|
|
* @property {boolean} dependencies should dependencies be walked
|
|
*/
|
|
|
|
/**
|
|
* @param {Module} module module to be added that was created
|
|
* @param {any=} cacheGroup cacheGroup it is apart of
|
|
* @returns {AddModuleResult} returns meta about whether or not the module had built
|
|
* had an issuer, or any dependnecies
|
|
*/
|
|
addModule(module, cacheGroup) {
|
|
const identifier = module.identifier();
|
|
const alreadyAddedModule = this._modules.get(identifier);
|
|
if (alreadyAddedModule) {
|
|
return {
|
|
module: alreadyAddedModule,
|
|
issuer: false,
|
|
build: false,
|
|
dependencies: false
|
|
};
|
|
}
|
|
const cacheName = (cacheGroup || "m") + identifier;
|
|
if (this.cache && this.cache[cacheName]) {
|
|
const cacheModule = this.cache[cacheName];
|
|
|
|
if (typeof cacheModule.updateCacheModule === "function") {
|
|
cacheModule.updateCacheModule(module);
|
|
}
|
|
|
|
let rebuild = true;
|
|
if (this.fileTimestamps && this.contextTimestamps) {
|
|
rebuild = cacheModule.needRebuild(
|
|
this.fileTimestamps,
|
|
this.contextTimestamps
|
|
);
|
|
}
|
|
|
|
if (!rebuild) {
|
|
cacheModule.disconnect();
|
|
this._modules.set(identifier, cacheModule);
|
|
this.modules.push(cacheModule);
|
|
for (const err of cacheModule.errors) {
|
|
this.errors.push(err);
|
|
}
|
|
for (const err of cacheModule.warnings) {
|
|
this.warnings.push(err);
|
|
}
|
|
return {
|
|
module: cacheModule,
|
|
issuer: true,
|
|
build: false,
|
|
dependencies: true
|
|
};
|
|
}
|
|
cacheModule.unbuild();
|
|
module = cacheModule;
|
|
}
|
|
this._modules.set(identifier, module);
|
|
if (this.cache) {
|
|
this.cache[cacheName] = module;
|
|
}
|
|
this.modules.push(module);
|
|
return {
|
|
module: module,
|
|
issuer: true,
|
|
build: true,
|
|
dependencies: true
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Fetches a module from a compilation by its identifier
|
|
* @param {Module} module the module provided
|
|
* @returns {Module} the module requested
|
|
*/
|
|
getModule(module) {
|
|
const identifier = module.identifier();
|
|
return this._modules.get(identifier);
|
|
}
|
|
|
|
/**
|
|
* Attempts to search for a module by its identifier
|
|
* @param {string} identifier identifier (usually path) for module
|
|
* @returns {Module|undefined} attempt to search for module and return it, else undefined
|
|
*/
|
|
findModule(identifier) {
|
|
return this._modules.get(identifier);
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module module with its callback list
|
|
* @param {Callback} callback the callback function
|
|
* @returns {void}
|
|
*/
|
|
waitForBuildingFinished(module, callback) {
|
|
let callbackList = this._buildingModules.get(module);
|
|
if (callbackList) {
|
|
callbackList.push(() => callback());
|
|
} else {
|
|
process.nextTick(callback);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Builds the module object
|
|
*
|
|
* @param {Module} module module to be built
|
|
* @param {boolean} optional optional flag
|
|
* @param {Module=} origin origin module this module build was requested from
|
|
* @param {Dependency[]=} dependencies optional dependencies from the module to be built
|
|
* @param {TODO} thisCallback the callback
|
|
* @returns {TODO} returns the callback function with results
|
|
*/
|
|
buildModule(module, optional, origin, dependencies, thisCallback) {
|
|
let callbackList = this._buildingModules.get(module);
|
|
if (callbackList) {
|
|
callbackList.push(thisCallback);
|
|
return;
|
|
}
|
|
this._buildingModules.set(module, (callbackList = [thisCallback]));
|
|
|
|
const callback = err => {
|
|
this._buildingModules.delete(module);
|
|
for (const cb of callbackList) {
|
|
cb(err);
|
|
}
|
|
};
|
|
|
|
this.hooks.buildModule.call(module);
|
|
module.build(
|
|
this.options,
|
|
this,
|
|
this.resolverFactory.get("normal", module.resolveOptions),
|
|
this.inputFileSystem,
|
|
error => {
|
|
const errors = module.errors;
|
|
for (let indexError = 0; indexError < errors.length; indexError++) {
|
|
const err = errors[indexError];
|
|
err.origin = origin;
|
|
err.dependencies = dependencies;
|
|
if (optional) {
|
|
this.warnings.push(err);
|
|
} else {
|
|
this.errors.push(err);
|
|
}
|
|
}
|
|
|
|
const warnings = module.warnings;
|
|
for (
|
|
let indexWarning = 0;
|
|
indexWarning < warnings.length;
|
|
indexWarning++
|
|
) {
|
|
const war = warnings[indexWarning];
|
|
war.origin = origin;
|
|
war.dependencies = dependencies;
|
|
this.warnings.push(war);
|
|
}
|
|
const originalMap = module.dependencies.reduce((map, v, i) => {
|
|
map.set(v, i);
|
|
return map;
|
|
}, new Map());
|
|
module.dependencies.sort((a, b) => {
|
|
const cmp = compareLocations(a.loc, b.loc);
|
|
if (cmp) return cmp;
|
|
return originalMap.get(a) - originalMap.get(b);
|
|
});
|
|
if (error) {
|
|
this.hooks.failedModule.call(module, error);
|
|
return callback(error);
|
|
}
|
|
this.hooks.succeedModule.call(module);
|
|
return callback();
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module to be processed for deps
|
|
* @param {ModuleCallback} callback callback to be triggered
|
|
* @returns {void}
|
|
*/
|
|
processModuleDependencies(module, callback) {
|
|
const dependencies = new Map();
|
|
|
|
const addDependency = dep => {
|
|
const resourceIdent = dep.getResourceIdentifier();
|
|
if (resourceIdent) {
|
|
const factory = this.dependencyFactories.get(dep.constructor);
|
|
if (factory === undefined) {
|
|
throw new Error(
|
|
`No module factory available for dependency type: ${dep.constructor.name}`
|
|
);
|
|
}
|
|
let innerMap = dependencies.get(factory);
|
|
if (innerMap === undefined) {
|
|
dependencies.set(factory, (innerMap = new Map()));
|
|
}
|
|
let list = innerMap.get(resourceIdent);
|
|
if (list === undefined) innerMap.set(resourceIdent, (list = []));
|
|
list.push(dep);
|
|
}
|
|
};
|
|
|
|
const addDependenciesBlock = block => {
|
|
if (block.dependencies) {
|
|
iterationOfArrayCallback(block.dependencies, addDependency);
|
|
}
|
|
if (block.blocks) {
|
|
iterationOfArrayCallback(block.blocks, addDependenciesBlock);
|
|
}
|
|
if (block.variables) {
|
|
iterationBlockVariable(block.variables, addDependency);
|
|
}
|
|
};
|
|
|
|
try {
|
|
addDependenciesBlock(module);
|
|
} catch (e) {
|
|
callback(e);
|
|
}
|
|
|
|
const sortedDependencies = [];
|
|
|
|
for (const pair1 of dependencies) {
|
|
for (const pair2 of pair1[1]) {
|
|
sortedDependencies.push({
|
|
factory: pair1[0],
|
|
dependencies: pair2[1]
|
|
});
|
|
}
|
|
}
|
|
|
|
this.addModuleDependencies(
|
|
module,
|
|
sortedDependencies,
|
|
this.bail,
|
|
null,
|
|
true,
|
|
callback
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module module to add deps to
|
|
* @param {SortedDependency[]} dependencies set of sorted dependencies to iterate through
|
|
* @param {(boolean|null)=} bail whether to bail or not
|
|
* @param {TODO} cacheGroup optional cacheGroup
|
|
* @param {boolean} recursive whether it is recursive traversal
|
|
* @param {function} callback callback for when dependencies are finished being added
|
|
* @returns {void}
|
|
*/
|
|
addModuleDependencies(
|
|
module,
|
|
dependencies,
|
|
bail,
|
|
cacheGroup,
|
|
recursive,
|
|
callback
|
|
) {
|
|
const start = this.profile && Date.now();
|
|
const currentProfile = this.profile && {};
|
|
|
|
asyncLib.forEach(
|
|
dependencies,
|
|
(item, callback) => {
|
|
const dependencies = item.dependencies;
|
|
|
|
const errorAndCallback = err => {
|
|
err.origin = module;
|
|
err.dependencies = dependencies;
|
|
this.errors.push(err);
|
|
if (bail) {
|
|
callback(err);
|
|
} else {
|
|
callback();
|
|
}
|
|
};
|
|
const warningAndCallback = err => {
|
|
err.origin = module;
|
|
this.warnings.push(err);
|
|
callback();
|
|
};
|
|
|
|
const semaphore = this.semaphore;
|
|
semaphore.acquire(() => {
|
|
const factory = item.factory;
|
|
factory.create(
|
|
{
|
|
contextInfo: {
|
|
issuer: module.nameForCondition && module.nameForCondition(),
|
|
compiler: this.compiler.name
|
|
},
|
|
resolveOptions: module.resolveOptions,
|
|
context: module.context,
|
|
dependencies: dependencies
|
|
},
|
|
(err, dependentModule) => {
|
|
let afterFactory;
|
|
|
|
const isOptional = () => {
|
|
return dependencies.every(d => d.optional);
|
|
};
|
|
|
|
const errorOrWarningAndCallback = err => {
|
|
if (isOptional()) {
|
|
return warningAndCallback(err);
|
|
} else {
|
|
return errorAndCallback(err);
|
|
}
|
|
};
|
|
|
|
if (err) {
|
|
semaphore.release();
|
|
return errorOrWarningAndCallback(
|
|
new ModuleNotFoundError(module, err)
|
|
);
|
|
}
|
|
if (!dependentModule) {
|
|
semaphore.release();
|
|
return process.nextTick(callback);
|
|
}
|
|
if (currentProfile) {
|
|
afterFactory = Date.now();
|
|
currentProfile.factory = afterFactory - start;
|
|
}
|
|
|
|
const iterationDependencies = depend => {
|
|
for (let index = 0; index < depend.length; index++) {
|
|
const dep = depend[index];
|
|
dep.module = dependentModule;
|
|
dependentModule.addReason(module, dep);
|
|
}
|
|
};
|
|
|
|
const addModuleResult = this.addModule(
|
|
dependentModule,
|
|
cacheGroup
|
|
);
|
|
dependentModule = addModuleResult.module;
|
|
iterationDependencies(dependencies);
|
|
|
|
const afterBuild = () => {
|
|
if (recursive && addModuleResult.dependencies) {
|
|
this.processModuleDependencies(dependentModule, callback);
|
|
} else {
|
|
return callback();
|
|
}
|
|
};
|
|
|
|
if (addModuleResult.issuer) {
|
|
if (currentProfile) {
|
|
dependentModule.profile = currentProfile;
|
|
}
|
|
|
|
dependentModule.issuer = module;
|
|
} else {
|
|
if (this.profile) {
|
|
if (module.profile) {
|
|
const time = Date.now() - start;
|
|
if (
|
|
!module.profile.dependencies ||
|
|
time > module.profile.dependencies
|
|
) {
|
|
module.profile.dependencies = time;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if (addModuleResult.build) {
|
|
this.buildModule(
|
|
dependentModule,
|
|
isOptional(),
|
|
module,
|
|
dependencies,
|
|
err => {
|
|
if (err) {
|
|
semaphore.release();
|
|
return errorOrWarningAndCallback(err);
|
|
}
|
|
|
|
if (currentProfile) {
|
|
const afterBuilding = Date.now();
|
|
currentProfile.building = afterBuilding - afterFactory;
|
|
}
|
|
|
|
semaphore.release();
|
|
afterBuild();
|
|
}
|
|
);
|
|
} else {
|
|
semaphore.release();
|
|
this.waitForBuildingFinished(dependentModule, afterBuild);
|
|
}
|
|
}
|
|
);
|
|
});
|
|
},
|
|
err => {
|
|
// In V8, the Error objects keep a reference to the functions on the stack. These warnings &
|
|
// errors are created inside closures that keep a reference to the Compilation, so errors are
|
|
// leaking the Compilation object.
|
|
|
|
if (err) {
|
|
// eslint-disable-next-line no-self-assign
|
|
err.stack = err.stack;
|
|
return callback(err);
|
|
}
|
|
|
|
return process.nextTick(callback);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param {string} context context string path
|
|
* @param {Dependency} dependency dependency used to create Module chain
|
|
* @param {OnModuleCallback} onModule function invoked on modules creation
|
|
* @param {ModuleChainCallback} callback callback for when module chain is complete
|
|
* @returns {void} will throw if dependency instance is not a valid Dependency
|
|
*/
|
|
_addModuleChain(context, dependency, onModule, callback) {
|
|
const start = this.profile && Date.now();
|
|
const currentProfile = this.profile && {};
|
|
|
|
const errorAndCallback = this.bail
|
|
? err => {
|
|
callback(err);
|
|
}
|
|
: err => {
|
|
err.dependencies = [dependency];
|
|
this.errors.push(err);
|
|
callback();
|
|
};
|
|
|
|
if (
|
|
typeof dependency !== "object" ||
|
|
dependency === null ||
|
|
!dependency.constructor
|
|
) {
|
|
throw new Error("Parameter 'dependency' must be a Dependency");
|
|
}
|
|
const Dep = /** @type {DepConstructor} */ (dependency.constructor);
|
|
const moduleFactory = this.dependencyFactories.get(Dep);
|
|
if (!moduleFactory) {
|
|
throw new Error(
|
|
`No dependency factory available for this dependency type: ${dependency.constructor.name}`
|
|
);
|
|
}
|
|
|
|
this.semaphore.acquire(() => {
|
|
moduleFactory.create(
|
|
{
|
|
contextInfo: {
|
|
issuer: "",
|
|
compiler: this.compiler.name
|
|
},
|
|
context: context,
|
|
dependencies: [dependency]
|
|
},
|
|
(err, module) => {
|
|
if (err) {
|
|
this.semaphore.release();
|
|
return errorAndCallback(new EntryModuleNotFoundError(err));
|
|
}
|
|
|
|
let afterFactory;
|
|
|
|
if (currentProfile) {
|
|
afterFactory = Date.now();
|
|
currentProfile.factory = afterFactory - start;
|
|
}
|
|
|
|
const addModuleResult = this.addModule(module);
|
|
module = addModuleResult.module;
|
|
|
|
onModule(module);
|
|
|
|
dependency.module = module;
|
|
module.addReason(null, dependency);
|
|
|
|
const afterBuild = () => {
|
|
if (addModuleResult.dependencies) {
|
|
this.processModuleDependencies(module, err => {
|
|
if (err) return callback(err);
|
|
callback(null, module);
|
|
});
|
|
} else {
|
|
return callback(null, module);
|
|
}
|
|
};
|
|
|
|
if (addModuleResult.issuer) {
|
|
if (currentProfile) {
|
|
module.profile = currentProfile;
|
|
}
|
|
}
|
|
|
|
if (addModuleResult.build) {
|
|
this.buildModule(module, false, null, null, err => {
|
|
if (err) {
|
|
this.semaphore.release();
|
|
return errorAndCallback(err);
|
|
}
|
|
|
|
if (currentProfile) {
|
|
const afterBuilding = Date.now();
|
|
currentProfile.building = afterBuilding - afterFactory;
|
|
}
|
|
|
|
this.semaphore.release();
|
|
afterBuild();
|
|
});
|
|
} else {
|
|
this.semaphore.release();
|
|
this.waitForBuildingFinished(module, afterBuild);
|
|
}
|
|
}
|
|
);
|
|
});
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param {string} context context path for entry
|
|
* @param {Dependency} entry entry dependency being created
|
|
* @param {string} name name of entry
|
|
* @param {ModuleCallback} callback callback function
|
|
* @returns {void} returns
|
|
*/
|
|
addEntry(context, entry, name, callback) {
|
|
this.hooks.addEntry.call(entry, name);
|
|
|
|
const slot = {
|
|
name: name,
|
|
// TODO webpack 5 remove `request`
|
|
request: null,
|
|
module: null
|
|
};
|
|
|
|
if (entry instanceof ModuleDependency) {
|
|
slot.request = entry.request;
|
|
}
|
|
|
|
// TODO webpack 5: merge modules instead when multiple entry modules are supported
|
|
const idx = this._preparedEntrypoints.findIndex(slot => slot.name === name);
|
|
if (idx >= 0) {
|
|
// Overwrite existing entrypoint
|
|
this._preparedEntrypoints[idx] = slot;
|
|
} else {
|
|
this._preparedEntrypoints.push(slot);
|
|
}
|
|
this._addModuleChain(
|
|
context,
|
|
entry,
|
|
module => {
|
|
this.entries.push(module);
|
|
},
|
|
(err, module) => {
|
|
if (err) {
|
|
this.hooks.failedEntry.call(entry, name, err);
|
|
return callback(err);
|
|
}
|
|
|
|
if (module) {
|
|
slot.module = module;
|
|
} else {
|
|
const idx = this._preparedEntrypoints.indexOf(slot);
|
|
if (idx >= 0) {
|
|
this._preparedEntrypoints.splice(idx, 1);
|
|
}
|
|
}
|
|
this.hooks.succeedEntry.call(entry, name, module);
|
|
return callback(null, module);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param {string} context context path string
|
|
* @param {Dependency} dependency dep used to create module
|
|
* @param {ModuleCallback} callback module callback sending module up a level
|
|
* @returns {void}
|
|
*/
|
|
prefetch(context, dependency, callback) {
|
|
this._addModuleChain(
|
|
context,
|
|
dependency,
|
|
module => {
|
|
module.prefetched = true;
|
|
},
|
|
callback
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module module to be rebuilt
|
|
* @param {Callback} thisCallback callback when module finishes rebuilding
|
|
* @returns {void}
|
|
*/
|
|
rebuildModule(module, thisCallback) {
|
|
let callbackList = this._rebuildingModules.get(module);
|
|
if (callbackList) {
|
|
callbackList.push(thisCallback);
|
|
return;
|
|
}
|
|
this._rebuildingModules.set(module, (callbackList = [thisCallback]));
|
|
|
|
const callback = err => {
|
|
this._rebuildingModules.delete(module);
|
|
for (const cb of callbackList) {
|
|
cb(err);
|
|
}
|
|
};
|
|
|
|
this.hooks.rebuildModule.call(module);
|
|
const oldDependencies = module.dependencies.slice();
|
|
const oldVariables = module.variables.slice();
|
|
const oldBlocks = module.blocks.slice();
|
|
module.unbuild();
|
|
this.buildModule(module, false, module, null, err => {
|
|
if (err) {
|
|
this.hooks.finishRebuildingModule.call(module);
|
|
return callback(err);
|
|
}
|
|
|
|
this.processModuleDependencies(module, err => {
|
|
if (err) return callback(err);
|
|
this.removeReasonsOfDependencyBlock(module, {
|
|
dependencies: oldDependencies,
|
|
variables: oldVariables,
|
|
blocks: oldBlocks
|
|
});
|
|
this.hooks.finishRebuildingModule.call(module);
|
|
callback();
|
|
});
|
|
});
|
|
}
|
|
|
|
finish(callback) {
|
|
const modules = this.modules;
|
|
this.hooks.finishModules.callAsync(modules, err => {
|
|
if (err) return callback(err);
|
|
|
|
for (let index = 0; index < modules.length; index++) {
|
|
const module = modules[index];
|
|
this.reportDependencyErrorsAndWarnings(module, [module]);
|
|
}
|
|
|
|
callback();
|
|
});
|
|
}
|
|
|
|
unseal() {
|
|
this.hooks.unseal.call();
|
|
this.chunks.length = 0;
|
|
this.chunkGroups.length = 0;
|
|
this.namedChunks.clear();
|
|
this.namedChunkGroups.clear();
|
|
this.additionalChunkAssets.length = 0;
|
|
this.assets = {};
|
|
this.assetsInfo.clear();
|
|
for (const module of this.modules) {
|
|
module.unseal();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Callback} callback signals when the seal method is finishes
|
|
* @returns {void}
|
|
*/
|
|
seal(callback) {
|
|
this.hooks.seal.call();
|
|
|
|
while (
|
|
this.hooks.optimizeDependenciesBasic.call(this.modules) ||
|
|
this.hooks.optimizeDependencies.call(this.modules) ||
|
|
this.hooks.optimizeDependenciesAdvanced.call(this.modules)
|
|
) {
|
|
/* empty */
|
|
}
|
|
this.hooks.afterOptimizeDependencies.call(this.modules);
|
|
|
|
this.hooks.beforeChunks.call();
|
|
for (const preparedEntrypoint of this._preparedEntrypoints) {
|
|
const module = preparedEntrypoint.module;
|
|
const name = preparedEntrypoint.name;
|
|
const chunk = this.addChunk(name);
|
|
const entrypoint = new Entrypoint(name);
|
|
entrypoint.setRuntimeChunk(chunk);
|
|
entrypoint.addOrigin(null, name, preparedEntrypoint.request);
|
|
this.namedChunkGroups.set(name, entrypoint);
|
|
this.entrypoints.set(name, entrypoint);
|
|
this.chunkGroups.push(entrypoint);
|
|
|
|
GraphHelpers.connectChunkGroupAndChunk(entrypoint, chunk);
|
|
GraphHelpers.connectChunkAndModule(chunk, module);
|
|
|
|
chunk.entryModule = module;
|
|
chunk.name = name;
|
|
|
|
this.assignDepth(module);
|
|
}
|
|
buildChunkGraph(
|
|
this,
|
|
/** @type {Entrypoint[]} */ (this.chunkGroups.slice())
|
|
);
|
|
this.sortModules(this.modules);
|
|
this.hooks.afterChunks.call(this.chunks);
|
|
|
|
this.hooks.optimize.call();
|
|
|
|
while (
|
|
this.hooks.optimizeModulesBasic.call(this.modules) ||
|
|
this.hooks.optimizeModules.call(this.modules) ||
|
|
this.hooks.optimizeModulesAdvanced.call(this.modules)
|
|
) {
|
|
/* empty */
|
|
}
|
|
this.hooks.afterOptimizeModules.call(this.modules);
|
|
|
|
while (
|
|
this.hooks.optimizeChunksBasic.call(this.chunks, this.chunkGroups) ||
|
|
this.hooks.optimizeChunks.call(this.chunks, this.chunkGroups) ||
|
|
this.hooks.optimizeChunksAdvanced.call(this.chunks, this.chunkGroups)
|
|
) {
|
|
/* empty */
|
|
}
|
|
this.hooks.afterOptimizeChunks.call(this.chunks, this.chunkGroups);
|
|
|
|
this.hooks.optimizeTree.callAsync(this.chunks, this.modules, err => {
|
|
if (err) {
|
|
return callback(err);
|
|
}
|
|
|
|
this.hooks.afterOptimizeTree.call(this.chunks, this.modules);
|
|
|
|
while (
|
|
this.hooks.optimizeChunkModulesBasic.call(this.chunks, this.modules) ||
|
|
this.hooks.optimizeChunkModules.call(this.chunks, this.modules) ||
|
|
this.hooks.optimizeChunkModulesAdvanced.call(this.chunks, this.modules)
|
|
) {
|
|
/* empty */
|
|
}
|
|
this.hooks.afterOptimizeChunkModules.call(this.chunks, this.modules);
|
|
|
|
const shouldRecord = this.hooks.shouldRecord.call() !== false;
|
|
|
|
this.hooks.reviveModules.call(this.modules, this.records);
|
|
this.hooks.optimizeModuleOrder.call(this.modules);
|
|
this.hooks.advancedOptimizeModuleOrder.call(this.modules);
|
|
this.hooks.beforeModuleIds.call(this.modules);
|
|
this.hooks.moduleIds.call(this.modules);
|
|
this.applyModuleIds();
|
|
this.hooks.optimizeModuleIds.call(this.modules);
|
|
this.hooks.afterOptimizeModuleIds.call(this.modules);
|
|
|
|
this.sortItemsWithModuleIds();
|
|
|
|
this.hooks.reviveChunks.call(this.chunks, this.records);
|
|
this.hooks.optimizeChunkOrder.call(this.chunks);
|
|
this.hooks.beforeChunkIds.call(this.chunks);
|
|
this.applyChunkIds();
|
|
this.hooks.optimizeChunkIds.call(this.chunks);
|
|
this.hooks.afterOptimizeChunkIds.call(this.chunks);
|
|
|
|
this.sortItemsWithChunkIds();
|
|
|
|
if (shouldRecord) {
|
|
this.hooks.recordModules.call(this.modules, this.records);
|
|
this.hooks.recordChunks.call(this.chunks, this.records);
|
|
}
|
|
|
|
this.hooks.beforeHash.call();
|
|
this.createHash();
|
|
this.hooks.afterHash.call();
|
|
|
|
if (shouldRecord) {
|
|
this.hooks.recordHash.call(this.records);
|
|
}
|
|
|
|
this.hooks.beforeModuleAssets.call();
|
|
this.createModuleAssets();
|
|
if (this.hooks.shouldGenerateChunkAssets.call() !== false) {
|
|
this.hooks.beforeChunkAssets.call();
|
|
this.createChunkAssets();
|
|
}
|
|
this.hooks.additionalChunkAssets.call(this.chunks);
|
|
this.summarizeDependencies();
|
|
if (shouldRecord) {
|
|
this.hooks.record.call(this, this.records);
|
|
}
|
|
|
|
this.hooks.additionalAssets.callAsync(err => {
|
|
if (err) {
|
|
return callback(err);
|
|
}
|
|
this.hooks.optimizeChunkAssets.callAsync(this.chunks, err => {
|
|
if (err) {
|
|
return callback(err);
|
|
}
|
|
this.hooks.afterOptimizeChunkAssets.call(this.chunks);
|
|
this.hooks.optimizeAssets.callAsync(this.assets, err => {
|
|
if (err) {
|
|
return callback(err);
|
|
}
|
|
this.hooks.afterOptimizeAssets.call(this.assets);
|
|
if (this.hooks.needAdditionalSeal.call()) {
|
|
this.unseal();
|
|
return this.seal(callback);
|
|
}
|
|
return this.hooks.afterSeal.callAsync(callback);
|
|
});
|
|
});
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @param {Module[]} modules the modules array on compilation to perform the sort for
|
|
* @returns {void}
|
|
*/
|
|
sortModules(modules) {
|
|
// TODO webpack 5: this should only be enabled when `moduleIds: "natural"`
|
|
// TODO move it into a plugin (NaturalModuleIdsPlugin) and use this in WebpackOptionsApply
|
|
// TODO remove this method
|
|
modules.sort(byIndexOrIdentifier);
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module moulde to report from
|
|
* @param {DependenciesBlock[]} blocks blocks to report from
|
|
* @returns {void}
|
|
*/
|
|
reportDependencyErrorsAndWarnings(module, blocks) {
|
|
for (let indexBlock = 0; indexBlock < blocks.length; indexBlock++) {
|
|
const block = blocks[indexBlock];
|
|
const dependencies = block.dependencies;
|
|
|
|
for (let indexDep = 0; indexDep < dependencies.length; indexDep++) {
|
|
const d = dependencies[indexDep];
|
|
|
|
const warnings = d.getWarnings();
|
|
if (warnings) {
|
|
for (let indexWar = 0; indexWar < warnings.length; indexWar++) {
|
|
const w = warnings[indexWar];
|
|
|
|
const warning = new ModuleDependencyWarning(module, w, d.loc);
|
|
this.warnings.push(warning);
|
|
}
|
|
}
|
|
const errors = d.getErrors();
|
|
if (errors) {
|
|
for (let indexErr = 0; indexErr < errors.length; indexErr++) {
|
|
const e = errors[indexErr];
|
|
|
|
const error = new ModuleDependencyError(module, e, d.loc);
|
|
this.errors.push(error);
|
|
}
|
|
}
|
|
}
|
|
|
|
this.reportDependencyErrorsAndWarnings(module, block.blocks);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {TODO} groupOptions options for the chunk group
|
|
* @param {Module} module the module the references the chunk group
|
|
* @param {DependencyLocation} loc the location from with the chunk group is referenced (inside of module)
|
|
* @param {string} request the request from which the the chunk group is referenced
|
|
* @returns {ChunkGroup} the new or existing chunk group
|
|
*/
|
|
addChunkInGroup(groupOptions, module, loc, request) {
|
|
if (typeof groupOptions === "string") {
|
|
groupOptions = { name: groupOptions };
|
|
}
|
|
const name = groupOptions.name;
|
|
if (name) {
|
|
const chunkGroup = this.namedChunkGroups.get(name);
|
|
if (chunkGroup !== undefined) {
|
|
chunkGroup.addOptions(groupOptions);
|
|
if (module) {
|
|
chunkGroup.addOrigin(module, loc, request);
|
|
}
|
|
return chunkGroup;
|
|
}
|
|
}
|
|
const chunkGroup = new ChunkGroup(groupOptions);
|
|
if (module) chunkGroup.addOrigin(module, loc, request);
|
|
const chunk = this.addChunk(name);
|
|
|
|
GraphHelpers.connectChunkGroupAndChunk(chunkGroup, chunk);
|
|
|
|
this.chunkGroups.push(chunkGroup);
|
|
if (name) {
|
|
this.namedChunkGroups.set(name, chunkGroup);
|
|
}
|
|
return chunkGroup;
|
|
}
|
|
|
|
/**
|
|
* This method first looks to see if a name is provided for a new chunk,
|
|
* and first looks to see if any named chunks already exist and reuse that chunk instead.
|
|
*
|
|
* @param {string=} name optional chunk name to be provided
|
|
* @returns {Chunk} create a chunk (invoked during seal event)
|
|
*/
|
|
addChunk(name) {
|
|
if (name) {
|
|
const chunk = this.namedChunks.get(name);
|
|
if (chunk !== undefined) {
|
|
return chunk;
|
|
}
|
|
}
|
|
const chunk = new Chunk(name);
|
|
this.chunks.push(chunk);
|
|
if (name) {
|
|
this.namedChunks.set(name, chunk);
|
|
}
|
|
return chunk;
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module module to assign depth
|
|
* @returns {void}
|
|
*/
|
|
assignDepth(module) {
|
|
const queue = new Set([module]);
|
|
let depth;
|
|
|
|
module.depth = 0;
|
|
|
|
/**
|
|
* @param {Module} module module for processeing
|
|
* @returns {void}
|
|
*/
|
|
const enqueueJob = module => {
|
|
const d = module.depth;
|
|
if (typeof d === "number" && d <= depth) return;
|
|
queue.add(module);
|
|
module.depth = depth;
|
|
};
|
|
|
|
/**
|
|
* @param {Dependency} dependency dependency to assign depth to
|
|
* @returns {void}
|
|
*/
|
|
const assignDepthToDependency = dependency => {
|
|
if (dependency.module) {
|
|
enqueueJob(dependency.module);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @param {DependenciesBlock} block block to assign depth to
|
|
* @returns {void}
|
|
*/
|
|
const assignDepthToDependencyBlock = block => {
|
|
if (block.variables) {
|
|
iterationBlockVariable(block.variables, assignDepthToDependency);
|
|
}
|
|
|
|
if (block.dependencies) {
|
|
iterationOfArrayCallback(block.dependencies, assignDepthToDependency);
|
|
}
|
|
|
|
if (block.blocks) {
|
|
iterationOfArrayCallback(block.blocks, assignDepthToDependencyBlock);
|
|
}
|
|
};
|
|
|
|
for (module of queue) {
|
|
queue.delete(module);
|
|
depth = module.depth;
|
|
|
|
depth++;
|
|
assignDepthToDependencyBlock(module);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module the module containing the dependency
|
|
* @param {Dependency} dependency the dependency
|
|
* @returns {DependencyReference} a reference for the dependency
|
|
*/
|
|
getDependencyReference(module, dependency) {
|
|
// TODO remove dep.getReference existence check in webpack 5
|
|
if (typeof dependency.getReference !== "function") return null;
|
|
const ref = dependency.getReference();
|
|
if (!ref) return null;
|
|
return this.hooks.dependencyReference.call(ref, dependency, module);
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param {Module} module module relationship for removal
|
|
* @param {DependenciesBlockLike} block //TODO: good description
|
|
* @returns {void}
|
|
*/
|
|
removeReasonsOfDependencyBlock(module, block) {
|
|
const iteratorDependency = d => {
|
|
if (!d.module) {
|
|
return;
|
|
}
|
|
if (d.module.removeReason(module, d)) {
|
|
for (const chunk of d.module.chunksIterable) {
|
|
this.patchChunksAfterReasonRemoval(d.module, chunk);
|
|
}
|
|
}
|
|
};
|
|
|
|
if (block.blocks) {
|
|
iterationOfArrayCallback(block.blocks, block =>
|
|
this.removeReasonsOfDependencyBlock(module, block)
|
|
);
|
|
}
|
|
|
|
if (block.dependencies) {
|
|
iterationOfArrayCallback(block.dependencies, iteratorDependency);
|
|
}
|
|
|
|
if (block.variables) {
|
|
iterationBlockVariable(block.variables, iteratorDependency);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Module} module module to patch tie
|
|
* @param {Chunk} chunk chunk to patch tie
|
|
* @returns {void}
|
|
*/
|
|
patchChunksAfterReasonRemoval(module, chunk) {
|
|
if (!module.hasReasons()) {
|
|
this.removeReasonsOfDependencyBlock(module, module);
|
|
}
|
|
if (!module.hasReasonForChunk(chunk)) {
|
|
if (module.removeChunk(chunk)) {
|
|
this.removeChunkFromDependencies(module, chunk);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param {DependenciesBlock} block block tie for Chunk
|
|
* @param {Chunk} chunk chunk to remove from dep
|
|
* @returns {void}
|
|
*/
|
|
removeChunkFromDependencies(block, chunk) {
|
|
const iteratorDependency = d => {
|
|
if (!d.module) {
|
|
return;
|
|
}
|
|
this.patchChunksAfterReasonRemoval(d.module, chunk);
|
|
};
|
|
|
|
const blocks = block.blocks;
|
|
for (let indexBlock = 0; indexBlock < blocks.length; indexBlock++) {
|
|
const asyncBlock = blocks[indexBlock];
|
|
// Grab all chunks from the first Block's AsyncDepBlock
|
|
const chunks = asyncBlock.chunkGroup.chunks;
|
|
// For each chunk in chunkGroup
|
|
for (let indexChunk = 0; indexChunk < chunks.length; indexChunk++) {
|
|
const iteratedChunk = chunks[indexChunk];
|
|
asyncBlock.chunkGroup.removeChunk(iteratedChunk);
|
|
asyncBlock.chunkGroup.removeParent(iteratedChunk);
|
|
// Recurse
|
|
this.removeChunkFromDependencies(block, iteratedChunk);
|
|
}
|
|
}
|
|
|
|
if (block.dependencies) {
|
|
iterationOfArrayCallback(block.dependencies, iteratorDependency);
|
|
}
|
|
|
|
if (block.variables) {
|
|
iterationBlockVariable(block.variables, iteratorDependency);
|
|
}
|
|
}
|
|
|
|
applyModuleIds() {
|
|
const unusedIds = [];
|
|
let nextFreeModuleId = 0;
|
|
const usedIds = new Set();
|
|
if (this.usedModuleIds) {
|
|
for (const id of this.usedModuleIds) {
|
|
usedIds.add(id);
|
|
}
|
|
}
|
|
|
|
const modules1 = this.modules;
|
|
for (let indexModule1 = 0; indexModule1 < modules1.length; indexModule1++) {
|
|
const module1 = modules1[indexModule1];
|
|
if (module1.id !== null) {
|
|
usedIds.add(module1.id);
|
|
}
|
|
}
|
|
|
|
if (usedIds.size > 0) {
|
|
let usedIdMax = -1;
|
|
for (const usedIdKey of usedIds) {
|
|
if (typeof usedIdKey !== "number") {
|
|
continue;
|
|
}
|
|
|
|
usedIdMax = Math.max(usedIdMax, usedIdKey);
|
|
}
|
|
|
|
let lengthFreeModules = (nextFreeModuleId = usedIdMax + 1);
|
|
|
|
while (lengthFreeModules--) {
|
|
if (!usedIds.has(lengthFreeModules)) {
|
|
unusedIds.push(lengthFreeModules);
|
|
}
|
|
}
|
|
}
|
|
|
|
const modules2 = this.modules;
|
|
for (let indexModule2 = 0; indexModule2 < modules2.length; indexModule2++) {
|
|
const module2 = modules2[indexModule2];
|
|
if (module2.id === null) {
|
|
if (unusedIds.length > 0) {
|
|
module2.id = unusedIds.pop();
|
|
} else {
|
|
module2.id = nextFreeModuleId++;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
applyChunkIds() {
|
|
/** @type {Set<number>} */
|
|
const usedIds = new Set();
|
|
|
|
// Get used ids from usedChunkIds property (i. e. from records)
|
|
if (this.usedChunkIds) {
|
|
for (const id of this.usedChunkIds) {
|
|
if (typeof id !== "number") {
|
|
continue;
|
|
}
|
|
|
|
usedIds.add(id);
|
|
}
|
|
}
|
|
|
|
// Get used ids from existing chunks
|
|
const chunks = this.chunks;
|
|
for (let indexChunk = 0; indexChunk < chunks.length; indexChunk++) {
|
|
const chunk = chunks[indexChunk];
|
|
const usedIdValue = chunk.id;
|
|
|
|
if (typeof usedIdValue !== "number") {
|
|
continue;
|
|
}
|
|
|
|
usedIds.add(usedIdValue);
|
|
}
|
|
|
|
// Calculate maximum assigned chunk id
|
|
let nextFreeChunkId = -1;
|
|
for (const id of usedIds) {
|
|
nextFreeChunkId = Math.max(nextFreeChunkId, id);
|
|
}
|
|
nextFreeChunkId++;
|
|
|
|
// Determine free chunk ids from 0 to maximum
|
|
/** @type {number[]} */
|
|
const unusedIds = [];
|
|
if (nextFreeChunkId > 0) {
|
|
let index = nextFreeChunkId;
|
|
while (index--) {
|
|
if (!usedIds.has(index)) {
|
|
unusedIds.push(index);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Assign ids to chunk which has no id
|
|
for (let indexChunk = 0; indexChunk < chunks.length; indexChunk++) {
|
|
const chunk = chunks[indexChunk];
|
|
if (chunk.id === null) {
|
|
if (unusedIds.length > 0) {
|
|
chunk.id = unusedIds.pop();
|
|
} else {
|
|
chunk.id = nextFreeChunkId++;
|
|
}
|
|
}
|
|
if (!chunk.ids) {
|
|
chunk.ids = [chunk.id];
|
|
}
|
|
}
|
|
}
|
|
|
|
sortItemsWithModuleIds() {
|
|
this.modules.sort(byIdOrIdentifier);
|
|
|
|
const modules = this.modules;
|
|
for (let indexModule = 0; indexModule < modules.length; indexModule++) {
|
|
modules[indexModule].sortItems(false);
|
|
}
|
|
|
|
const chunks = this.chunks;
|
|
for (let indexChunk = 0; indexChunk < chunks.length; indexChunk++) {
|
|
chunks[indexChunk].sortItems();
|
|
}
|
|
|
|
chunks.sort((a, b) => a.compareTo(b));
|
|
}
|
|
|
|
sortItemsWithChunkIds() {
|
|
for (const chunkGroup of this.chunkGroups) {
|
|
chunkGroup.sortItems();
|
|
}
|
|
|
|
this.chunks.sort(byId);
|
|
|
|
for (
|
|
let indexModule = 0;
|
|
indexModule < this.modules.length;
|
|
indexModule++
|
|
) {
|
|
this.modules[indexModule].sortItems(true);
|
|
}
|
|
|
|
const chunks = this.chunks;
|
|
for (let indexChunk = 0; indexChunk < chunks.length; indexChunk++) {
|
|
chunks[indexChunk].sortItems();
|
|
}
|
|
|
|
/**
|
|
* Used to sort errors and warnings in compilation. this.warnings, and
|
|
* this.errors contribute to the compilation hash and therefore should be
|
|
* updated whenever other references (having a chunk id) are sorted. This preserves the hash
|
|
* integrity
|
|
*
|
|
* @param {WebpackError} a first WebpackError instance (including subclasses)
|
|
* @param {WebpackError} b second WebpackError instance (including subclasses)
|
|
* @returns {-1|0|1} sort order index
|
|
*/
|
|
const byMessage = (a, b) => {
|
|
const ma = `${a.message}`;
|
|
const mb = `${b.message}`;
|
|
if (ma < mb) return -1;
|
|
if (mb < ma) return 1;
|
|
return 0;
|
|
};
|
|
|
|
this.errors.sort(byMessage);
|
|
this.warnings.sort(byMessage);
|
|
this.children.sort(byNameOrHash);
|
|
}
|
|
|
|
summarizeDependencies() {
|
|
this.fileDependencies = new SortableSet(this.compilationDependencies);
|
|
this.contextDependencies = new SortableSet();
|
|
this.missingDependencies = new SortableSet();
|
|
|
|
for (
|
|
let indexChildren = 0;
|
|
indexChildren < this.children.length;
|
|
indexChildren++
|
|
) {
|
|
const child = this.children[indexChildren];
|
|
|
|
addAllToSet(this.fileDependencies, child.fileDependencies);
|
|
addAllToSet(this.contextDependencies, child.contextDependencies);
|
|
addAllToSet(this.missingDependencies, child.missingDependencies);
|
|
}
|
|
|
|
for (
|
|
let indexModule = 0;
|
|
indexModule < this.modules.length;
|
|
indexModule++
|
|
) {
|
|
const module = this.modules[indexModule];
|
|
|
|
if (module.buildInfo.fileDependencies) {
|
|
addAllToSet(this.fileDependencies, module.buildInfo.fileDependencies);
|
|
}
|
|
if (module.buildInfo.contextDependencies) {
|
|
addAllToSet(
|
|
this.contextDependencies,
|
|
module.buildInfo.contextDependencies
|
|
);
|
|
}
|
|
}
|
|
for (const error of this.errors) {
|
|
if (
|
|
typeof error.missing === "object" &&
|
|
error.missing &&
|
|
error.missing[Symbol.iterator]
|
|
) {
|
|
addAllToSet(this.missingDependencies, error.missing);
|
|
}
|
|
}
|
|
this.fileDependencies.sort();
|
|
this.contextDependencies.sort();
|
|
this.missingDependencies.sort();
|
|
}
|
|
|
|
createHash() {
|
|
const outputOptions = this.outputOptions;
|
|
const hashFunction = outputOptions.hashFunction;
|
|
const hashDigest = outputOptions.hashDigest;
|
|
const hashDigestLength = outputOptions.hashDigestLength;
|
|
const hash = createHash(hashFunction);
|
|
if (outputOptions.hashSalt) {
|
|
hash.update(outputOptions.hashSalt);
|
|
}
|
|
this.mainTemplate.updateHash(hash);
|
|
this.chunkTemplate.updateHash(hash);
|
|
for (const key of Object.keys(this.moduleTemplates).sort()) {
|
|
this.moduleTemplates[key].updateHash(hash);
|
|
}
|
|
for (const child of this.children) {
|
|
hash.update(child.hash);
|
|
}
|
|
for (const warning of this.warnings) {
|
|
hash.update(`${warning.message}`);
|
|
}
|
|
for (const error of this.errors) {
|
|
hash.update(`${error.message}`);
|
|
}
|
|
const modules = this.modules;
|
|
for (let i = 0; i < modules.length; i++) {
|
|
const module = modules[i];
|
|
const moduleHash = createHash(hashFunction);
|
|
module.updateHash(moduleHash);
|
|
module.hash = /** @type {string} */ (moduleHash.digest(hashDigest));
|
|
module.renderedHash = module.hash.substr(0, hashDigestLength);
|
|
}
|
|
// clone needed as sort below is inplace mutation
|
|
const chunks = this.chunks.slice();
|
|
/**
|
|
* sort here will bring all "falsy" values to the beginning
|
|
* this is needed as the "hasRuntime()" chunks are dependent on the
|
|
* hashes of the non-runtime chunks.
|
|
*/
|
|
chunks.sort((a, b) => {
|
|
const aEntry = a.hasRuntime();
|
|
const bEntry = b.hasRuntime();
|
|
if (aEntry && !bEntry) return 1;
|
|
if (!aEntry && bEntry) return -1;
|
|
return byId(a, b);
|
|
});
|
|
for (let i = 0; i < chunks.length; i++) {
|
|
const chunk = chunks[i];
|
|
const chunkHash = createHash(hashFunction);
|
|
try {
|
|
if (outputOptions.hashSalt) {
|
|
chunkHash.update(outputOptions.hashSalt);
|
|
}
|
|
chunk.updateHash(chunkHash);
|
|
const template = chunk.hasRuntime()
|
|
? this.mainTemplate
|
|
: this.chunkTemplate;
|
|
template.updateHashForChunk(
|
|
chunkHash,
|
|
chunk,
|
|
this.moduleTemplates.javascript,
|
|
this.dependencyTemplates
|
|
);
|
|
this.hooks.chunkHash.call(chunk, chunkHash);
|
|
chunk.hash = /** @type {string} */ (chunkHash.digest(hashDigest));
|
|
hash.update(chunk.hash);
|
|
chunk.renderedHash = chunk.hash.substr(0, hashDigestLength);
|
|
this.hooks.contentHash.call(chunk);
|
|
} catch (err) {
|
|
this.errors.push(new ChunkRenderError(chunk, "", err));
|
|
}
|
|
}
|
|
this.fullHash = /** @type {string} */ (hash.digest(hashDigest));
|
|
this.hash = this.fullHash.substr(0, hashDigestLength);
|
|
}
|
|
|
|
/**
|
|
* @param {string} update extra information
|
|
* @returns {void}
|
|
*/
|
|
modifyHash(update) {
|
|
const outputOptions = this.outputOptions;
|
|
const hashFunction = outputOptions.hashFunction;
|
|
const hashDigest = outputOptions.hashDigest;
|
|
const hashDigestLength = outputOptions.hashDigestLength;
|
|
const hash = createHash(hashFunction);
|
|
hash.update(this.fullHash);
|
|
hash.update(update);
|
|
this.fullHash = /** @type {string} */ (hash.digest(hashDigest));
|
|
this.hash = this.fullHash.substr(0, hashDigestLength);
|
|
}
|
|
|
|
/**
|
|
* @param {string} file file name
|
|
* @param {Source} source asset source
|
|
* @param {AssetInfo} assetInfo extra asset information
|
|
* @returns {void}
|
|
*/
|
|
emitAsset(file, source, assetInfo = {}) {
|
|
if (this.assets[file]) {
|
|
if (!isSourceEqual(this.assets[file], source)) {
|
|
// TODO webpack 5: make this an error instead
|
|
this.warnings.push(
|
|
new WebpackError(
|
|
`Conflict: Multiple assets emit different content to the same filename ${file}`
|
|
)
|
|
);
|
|
this.assets[file] = source;
|
|
this.assetsInfo.set(file, assetInfo);
|
|
return;
|
|
}
|
|
const oldInfo = this.assetsInfo.get(file);
|
|
this.assetsInfo.set(file, Object.assign({}, oldInfo, assetInfo));
|
|
return;
|
|
}
|
|
this.assets[file] = source;
|
|
this.assetsInfo.set(file, assetInfo);
|
|
}
|
|
|
|
/**
|
|
* @param {string} file file name
|
|
* @param {Source | function(Source): Source} newSourceOrFunction new asset source or function converting old to new
|
|
* @param {AssetInfo | function(AssetInfo | undefined): AssetInfo} assetInfoUpdateOrFunction new asset info or function converting old to new
|
|
*/
|
|
updateAsset(
|
|
file,
|
|
newSourceOrFunction,
|
|
assetInfoUpdateOrFunction = undefined
|
|
) {
|
|
if (!this.assets[file]) {
|
|
throw new Error(
|
|
`Called Compilation.updateAsset for not existing filename ${file}`
|
|
);
|
|
}
|
|
if (typeof newSourceOrFunction === "function") {
|
|
this.assets[file] = newSourceOrFunction(this.assets[file]);
|
|
} else {
|
|
this.assets[file] = newSourceOrFunction;
|
|
}
|
|
if (assetInfoUpdateOrFunction !== undefined) {
|
|
const oldInfo = this.assetsInfo.get(file);
|
|
if (typeof assetInfoUpdateOrFunction === "function") {
|
|
this.assetsInfo.set(file, assetInfoUpdateOrFunction(oldInfo || {}));
|
|
} else {
|
|
this.assetsInfo.set(
|
|
file,
|
|
Object.assign({}, oldInfo, assetInfoUpdateOrFunction)
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
getAssets() {
|
|
/** @type {Asset[]} */
|
|
const array = [];
|
|
for (const assetName of Object.keys(this.assets)) {
|
|
if (Object.prototype.hasOwnProperty.call(this.assets, assetName)) {
|
|
array.push({
|
|
name: assetName,
|
|
source: this.assets[assetName],
|
|
info: this.assetsInfo.get(assetName) || {}
|
|
});
|
|
}
|
|
}
|
|
return array;
|
|
}
|
|
|
|
/**
|
|
* @param {string} name the name of the asset
|
|
* @returns {Asset | undefined} the asset or undefined when not found
|
|
*/
|
|
getAsset(name) {
|
|
if (!Object.prototype.hasOwnProperty.call(this.assets, name))
|
|
return undefined;
|
|
return {
|
|
name,
|
|
source: this.assets[name],
|
|
info: this.assetsInfo.get(name) || {}
|
|
};
|
|
}
|
|
|
|
createModuleAssets() {
|
|
for (let i = 0; i < this.modules.length; i++) {
|
|
const module = this.modules[i];
|
|
if (module.buildInfo.assets) {
|
|
const assetsInfo = module.buildInfo.assetsInfo;
|
|
for (const assetName of Object.keys(module.buildInfo.assets)) {
|
|
const fileName = this.getPath(assetName);
|
|
this.emitAsset(
|
|
fileName,
|
|
module.buildInfo.assets[assetName],
|
|
assetsInfo ? assetsInfo.get(assetName) : undefined
|
|
);
|
|
this.hooks.moduleAsset.call(module, fileName);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
createChunkAssets() {
|
|
const outputOptions = this.outputOptions;
|
|
const cachedSourceMap = new Map();
|
|
/** @type {Map<string, {hash: string, source: Source, chunk: Chunk}>} */
|
|
const alreadyWrittenFiles = new Map();
|
|
for (let i = 0; i < this.chunks.length; i++) {
|
|
const chunk = this.chunks[i];
|
|
chunk.files = [];
|
|
let source;
|
|
let file;
|
|
let filenameTemplate;
|
|
try {
|
|
const template = chunk.hasRuntime()
|
|
? this.mainTemplate
|
|
: this.chunkTemplate;
|
|
const manifest = template.getRenderManifest({
|
|
chunk,
|
|
hash: this.hash,
|
|
fullHash: this.fullHash,
|
|
outputOptions,
|
|
moduleTemplates: this.moduleTemplates,
|
|
dependencyTemplates: this.dependencyTemplates
|
|
}); // [{ render(), filenameTemplate, pathOptions, identifier, hash }]
|
|
for (const fileManifest of manifest) {
|
|
const cacheName = fileManifest.identifier;
|
|
const usedHash = fileManifest.hash;
|
|
filenameTemplate = fileManifest.filenameTemplate;
|
|
const pathAndInfo = this.getPathWithInfo(
|
|
filenameTemplate,
|
|
fileManifest.pathOptions
|
|
);
|
|
file = pathAndInfo.path;
|
|
const assetInfo = pathAndInfo.info;
|
|
|
|
// check if the same filename was already written by another chunk
|
|
const alreadyWritten = alreadyWrittenFiles.get(file);
|
|
if (alreadyWritten !== undefined) {
|
|
if (alreadyWritten.hash === usedHash) {
|
|
if (this.cache) {
|
|
this.cache[cacheName] = {
|
|
hash: usedHash,
|
|
source: alreadyWritten.source
|
|
};
|
|
}
|
|
chunk.files.push(file);
|
|
this.hooks.chunkAsset.call(chunk, file);
|
|
continue;
|
|
} else {
|
|
throw new Error(
|
|
`Conflict: Multiple chunks emit assets to the same filename ${file}` +
|
|
` (chunks ${alreadyWritten.chunk.id} and ${chunk.id})`
|
|
);
|
|
}
|
|
}
|
|
if (
|
|
this.cache &&
|
|
this.cache[cacheName] &&
|
|
this.cache[cacheName].hash === usedHash
|
|
) {
|
|
source = this.cache[cacheName].source;
|
|
} else {
|
|
source = fileManifest.render();
|
|
// Ensure that source is a cached source to avoid additional cost because of repeated access
|
|
if (!(source instanceof CachedSource)) {
|
|
const cacheEntry = cachedSourceMap.get(source);
|
|
if (cacheEntry) {
|
|
source = cacheEntry;
|
|
} else {
|
|
const cachedSource = new CachedSource(source);
|
|
cachedSourceMap.set(source, cachedSource);
|
|
source = cachedSource;
|
|
}
|
|
}
|
|
if (this.cache) {
|
|
this.cache[cacheName] = {
|
|
hash: usedHash,
|
|
source
|
|
};
|
|
}
|
|
}
|
|
this.emitAsset(file, source, assetInfo);
|
|
chunk.files.push(file);
|
|
this.hooks.chunkAsset.call(chunk, file);
|
|
alreadyWrittenFiles.set(file, {
|
|
hash: usedHash,
|
|
source,
|
|
chunk
|
|
});
|
|
}
|
|
} catch (err) {
|
|
this.errors.push(
|
|
new ChunkRenderError(chunk, file || filenameTemplate, err)
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} filename used to get asset path with hash
|
|
* @param {TODO=} data // TODO: figure out this param type
|
|
* @returns {string} interpolated path
|
|
*/
|
|
getPath(filename, data) {
|
|
data = data || {};
|
|
data.hash = data.hash || this.hash;
|
|
return this.mainTemplate.getAssetPath(filename, data);
|
|
}
|
|
|
|
/**
|
|
* @param {string} filename used to get asset path with hash
|
|
* @param {TODO=} data // TODO: figure out this param type
|
|
* @returns {{ path: string, info: AssetInfo }} interpolated path and asset info
|
|
*/
|
|
getPathWithInfo(filename, data) {
|
|
data = data || {};
|
|
data.hash = data.hash || this.hash;
|
|
return this.mainTemplate.getAssetPathWithInfo(filename, data);
|
|
}
|
|
|
|
/**
|
|
* This function allows you to run another instance of webpack inside of webpack however as
|
|
* a child with different settings and configurations (if desired) applied. It copies all hooks, plugins
|
|
* from parent (or top level compiler) and creates a child Compilation
|
|
*
|
|
* @param {string} name name of the child compiler
|
|
* @param {TODO} outputOptions // Need to convert config schema to types for this
|
|
* @param {Plugin[]} plugins webpack plugins that will be applied
|
|
* @returns {Compiler} creates a child Compiler instance
|
|
*/
|
|
createChildCompiler(name, outputOptions, plugins) {
|
|
const idx = this.childrenCounters[name] || 0;
|
|
this.childrenCounters[name] = idx + 1;
|
|
return this.compiler.createChildCompiler(
|
|
this,
|
|
name,
|
|
idx,
|
|
outputOptions,
|
|
plugins
|
|
);
|
|
}
|
|
|
|
checkConstraints() {
|
|
/** @type {Set<number|string>} */
|
|
const usedIds = new Set();
|
|
|
|
const modules = this.modules;
|
|
for (let indexModule = 0; indexModule < modules.length; indexModule++) {
|
|
const moduleId = modules[indexModule].id;
|
|
if (moduleId === null) continue;
|
|
if (usedIds.has(moduleId)) {
|
|
throw new Error(`checkConstraints: duplicate module id ${moduleId}`);
|
|
}
|
|
usedIds.add(moduleId);
|
|
}
|
|
|
|
const chunks = this.chunks;
|
|
for (let indexChunk = 0; indexChunk < chunks.length; indexChunk++) {
|
|
const chunk = chunks[indexChunk];
|
|
if (chunks.indexOf(chunk) !== indexChunk) {
|
|
throw new Error(
|
|
`checkConstraints: duplicate chunk in compilation ${chunk.debugId}`
|
|
);
|
|
}
|
|
}
|
|
|
|
for (const chunkGroup of this.chunkGroups) {
|
|
chunkGroup.checkConstraints();
|
|
}
|
|
}
|
|
}
|
|
|
|
// TODO remove in webpack 5
|
|
Compilation.prototype.applyPlugins = util.deprecate(
|
|
/**
|
|
* @deprecated
|
|
* @param {string} name Name
|
|
* @param {any[]} args Other arguments
|
|
* @returns {void}
|
|
* @this {Compilation}
|
|
*/
|
|
function(name, ...args) {
|
|
this.hooks[
|
|
name.replace(/[- ]([a-z])/g, match => match[1].toUpperCase())
|
|
].call(...args);
|
|
},
|
|
"Compilation.applyPlugins is deprecated. Use new API on `.hooks` instead"
|
|
);
|
|
|
|
// TODO remove in webpack 5
|
|
Object.defineProperty(Compilation.prototype, "moduleTemplate", {
|
|
configurable: false,
|
|
get: util.deprecate(
|
|
/**
|
|
* @deprecated
|
|
* @this {Compilation}
|
|
* @returns {TODO} module template
|
|
*/
|
|
function() {
|
|
return this.moduleTemplates.javascript;
|
|
},
|
|
"Compilation.moduleTemplate: Use Compilation.moduleTemplates.javascript instead"
|
|
),
|
|
set: util.deprecate(
|
|
/**
|
|
* @deprecated
|
|
* @param {ModuleTemplate} value Template value
|
|
* @this {Compilation}
|
|
* @returns {void}
|
|
*/
|
|
function(value) {
|
|
this.moduleTemplates.javascript = value;
|
|
},
|
|
"Compilation.moduleTemplate: Use Compilation.moduleTemplates.javascript instead."
|
|
)
|
|
});
|
|
|
|
module.exports = Compilation;
|