/* MIT License http://www.opensource.org/licenses/mit-license.php Author Tobias Koppers @sokra */ "use strict"; const RuntimeGlobals = require("../RuntimeGlobals"); const { equals } = require("../util/ArrayHelpers"); const makeSerializable = require("../util/makeSerializable"); const { propertyAccess } = require("../util/property"); const { isWorkerEntryThis } = require("./CommonJsDependencyHelpers"); const NullDependency = require("./NullDependency"); /** @import { ReplaceSource } from "webpack-sources" */ /** * @import Dependency, { * ReferencedExports, * UpdateHashContext, * ExportInfoName * } from "../Dependency" */ /** @import Hash from "../util/Hash" */ /** @import { DependencyTemplateContext } from "../DependencyTemplate" */ /** @import ModuleGraph from "../ModuleGraph" */ /** @import { Range } from "../javascript/JavascriptParser" */ /** @import { RuntimeSpec } from "../util/runtime" */ /** * @import { * CommonJSDependencyBaseKeywords * } from "./CommonJsDependencyHelpers" */ /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[Range, CommonJSDependencyBaseKeywords, ExportInfoName[], boolean]>} ObjectDeserializerContext */ /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[Range, CommonJSDependencyBaseKeywords, ExportInfoName[], boolean]>} ObjectSerializerContext */ class CommonJsSelfReferenceDependency extends NullDependency { /** * Creates an instance of CommonJsSelfReferenceDependency. * @param {Range} range range * @param {CommonJSDependencyBaseKeywords} base base * @param {ExportInfoName[]} names names * @param {boolean} call is a call */ constructor(range, base, names, call) { super(); this.range = range; /** @type {CommonJSDependencyBaseKeywords} */ this.base = base; /** @type {string[]} */ this.names = names; /** @type {boolean} */ this.call = call; } get type() { return "cjs self exports reference"; } get category() { return "self"; } /** * Returns true if this dependency can be concatenated * @param {boolean} concatenateCommonJsModules whether optimization.concatenateModules.commonjs is enabled * @returns {boolean} true if this dependency can be concatenated */ canConcatenate(concatenateCommonJsModules) { return concatenateCommonJsModules; } /** * Returns an identifier to merge equal requests. * @returns {string | null} an identifier to merge equal requests */ getResourceIdentifier() { return "self"; } /** * Returns list of exports referenced by this dependency * @param {ModuleGraph} moduleGraph module graph * @param {RuntimeSpec} runtime the runtime for which the module is analysed * @returns {ReferencedExports} referenced exports */ getReferencedExports(moduleGraph, runtime) { return [this.call ? this.names.slice(0, -1) : this.names]; } /** * Updates the hash with the data contributed by this instance. * @param {Hash} hash hash to be updated * @param {UpdateHashContext} context context * @returns {void} */ updateHash(hash, context) { // a classic worker entry generates `this` as the global scope, so it must // not share one code generation with a runtime that generates it as exports if (this.base !== "this") return; const { chunkGraph, runtime, runtimeTemplate } = context; const module = chunkGraph.moduleGraph.getParentModule(this); hash.update( module !== undefined && isWorkerEntryThis(module, chunkGraph, runtime, runtimeTemplate) ? "worker global" : "exports" ); } /** * Serializes this instance into the provided serializer context. * @param {ObjectSerializerContext} context context */ serialize(context) { context .write(this.range) .write(this.base) .write(this.names) .write(this.call); super.serialize(context); } /** * Restores this instance from the provided deserializer context. * @param {ObjectDeserializerContext} context context */ deserialize(context) { this.range = context.read(); const c1 = context.rest; this.base = c1.read(); const c2 = c1.rest; this.names = c2.read(); const c3 = c2.rest; this.call = c3.read(); super.deserialize(c3.rest); } } makeSerializable( CommonJsSelfReferenceDependency, "webpack/lib/dependencies/CommonJsSelfReferenceDependency" ); CommonJsSelfReferenceDependency.Template = class CommonJsSelfReferenceDependencyTemplate extends ( NullDependency.Template ) { /** * Applies the plugin by registering its hooks on the compiler. * @param {Dependency} dependency the dependency for which the template should be applied * @param {ReplaceSource} source the current replace source which can be modified * @param {DependencyTemplateContext} templateContext the context object * @returns {void} */ apply( dependency, source, { module, moduleGraph, chunkGraph, runtime, runtimeRequirements, runtimeTemplate } ) { const dep = /** @type {CommonJsSelfReferenceDependency} */ (dependency); // a classic worker entry reads its global scope, not an export, so the // names stay as written const isWorkerEntry = dep.base === "this" && isWorkerEntryThis(module, chunkGraph, runtime, runtimeTemplate); // CJS exports are never inlined const used = isWorkerEntry || dep.names.length === 0 ? dep.names : /** @type {string | string[] | false} */ ( moduleGraph.getExportsInfo(module).getUsedName(dep.names, runtime) ); if (!used) { throw new Error( "Self-reference dependency has unused export name: This should not happen" ); } /** @type {string} */ let base; switch (dep.base) { case "exports": runtimeRequirements.add(RuntimeGlobals.exports); base = module.exportsArgument; break; case "module.exports": runtimeRequirements.add(RuntimeGlobals.module); base = `${module.moduleArgument}.exports`; break; case "this": if (isWorkerEntry) { runtimeRequirements.add(RuntimeGlobals.global); base = RuntimeGlobals.global; } else { runtimeRequirements.add(RuntimeGlobals.thisAsExports); base = "this"; } break; default: throw new Error(`Unsupported base ${dep.base}`); } if (base === dep.base && equals(used, dep.names)) { // Nothing has to be changed // We don't use a replacement for compat reasons // for plugins that update `module._source` which they // shouldn't do! return; } source.replace( dep.range[0], dep.range[1] - 1, `${base}${propertyAccess(/** @type {string[]} */ (used))}` ); } }; module.exports = CommonJsSelfReferenceDependency;