| | |
| | | const { RawSource } = require("webpack-sources"); |
| | | const OriginalSource = require("webpack-sources").OriginalSource; |
| | | const Module = require("./Module"); |
| | | const { RUNTIME_TYPES } = require("./ModuleSourceTypesConstants"); |
| | | const { |
| | | JAVASCRIPT_TYPES, |
| | | RUNTIME_TYPES |
| | | } = require("./ModuleSourceTypeConstants"); |
| | | const { WEBPACK_MODULE_TYPE_RUNTIME } = require("./ModuleTypeConstants"); |
| | | |
| | | /** @typedef {import("./config/defaults").WebpackOptionsNormalizedWithDefaults} WebpackOptions */ |
| | |
| | | /** @typedef {import("./Compilation")} Compilation */ |
| | | /** @typedef {import("./Dependency").UpdateHashContext} UpdateHashContext */ |
| | | /** @typedef {import("./Generator").SourceTypes} SourceTypes */ |
| | | /** @typedef {import("./Module").BuildMeta} BuildMeta */ |
| | | /** @typedef {import("./Module").BuildInfo} BuildInfo */ |
| | | /** @typedef {import("./Module").BuildCallback} BuildCallback */ |
| | | /** @typedef {import("./Module").CodeGenerationContext} CodeGenerationContext */ |
| | | /** @typedef {import("./Module").CodeGenerationResult} CodeGenerationResult */ |
| | | /** @typedef {import("./Module").NeedBuildCallback} NeedBuildCallback */ |
| | | /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */ |
| | | /** @typedef {import("./Module").Sources} Sources */ |
| | | /** @typedef {import("./RequestShortener")} RequestShortener */ |
| | | /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */ |
| | | /** @typedef {import("./util/Hash")} Hash */ |
| | | /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */ |
| | | /** @typedef {import("./Module").BasicSourceTypes} BasicSourceTypes */ |
| | | |
| | | class RuntimeModule extends Module { |
| | | /** |
| | | * Creates an instance of RuntimeModule. |
| | | * @param {string} name a readable name |
| | | * @param {number=} stage an optional stage |
| | | */ |
| | | constructor(name, stage = 0) { |
| | | super(WEBPACK_MODULE_TYPE_RUNTIME); |
| | | /** @type {string} */ |
| | | this.name = name; |
| | | /** @type {number} */ |
| | | this.stage = stage; |
| | | /** @type {BuildMeta} */ |
| | | this.buildMeta = {}; |
| | | /** @type {BuildInfo} */ |
| | | this.buildInfo = {}; |
| | | /** @type {Compilation | undefined} */ |
| | | this.compilation = undefined; |
| | |
| | | this.chunk = undefined; |
| | | /** @type {ChunkGraph | undefined} */ |
| | | this.chunkGraph = undefined; |
| | | /** @type {boolean} */ |
| | | this.fullHash = false; |
| | | /** @type {boolean} */ |
| | | this.dependentHash = false; |
| | | /** @type {string | undefined | null} */ |
| | | this._cachedGeneratedCode = undefined; |
| | | } |
| | | |
| | | /** |
| | | * Processes the provided compilation. |
| | | * @param {Compilation} compilation the compilation |
| | | * @param {Chunk} chunk the chunk |
| | | * @param {ChunkGraph} chunkGraph the chunk graph |
| | |
| | | } |
| | | |
| | | /** |
| | | * Returns the unique identifier used to reference this module. |
| | | * @returns {string} a unique identifier of the module |
| | | */ |
| | | identifier() { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Returns a human-readable identifier for this module. |
| | | * @param {RequestShortener} requestShortener the request shortener |
| | | * @returns {string} a user readable identifier of the module |
| | | */ |
| | |
| | | } |
| | | |
| | | /** |
| | | * Checks whether the module needs to be rebuilt for the current build state. |
| | | * @param {NeedBuildContext} context context info |
| | | * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild |
| | | * @returns {void} |
| | |
| | | } |
| | | |
| | | /** |
| | | * Builds the module using the provided compilation context. |
| | | * @param {WebpackOptions} options webpack options |
| | | * @param {Compilation} compilation the compilation |
| | | * @param {ResolverWithOptions} resolver the resolver |
| | |
| | | } |
| | | |
| | | /** |
| | | * Updates the hash with the data contributed by this instance. |
| | | * @param {Hash} hash the hash used to track dependencies |
| | | * @param {UpdateHashContext} context context |
| | | * @returns {void} |
| | |
| | | } |
| | | |
| | | /** |
| | | * Returns the source types this module can generate. |
| | | * @returns {SourceTypes} types available (do not mutate) |
| | | */ |
| | | getSourceTypes() { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Basic source types are high-level categories like javascript, css, webassembly, etc. |
| | | * We only have built-in knowledge about the javascript basic type here; other basic types may be |
| | | * added or changed over time by generators and do not need to be handled or detected here. |
| | | * |
| | | * Some modules, e.g. RemoteModule, may return non-basic source types like "remote" and "share-init" |
| | | * from getSourceTypes(), but their generated output is still JavaScript, i.e. their basic type is JS. |
| | | * @returns {BasicSourceTypes} types available (do not mutate) |
| | | */ |
| | | getSourceBasicTypes() { |
| | | return JAVASCRIPT_TYPES; |
| | | } |
| | | |
| | | /** |
| | | * Generates code and runtime requirements for this module. |
| | | * @param {CodeGenerationContext} context context for code generation |
| | | * @returns {CodeGenerationResult} result |
| | | */ |
| | | codeGeneration(context) { |
| | | /** @type {Sources} */ |
| | | const sources = new Map(); |
| | | const generatedCode = this.getGeneratedCode(); |
| | | if (generatedCode) { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Returns the estimated size for the requested source type. |
| | | * @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) |
| | | */ |
| | |
| | | |
| | | /* istanbul ignore next */ |
| | | /** |
| | | * Generates runtime code for this runtime module. |
| | | * @abstract |
| | | * @returns {string | null} runtime code |
| | | */ |
| | |
| | | } |
| | | |
| | | /** |
| | | * Gets generated code. |
| | | * @returns {string | null} runtime code |
| | | */ |
| | | getGeneratedCode() { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Returns true, if the runtime module should get it's own scope. |
| | | * @returns {boolean} true, if the runtime module should get it's own scope |
| | | */ |
| | | shouldIsolate() { |