832 lines
21 KiB
JavaScript
832 lines
21 KiB
JavaScript
/*
|
|
MIT License http://www.opensource.org/licenses/mit-license.php
|
|
Author Tobias Koppers @sokra
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
const util = require("util");
|
|
const AbstractMethodError = require("./AbstractMethodError");
|
|
const ChunkGraph = require("./ChunkGraph");
|
|
const DependenciesBlock = require("./DependenciesBlock");
|
|
const ModuleGraph = require("./ModuleGraph");
|
|
const { compareChunksById } = require("./util/comparators");
|
|
const makeSerializable = require("./util/makeSerializable");
|
|
|
|
/** @typedef {import("webpack-sources").Source} Source */
|
|
/** @typedef {import("./Chunk")} Chunk */
|
|
/** @typedef {import("./ChunkGroup")} ChunkGroup */
|
|
/** @typedef {import("./Compilation")} Compilation */
|
|
/** @typedef {import("./Dependency")} Dependency */
|
|
/** @typedef {import("./DependencyTemplates")} DependencyTemplates */
|
|
/** @typedef {import("./FileSystemInfo")} FileSystemInfo */
|
|
/** @typedef {import("./ModuleGraph").UsageStateType} UsageStateType */
|
|
/** @typedef {import("./RequestShortener")} RequestShortener */
|
|
/** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
|
|
/** @typedef {import("./WebpackError")} WebpackError */
|
|
/** @typedef {import("./util/Hash")} Hash */
|
|
/** @template T @typedef {import("./util/SortableSet")<T>} SortableSet<T> */
|
|
|
|
/**
|
|
* @typedef {Object} SourceContext
|
|
* @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 {string=} type the type of source that should be generated
|
|
*/
|
|
|
|
/**
|
|
* @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
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} CodeGenerationResult
|
|
* @property {Map<string, Source>} sources the resulting sources for all source types
|
|
* @property {Iterable<string>} runtimeRequirements the runtime requirements
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} LibIdentOptions
|
|
* @property {string} context absolute context path to which lib ident is relative to
|
|
* @property {Object=} associatedObjectForCache object for caching
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} KnownBuildMeta
|
|
* @property {string=} moduleArgument
|
|
* @property {string=} exportsArgument
|
|
* @property {boolean=} strict
|
|
* @property {string=} moduleConcatenationBailout
|
|
* @property {("named" | "namespace")=} exportsType
|
|
* @property {boolean=} strictHarmonyModule
|
|
* @property {boolean=} async
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} NeedBuildContext
|
|
* @property {FileSystemInfo} fileSystemInfo
|
|
*/
|
|
|
|
/** @typedef {KnownBuildMeta & Record<string, any>} BuildMeta */
|
|
|
|
const EMPTY_RESOLVE_OPTIONS = {};
|
|
|
|
let debugId = 1000;
|
|
|
|
const DEFAULT_TYPES_UNKNOWN = new Set(["unknown"]);
|
|
const DEFAULT_TYPES_JS = new Set(["javascript"]);
|
|
|
|
/** @typedef {(requestShortener: RequestShortener) => string} OptimizationBailoutFunction */
|
|
|
|
class Module extends DependenciesBlock {
|
|
/**
|
|
* @param {string} type the module type
|
|
* @param {string=} context an optional context
|
|
*/
|
|
constructor(type, context = null) {
|
|
super();
|
|
|
|
/** @type {string} */
|
|
this.type = type;
|
|
/** @type {string} */
|
|
this.context = context;
|
|
/** @type {boolean} */
|
|
this.needId = true;
|
|
|
|
// Unique Id
|
|
/** @type {number} */
|
|
this.debugId = debugId++;
|
|
|
|
// Info from Factory
|
|
/** @type {TODO} */
|
|
this.resolveOptions = EMPTY_RESOLVE_OPTIONS;
|
|
/** @type {object | undefined} */
|
|
this.factoryMeta = undefined;
|
|
|
|
// Info from Build
|
|
/** @type {WebpackError[] | undefined} */
|
|
this._warnings = undefined;
|
|
/** @type {WebpackError[] | undefined} */
|
|
this._errors = undefined;
|
|
/** @type {BuildMeta} */
|
|
this.buildMeta = undefined;
|
|
/** @type {object} */
|
|
this.buildInfo = undefined;
|
|
/** @type {Dependency[]} */
|
|
this.presentationalDependencies = [];
|
|
}
|
|
|
|
// TODO remove in webpack 6
|
|
// BACKWARD-COMPAT START
|
|
get id() {
|
|
return ChunkGraph.getChunkGraphForModule(this, "Module.id").getModuleId(
|
|
this
|
|
);
|
|
}
|
|
|
|
set id(value) {
|
|
if (value === "") {
|
|
this.needId = false;
|
|
return;
|
|
}
|
|
ChunkGraph.getChunkGraphForModule(this, "Module.id").setModuleId(
|
|
this,
|
|
value
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @returns {string} the hash of the module
|
|
*/
|
|
get hash() {
|
|
return ChunkGraph.getChunkGraphForModule(this, "Module.hash").getModuleHash(
|
|
this
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @returns {string} the shortened hash of the module
|
|
*/
|
|
get renderedHash() {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.renderedHash"
|
|
).getRenderedModuleHash(this);
|
|
}
|
|
|
|
get profile() {
|
|
return ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.profile"
|
|
).getProfile(this);
|
|
}
|
|
|
|
set profile(value) {
|
|
ModuleGraph.getModuleGraphForModule(this, "Module.profile").setProfile(
|
|
this,
|
|
value
|
|
);
|
|
}
|
|
|
|
get index() {
|
|
return ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.index"
|
|
).getPreOrderIndex(this);
|
|
}
|
|
|
|
set index(value) {
|
|
ModuleGraph.getModuleGraphForModule(this, "Module.index").setPreOrderIndex(
|
|
this,
|
|
value
|
|
);
|
|
}
|
|
|
|
get index2() {
|
|
return ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.index2"
|
|
).getPostOrderIndex(this);
|
|
}
|
|
|
|
set index2(value) {
|
|
ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.index2"
|
|
).setPostOrderIndex(this, value);
|
|
}
|
|
|
|
get depth() {
|
|
return ModuleGraph.getModuleGraphForModule(this, "Module.depth").getDepth(
|
|
this
|
|
);
|
|
}
|
|
|
|
set depth(value) {
|
|
ModuleGraph.getModuleGraphForModule(this, "Module.depth").setDepth(
|
|
this,
|
|
value
|
|
);
|
|
}
|
|
|
|
get issuer() {
|
|
return ModuleGraph.getModuleGraphForModule(this, "Module.issuer").getIssuer(
|
|
this
|
|
);
|
|
}
|
|
|
|
set issuer(value) {
|
|
ModuleGraph.getModuleGraphForModule(this, "Module.issuer").setIssuer(
|
|
this,
|
|
value
|
|
);
|
|
}
|
|
|
|
get usedExports() {
|
|
return ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.usedExports"
|
|
).getUsedExports(this);
|
|
}
|
|
|
|
get optimizationBailout() {
|
|
return ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.optimizationBailout"
|
|
).getOptimizationBailout(this);
|
|
}
|
|
|
|
get optional() {
|
|
return this.isOptional(
|
|
ModuleGraph.getModuleGraphForModule(this, "Module.optional")
|
|
);
|
|
}
|
|
|
|
addChunk(chunk) {
|
|
const chunkGraph = ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.addChunk"
|
|
);
|
|
if (chunkGraph.isModuleInChunk(this, chunk)) return false;
|
|
chunkGraph.connectChunkAndModule(chunk, this);
|
|
return true;
|
|
}
|
|
|
|
removeChunk(chunk) {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.removeChunk"
|
|
).disconnectChunkAndModule(chunk, this);
|
|
}
|
|
|
|
isInChunk(chunk) {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.isInChunk"
|
|
).isModuleInChunk(this, chunk);
|
|
}
|
|
|
|
isEntryModule() {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.isEntryModule"
|
|
).isEntryModule(this);
|
|
}
|
|
|
|
getChunks() {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.getChunks"
|
|
).getModuleChunks(this);
|
|
}
|
|
|
|
getNumberOfChunks() {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.getNumberOfChunks"
|
|
).getNumberOfModuleChunks(this);
|
|
}
|
|
|
|
get chunksIterable() {
|
|
return ChunkGraph.getChunkGraphForModule(
|
|
this,
|
|
"Module.chunksIterable"
|
|
).getOrderedModuleChunksIterable(this, compareChunksById);
|
|
}
|
|
|
|
/**
|
|
* @param {string} exportName a name of an export
|
|
* @returns {boolean | null} true, if the export is provided why the module.
|
|
* null, if it's unknown.
|
|
* false, if it's not provided.
|
|
*/
|
|
isProvided(exportName) {
|
|
return ModuleGraph.getModuleGraphForModule(
|
|
this,
|
|
"Module.usedExports"
|
|
).isExportProvided(this, exportName);
|
|
}
|
|
// BACKWARD-COMPAT END
|
|
|
|
/**
|
|
* @deprecated moved to .buildInfo.exportsArgument
|
|
* @returns {string} name of the exports argument
|
|
*/
|
|
get exportsArgument() {
|
|
return (this.buildInfo && this.buildInfo.exportsArgument) || "exports";
|
|
}
|
|
|
|
/**
|
|
* @deprecated moved to .buildInfo.moduleArgument
|
|
* @returns {string} name of the module argument
|
|
*/
|
|
get moduleArgument() {
|
|
return (this.buildInfo && this.buildInfo.moduleArgument) || "module";
|
|
}
|
|
|
|
/**
|
|
* @param {Dependency} presentationalDependency dependency being tied to module.
|
|
* This is a Dependency without edge in the module graph. It's only for presentation.
|
|
* @returns {void}
|
|
*/
|
|
addPresentationalDependency(presentationalDependency) {
|
|
this.presentationalDependencies.push(presentationalDependency);
|
|
}
|
|
|
|
/**
|
|
* @param {WebpackError} warning the warning
|
|
* @returns {void}
|
|
*/
|
|
addWarning(warning) {
|
|
if (this._warnings === undefined) {
|
|
this._warnings = [];
|
|
}
|
|
this._warnings.push(warning);
|
|
}
|
|
|
|
/**
|
|
* @returns {Iterable<WebpackError> | undefined} list of warnings if any
|
|
*/
|
|
getWarnings() {
|
|
return this._warnings;
|
|
}
|
|
|
|
/**
|
|
* @param {WebpackError} error the error
|
|
* @returns {void}
|
|
*/
|
|
addError(error) {
|
|
if (this._errors === undefined) {
|
|
this._errors = [];
|
|
}
|
|
this._errors.push(error);
|
|
}
|
|
|
|
/**
|
|
* @returns {Iterable<WebpackError> | undefined} list of errors if any
|
|
*/
|
|
getErrors() {
|
|
return this._errors;
|
|
}
|
|
|
|
/**
|
|
* removes all warnings and errors
|
|
* @returns {void}
|
|
*/
|
|
clearWarningsAndErrors() {
|
|
if (this._warnings !== undefined) {
|
|
this._warnings.length = 0;
|
|
}
|
|
if (this._errors !== undefined) {
|
|
this._errors.length = 0;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {ModuleGraph} moduleGraph the module graph
|
|
* @returns {boolean} true, if the module is optional
|
|
*/
|
|
isOptional(moduleGraph) {
|
|
let hasConnections = false;
|
|
for (const r of moduleGraph.getIncomingConnections(this)) {
|
|
if (!r.dependency || !r.dependency.optional || !r.active) return false;
|
|
hasConnections = true;
|
|
}
|
|
return hasConnections;
|
|
}
|
|
|
|
/**
|
|
* @param {ChunkGraph} chunkGraph the chunk graph
|
|
* @param {Chunk} chunk a chunk
|
|
* @param {Chunk=} ignoreChunk chunk to be ignored
|
|
* @returns {boolean} true, if the module is accessible from "chunk" when ignoring "ignoreChunk"
|
|
*/
|
|
isAccessibleInChunk(chunkGraph, chunk, ignoreChunk) {
|
|
// Check if module is accessible in ALL chunk groups
|
|
for (const chunkGroup of chunk.groupsIterable) {
|
|
if (!this.isAccessibleInChunkGroup(chunkGraph, chunkGroup)) return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @param {ChunkGraph} chunkGraph the chunk graph
|
|
* @param {ChunkGroup} chunkGroup a chunk group
|
|
* @param {Chunk=} ignoreChunk chunk to be ignored
|
|
* @returns {boolean} true, if the module is accessible from "chunkGroup" when ignoring "ignoreChunk"
|
|
*/
|
|
isAccessibleInChunkGroup(chunkGraph, chunkGroup, ignoreChunk) {
|
|
const queue = new Set([chunkGroup]);
|
|
|
|
// Check if module is accessible from all items of the queue
|
|
queueFor: for (const cg of queue) {
|
|
// 1. If module is in one of the chunks of the group we can continue checking the next items
|
|
// because it's accessible.
|
|
for (const chunk of cg.chunks) {
|
|
if (chunk !== ignoreChunk && chunkGraph.isModuleInChunk(this, chunk))
|
|
continue queueFor;
|
|
}
|
|
// 2. If the chunk group is initial, we can break here because it's not accessible.
|
|
if (chunkGroup.isInitial()) return false;
|
|
// 3. Enqueue all parents because it must be accessible from ALL parents
|
|
for (const parent of chunkGroup.parentsIterable) queue.add(parent);
|
|
}
|
|
// When we processed through the whole list and we didn't bailout, the module is accessible
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @param {Chunk} chunk a chunk
|
|
* @param {ModuleGraph} moduleGraph the module graph
|
|
* @param {ChunkGraph} chunkGraph the chunk graph
|
|
* @returns {boolean} true, if the module has any reason why "chunk" should be included
|
|
*/
|
|
hasReasonForChunk(chunk, moduleGraph, chunkGraph) {
|
|
// check for each reason if we need the chunk
|
|
for (const connection of moduleGraph.getIncomingConnections(this)) {
|
|
if (!connection.active) continue;
|
|
const fromModule = connection.originModule;
|
|
for (const originChunk of chunkGraph.getModuleChunksIterable(
|
|
fromModule
|
|
)) {
|
|
// return true if module this is not reachable from originChunk when ignoring cunk
|
|
if (!this.isAccessibleInChunk(chunkGraph, originChunk, chunk))
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @param {ModuleGraph} moduleGraph the module graph
|
|
* @returns {boolean} true if at least one other module depends on this module
|
|
*/
|
|
hasReasons(moduleGraph) {
|
|
for (const c of moduleGraph.getIncomingConnections(this)) {
|
|
if (c.active) return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @param {ModuleGraph} moduleGraph the module graph
|
|
* @returns {boolean} true, if the module is used
|
|
*/
|
|
isModuleUsed(moduleGraph) {
|
|
return moduleGraph.getExportsInfo(this).isUsed() !== false;
|
|
}
|
|
|
|
/**
|
|
* @param {ModuleGraph} moduleGraph the module graph
|
|
* @param {string | string[]} exportName a name of an export
|
|
* @returns {UsageStateType} state of the export
|
|
*/
|
|
isExportUsed(moduleGraph, exportName) {
|
|
return moduleGraph.getExportsInfo(this).isExportUsed(exportName);
|
|
}
|
|
|
|
// TODO move to ModuleGraph
|
|
/**
|
|
* @param {ModuleGraph} moduleGraph the module graph
|
|
* @param {string | string[]} exportName a name of an export
|
|
* @returns {string | string[] | false} false, when module or referenced export is unused.
|
|
* string, the mangled export name when used.
|
|
*/
|
|
getUsedName(moduleGraph, exportName) {
|
|
return moduleGraph.getExportsInfo(this).getUsedName(exportName);
|
|
}
|
|
|
|
/**
|
|
* @returns {string} for debugging
|
|
*/
|
|
toString() {
|
|
return `Module[${this.debugId}: ${this.identifier()}]`;
|
|
}
|
|
|
|
/**
|
|
* @param {NeedBuildContext} context context info
|
|
* @param {function(WebpackError=, boolean=): void} callback callback function, returns true, if the module needs a rebuild
|
|
* @returns {void}
|
|
*/
|
|
needBuild(context, callback) {
|
|
callback(
|
|
null,
|
|
!this.buildMeta ||
|
|
this.needRebuild === Module.prototype.needRebuild ||
|
|
this.needRebuild(
|
|
context.fileSystemInfo.getDeprecatedFileTimestamps(),
|
|
context.fileSystemInfo.getDeprecatedContextTimestamps()
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @deprecated Use needBuild instead
|
|
* @param {TODO} fileTimestamps timestamps of files
|
|
* @param {TODO} contextTimestamps timestamps of directories
|
|
* @returns {boolean} true, if the module needs a rebuild
|
|
*/
|
|
needRebuild(fileTimestamps, contextTimestamps) {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @param {Hash} hash the hash used to track dependencies
|
|
* @param {ChunkGraph} chunkGraph the chunk graph
|
|
* @returns {void}
|
|
*/
|
|
updateHash(
|
|
hash,
|
|
chunkGraph = ChunkGraph.getChunkGraphForModule(this, "Module.updateHash")
|
|
) {
|
|
hash.update(`${chunkGraph.getModuleId(this)}`);
|
|
const exportsInfo = chunkGraph.moduleGraph.getExportsInfo(this);
|
|
for (const exportInfo of exportsInfo.orderedExports) {
|
|
hash.update(exportInfo.name);
|
|
hash.update(exportInfo.used + "");
|
|
hash.update(exportInfo.usedName + "");
|
|
}
|
|
for (const dep of this.presentationalDependencies) {
|
|
dep.updateHash(hash, chunkGraph);
|
|
}
|
|
super.updateHash(hash, chunkGraph);
|
|
}
|
|
|
|
/**
|
|
* @returns {void}
|
|
*/
|
|
invalidateBuild() {
|
|
// should be overriden to support this feature
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @returns {string} a unique identifier of the module
|
|
*/
|
|
identifier() {
|
|
throw new AbstractMethodError();
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {RequestShortener} requestShortener the request shortener
|
|
* @returns {string} a user readable identifier of the module
|
|
*/
|
|
readableIdentifier(requestShortener) {
|
|
throw new AbstractMethodError();
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {TODO} options TODO
|
|
* @param {Compilation} compilation the compilation
|
|
* @param {TODO} resolver TODO
|
|
* @param {TODO} fs the file system
|
|
* @param {function(WebpackError=): void} callback callback function
|
|
* @returns {void}
|
|
*/
|
|
build(options, compilation, resolver, fs, callback) {
|
|
throw new AbstractMethodError();
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @returns {Set<string>} types availiable (do not mutate)
|
|
*/
|
|
getSourceTypes() {
|
|
// Better override this method to return the correct types
|
|
if (this.source === Module.prototype.source) {
|
|
return DEFAULT_TYPES_UNKNOWN;
|
|
} else {
|
|
return DEFAULT_TYPES_JS;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @deprecated Use codeGeneration() instead
|
|
* @param {SourceContext} sourceContext source context
|
|
* @returns {Source} generated source
|
|
*/
|
|
source(sourceContext) {
|
|
if (this.codeGeneration === Module.prototype.codeGeneration) {
|
|
throw new AbstractMethodError();
|
|
}
|
|
const sources = this.codeGeneration(sourceContext).sources;
|
|
return sourceContext.type
|
|
? sources.get(sourceContext.type)
|
|
: sources.get(
|
|
this.getSourceTypes()
|
|
.values()
|
|
.next().value
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {string=} type the source type for which the size should be estimated
|
|
* @returns {number} the estimated size of the module (must be non-zero)
|
|
*/
|
|
size(type) {
|
|
throw new AbstractMethodError();
|
|
}
|
|
|
|
/**
|
|
* @param {LibIdentOptions} options options
|
|
* @returns {string | null} an identifier for library inclusion
|
|
*/
|
|
libIdent(options) {
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* @returns {string | null} absolute path which should be used for condition matching (usually the resource path)
|
|
*/
|
|
nameForCondition() {
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* @abstract
|
|
* @deprecated Use codeGeneration() instead
|
|
* Get a list of runtime requirements
|
|
* @param {SourceContext} context context for code generation
|
|
* @returns {Iterable<string> | null} required runtime modules
|
|
*/
|
|
getRuntimeRequirements(context) {
|
|
if (this.codeGeneration === Module.prototype.codeGeneration) {
|
|
return null;
|
|
}
|
|
return this.codeGeneration(context).runtimeRequirements;
|
|
}
|
|
|
|
/**
|
|
* @param {CodeGenerationContext} context context for code generation
|
|
* @returns {CodeGenerationResult} result
|
|
*/
|
|
codeGeneration(context) {
|
|
// Best override this method
|
|
const sources = new Map();
|
|
for (const type of this.getSourceTypes()) {
|
|
if (type !== "unknown") {
|
|
sources.set(
|
|
type,
|
|
this.source({
|
|
...context,
|
|
type
|
|
})
|
|
);
|
|
}
|
|
}
|
|
return {
|
|
sources,
|
|
runtimeRequirements: this.getRuntimeRequirements(context)
|
|
};
|
|
}
|
|
|
|
/**
|
|
* @param {Chunk} chunk the chunk which condition should be checked
|
|
* @param {Compilation} compilation the compilation
|
|
* @returns {boolean} true, if the chunk is ok for the module
|
|
*/
|
|
chunkCondition(chunk, compilation) {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Assuming this module is in the cache. Update the (cached) module with
|
|
* the fresh module from the factory. Usually updates internal references
|
|
* and properties.
|
|
* @param {Module} module fresh module
|
|
* @returns {void}
|
|
*/
|
|
updateCacheModule(module) {
|
|
this.type = module.type;
|
|
this.context = module.context;
|
|
this.factoryMeta = module.factoryMeta;
|
|
this.resolveOptions = module.resolveOptions;
|
|
}
|
|
|
|
/**
|
|
* @returns {Source | null} the original source for the module before webpack transformation
|
|
*/
|
|
originalSource() {
|
|
return null;
|
|
}
|
|
|
|
serialize(context) {
|
|
const { write } = context;
|
|
write(this.type);
|
|
write(this.context);
|
|
write(this.resolveOptions);
|
|
write(this.factoryMeta);
|
|
write(this.useSourceMap);
|
|
write(
|
|
this._warnings !== undefined && this._warnings.length === 0
|
|
? undefined
|
|
: this._warnings
|
|
);
|
|
write(
|
|
this._errors !== undefined && this._errors.length === 0
|
|
? undefined
|
|
: this._errors
|
|
);
|
|
write(this.buildMeta);
|
|
write(this.buildInfo);
|
|
write(this.presentationalDependencies);
|
|
super.serialize(context);
|
|
}
|
|
|
|
deserialize(context) {
|
|
const { read } = context;
|
|
this.type = read();
|
|
this.context = read();
|
|
this.resolveOptions = read();
|
|
this.factoryMeta = read();
|
|
this.useSourceMap = read();
|
|
this._warnings = read();
|
|
this._errors = read();
|
|
this.buildMeta = read();
|
|
this.buildInfo = read();
|
|
this.presentationalDependencies = read();
|
|
super.deserialize(context);
|
|
}
|
|
}
|
|
|
|
makeSerializable(Module, "webpack/lib/Module");
|
|
|
|
// TODO remove in webpack 6
|
|
Object.defineProperty(Module.prototype, "hasEqualsChunks", {
|
|
get() {
|
|
throw new Error(
|
|
"Module.hasEqualsChunks was renamed (use hasEqualChunks instead)"
|
|
);
|
|
}
|
|
});
|
|
|
|
// TODO remove in webpack 6
|
|
Object.defineProperty(Module.prototype, "isUsed", {
|
|
get() {
|
|
throw new Error(
|
|
"Module.isUsed was renamed (use getUsedName, isExportUsed or isModuleUsed instead)"
|
|
);
|
|
}
|
|
});
|
|
|
|
// TODO remove in webpack 6
|
|
Object.defineProperty(Module.prototype, "errors", {
|
|
get: util.deprecate(
|
|
/**
|
|
* @this {Module}
|
|
* @returns {WebpackError[]} array
|
|
*/
|
|
function() {
|
|
if (this._errors === undefined) {
|
|
this._errors = [];
|
|
}
|
|
return this._errors;
|
|
},
|
|
"Module.errors was removed (use getErrors instead)",
|
|
"DEP_WEBPACK_MODULE_ERRORS"
|
|
)
|
|
});
|
|
|
|
// TODO remove in webpack 6
|
|
Object.defineProperty(Module.prototype, "warnings", {
|
|
get: util.deprecate(
|
|
/**
|
|
* @this {Module}
|
|
* @returns {WebpackError[]} array
|
|
*/
|
|
function() {
|
|
if (this._warnings === undefined) {
|
|
this._warnings = [];
|
|
}
|
|
return this._warnings;
|
|
},
|
|
"Module.warnings was removed (use getWarnings instead)",
|
|
"DEP_WEBPACK_MODULE_WARNINGS"
|
|
)
|
|
});
|
|
|
|
// TODO remove in webpack 6
|
|
Object.defineProperty(Module.prototype, "used", {
|
|
get() {
|
|
throw new Error(
|
|
"Module.used was refactored (use ModuleGraph.getUsedExports instead)"
|
|
);
|
|
},
|
|
set(value) {
|
|
throw new Error(
|
|
"Module.used was refactored (use ModuleGraph.setUsedExports instead)"
|
|
);
|
|
}
|
|
});
|
|
|
|
module.exports = Module;
|