CommonJsImportsParserPlugin.js 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796
  1. /*
  2. MIT License http://www.opensource.org/licenses/mit-license.php
  3. Author Tobias Koppers @sokra
  4. */
  5. "use strict";
  6. const { fileURLToPath } = require("url");
  7. const CommentCompilationWarning = require("../CommentCompilationWarning");
  8. const RuntimeGlobals = require("../RuntimeGlobals");
  9. const UnsupportedFeatureWarning = require("../UnsupportedFeatureWarning");
  10. const WebpackError = require("../WebpackError");
  11. const BasicEvaluatedExpression = require("../javascript/BasicEvaluatedExpression");
  12. const {
  13. evaluateToIdentifier,
  14. evaluateToString,
  15. expressionIsUnsupported,
  16. toConstantDependency
  17. } = require("../javascript/JavascriptParserHelpers");
  18. const CommonJsFullRequireDependency = require("./CommonJsFullRequireDependency");
  19. const CommonJsRequireContextDependency = require("./CommonJsRequireContextDependency");
  20. const CommonJsRequireDependency = require("./CommonJsRequireDependency");
  21. const ConstDependency = require("./ConstDependency");
  22. const ContextDependencyHelpers = require("./ContextDependencyHelpers");
  23. const LocalModuleDependency = require("./LocalModuleDependency");
  24. const { getLocalModule } = require("./LocalModulesHelpers");
  25. const RequireHeaderDependency = require("./RequireHeaderDependency");
  26. const RequireResolveContextDependency = require("./RequireResolveContextDependency");
  27. const RequireResolveDependency = require("./RequireResolveDependency");
  28. const RequireResolveHeaderDependency = require("./RequireResolveHeaderDependency");
  29. /** @typedef {import("estree").CallExpression} CallExpression */
  30. /** @typedef {import("estree").Expression} Expression */
  31. /** @typedef {import("estree").NewExpression} NewExpression */
  32. /** @typedef {import("../../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */
  33. /** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
  34. /** @typedef {import("../javascript/JavascriptParser")} JavascriptParser */
  35. /** @typedef {import("../javascript/JavascriptParser").ImportSource} ImportSource */
  36. /** @typedef {import("../javascript/JavascriptParser").Range} Range */
  37. const createRequireSpecifierTag = Symbol("createRequire");
  38. const createdRequireIdentifierTag = Symbol("createRequire()");
  39. class CommonJsImportsParserPlugin {
  40. /**
  41. * @param {JavascriptParserOptions} options parser options
  42. */
  43. constructor(options) {
  44. this.options = options;
  45. }
  46. /**
  47. * @param {JavascriptParser} parser the parser
  48. * @returns {void}
  49. */
  50. apply(parser) {
  51. const options = this.options;
  52. const getContext = () => {
  53. if (parser.currentTagData) {
  54. const { context } = parser.currentTagData;
  55. return context;
  56. }
  57. };
  58. //#region metadata
  59. /**
  60. * @param {TODO} expression expression
  61. * @param {() => string[]} getMembers get members
  62. */
  63. const tapRequireExpression = (expression, getMembers) => {
  64. parser.hooks.typeof
  65. .for(expression)
  66. .tap(
  67. "CommonJsImportsParserPlugin",
  68. toConstantDependency(parser, JSON.stringify("function"))
  69. );
  70. parser.hooks.evaluateTypeof
  71. .for(expression)
  72. .tap("CommonJsImportsParserPlugin", evaluateToString("function"));
  73. parser.hooks.evaluateIdentifier
  74. .for(expression)
  75. .tap(
  76. "CommonJsImportsParserPlugin",
  77. evaluateToIdentifier(expression, "require", getMembers, true)
  78. );
  79. };
  80. /**
  81. * @param {string | symbol} tag tag
  82. */
  83. const tapRequireExpressionTag = tag => {
  84. parser.hooks.typeof
  85. .for(tag)
  86. .tap(
  87. "CommonJsImportsParserPlugin",
  88. toConstantDependency(parser, JSON.stringify("function"))
  89. );
  90. parser.hooks.evaluateTypeof
  91. .for(tag)
  92. .tap("CommonJsImportsParserPlugin", evaluateToString("function"));
  93. };
  94. tapRequireExpression("require", () => []);
  95. tapRequireExpression("require.resolve", () => ["resolve"]);
  96. tapRequireExpression("require.resolveWeak", () => ["resolveWeak"]);
  97. //#endregion
  98. // Weird stuff //
  99. parser.hooks.assign
  100. .for("require")
  101. .tap("CommonJsImportsParserPlugin", expr => {
  102. // to not leak to global "require", we need to define a local require here.
  103. const dep = new ConstDependency("var require;", 0);
  104. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  105. parser.state.module.addPresentationalDependency(dep);
  106. return true;
  107. });
  108. //#region Unsupported
  109. parser.hooks.expression
  110. .for("require.main")
  111. .tap(
  112. "CommonJsImportsParserPlugin",
  113. expressionIsUnsupported(
  114. parser,
  115. "require.main is not supported by webpack."
  116. )
  117. );
  118. parser.hooks.call
  119. .for("require.main.require")
  120. .tap(
  121. "CommonJsImportsParserPlugin",
  122. expressionIsUnsupported(
  123. parser,
  124. "require.main.require is not supported by webpack."
  125. )
  126. );
  127. parser.hooks.expression
  128. .for("module.parent.require")
  129. .tap(
  130. "CommonJsImportsParserPlugin",
  131. expressionIsUnsupported(
  132. parser,
  133. "module.parent.require is not supported by webpack."
  134. )
  135. );
  136. parser.hooks.call
  137. .for("module.parent.require")
  138. .tap(
  139. "CommonJsImportsParserPlugin",
  140. expressionIsUnsupported(
  141. parser,
  142. "module.parent.require is not supported by webpack."
  143. )
  144. );
  145. //#endregion
  146. //#region Renaming
  147. /**
  148. * @param {Expression} expr expression
  149. * @returns {boolean} true when set undefined
  150. */
  151. const defineUndefined = expr => {
  152. // To avoid "not defined" error, replace the value with undefined
  153. const dep = new ConstDependency(
  154. "undefined",
  155. /** @type {Range} */ (expr.range)
  156. );
  157. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  158. parser.state.module.addPresentationalDependency(dep);
  159. return false;
  160. };
  161. parser.hooks.canRename
  162. .for("require")
  163. .tap("CommonJsImportsParserPlugin", () => true);
  164. parser.hooks.rename
  165. .for("require")
  166. .tap("CommonJsImportsParserPlugin", defineUndefined);
  167. //#endregion
  168. //#region Inspection
  169. const requireCache = toConstantDependency(
  170. parser,
  171. RuntimeGlobals.moduleCache,
  172. [
  173. RuntimeGlobals.moduleCache,
  174. RuntimeGlobals.moduleId,
  175. RuntimeGlobals.moduleLoaded
  176. ]
  177. );
  178. parser.hooks.expression
  179. .for("require.cache")
  180. .tap("CommonJsImportsParserPlugin", requireCache);
  181. //#endregion
  182. //#region Require as expression
  183. /**
  184. * @param {Expression} expr expression
  185. * @returns {boolean} true when handled
  186. */
  187. const requireAsExpressionHandler = expr => {
  188. const dep = new CommonJsRequireContextDependency(
  189. {
  190. request: options.unknownContextRequest,
  191. recursive: options.unknownContextRecursive,
  192. regExp: options.unknownContextRegExp,
  193. mode: "sync"
  194. },
  195. /** @type {Range} */ (expr.range),
  196. undefined,
  197. parser.scope.inShorthand,
  198. getContext()
  199. );
  200. dep.critical =
  201. options.unknownContextCritical &&
  202. "require function is used in a way in which dependencies cannot be statically extracted";
  203. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  204. dep.optional = !!parser.scope.inTry;
  205. parser.state.current.addDependency(dep);
  206. return true;
  207. };
  208. parser.hooks.expression
  209. .for("require")
  210. .tap("CommonJsImportsParserPlugin", requireAsExpressionHandler);
  211. //#endregion
  212. //#region Require
  213. /**
  214. * @param {CallExpression | NewExpression} expr expression
  215. * @param {BasicEvaluatedExpression} param param
  216. * @returns {boolean | void} true when handled
  217. */
  218. const processRequireItem = (expr, param) => {
  219. if (param.isString()) {
  220. const dep = new CommonJsRequireDependency(
  221. /** @type {string} */ (param.string),
  222. /** @type {Range} */ (param.range),
  223. getContext()
  224. );
  225. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  226. dep.optional = !!parser.scope.inTry;
  227. parser.state.current.addDependency(dep);
  228. return true;
  229. }
  230. };
  231. /**
  232. * @param {CallExpression | NewExpression} expr expression
  233. * @param {BasicEvaluatedExpression} param param
  234. * @returns {boolean | void} true when handled
  235. */
  236. const processRequireContext = (expr, param) => {
  237. const dep = ContextDependencyHelpers.create(
  238. CommonJsRequireContextDependency,
  239. /** @type {Range} */ (expr.range),
  240. param,
  241. expr,
  242. options,
  243. {
  244. category: "commonjs"
  245. },
  246. parser,
  247. undefined,
  248. getContext()
  249. );
  250. if (!dep) return;
  251. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  252. dep.optional = !!parser.scope.inTry;
  253. parser.state.current.addDependency(dep);
  254. return true;
  255. };
  256. /**
  257. * @param {boolean} callNew true, when require is called with new
  258. * @returns {(expr: CallExpression | NewExpression) => (boolean | void)} handler
  259. */
  260. const createRequireHandler = callNew => expr => {
  261. if (options.commonjsMagicComments) {
  262. const { options: requireOptions, errors: commentErrors } =
  263. parser.parseCommentOptions(/** @type {Range} */ (expr.range));
  264. if (commentErrors) {
  265. for (const e of commentErrors) {
  266. const { comment } = e;
  267. parser.state.module.addWarning(
  268. new CommentCompilationWarning(
  269. `Compilation error while processing magic comment(-s): /*${comment.value}*/: ${e.message}`,
  270. comment.loc
  271. )
  272. );
  273. }
  274. }
  275. if (requireOptions) {
  276. if (requireOptions.webpackIgnore !== undefined) {
  277. if (typeof requireOptions.webpackIgnore !== "boolean") {
  278. parser.state.module.addWarning(
  279. new UnsupportedFeatureWarning(
  280. `\`webpackIgnore\` expected a boolean, but received: ${requireOptions.webpackIgnore}.`,
  281. /** @type {DependencyLocation} */ (expr.loc)
  282. )
  283. );
  284. } else {
  285. // Do not instrument `require()` if `webpackIgnore` is `true`
  286. if (requireOptions.webpackIgnore) {
  287. return true;
  288. }
  289. }
  290. }
  291. }
  292. }
  293. if (expr.arguments.length !== 1) return;
  294. let localModule;
  295. const param = parser.evaluateExpression(expr.arguments[0]);
  296. if (param.isConditional()) {
  297. let isExpression = false;
  298. for (const p of /** @type {BasicEvaluatedExpression[]} */ (
  299. param.options
  300. )) {
  301. const result = processRequireItem(expr, p);
  302. if (result === undefined) {
  303. isExpression = true;
  304. }
  305. }
  306. if (!isExpression) {
  307. const dep = new RequireHeaderDependency(
  308. /** @type {Range} */ (expr.callee.range)
  309. );
  310. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  311. parser.state.module.addPresentationalDependency(dep);
  312. return true;
  313. }
  314. }
  315. if (
  316. param.isString() &&
  317. (localModule = getLocalModule(
  318. parser.state,
  319. /** @type {string} */ (param.string)
  320. ))
  321. ) {
  322. localModule.flagUsed();
  323. const dep = new LocalModuleDependency(
  324. localModule,
  325. /** @type {Range} */ (expr.range),
  326. callNew
  327. );
  328. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  329. parser.state.module.addPresentationalDependency(dep);
  330. return true;
  331. } else {
  332. const result = processRequireItem(expr, param);
  333. if (result === undefined) {
  334. processRequireContext(expr, param);
  335. } else {
  336. const dep = new RequireHeaderDependency(
  337. /** @type {Range} */ (expr.callee.range)
  338. );
  339. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  340. parser.state.module.addPresentationalDependency(dep);
  341. }
  342. return true;
  343. }
  344. };
  345. parser.hooks.call
  346. .for("require")
  347. .tap("CommonJsImportsParserPlugin", createRequireHandler(false));
  348. parser.hooks.new
  349. .for("require")
  350. .tap("CommonJsImportsParserPlugin", createRequireHandler(true));
  351. parser.hooks.call
  352. .for("module.require")
  353. .tap("CommonJsImportsParserPlugin", createRequireHandler(false));
  354. parser.hooks.new
  355. .for("module.require")
  356. .tap("CommonJsImportsParserPlugin", createRequireHandler(true));
  357. //#endregion
  358. //#region Require with property access
  359. /**
  360. * @param {Expression} expr expression
  361. * @param {string[]} calleeMembers callee members
  362. * @param {CallExpression} callExpr call expression
  363. * @param {string[]} members members
  364. * @param {Range[]} memberRanges member ranges
  365. * @returns {boolean | void} true when handled
  366. */
  367. const chainHandler = (
  368. expr,
  369. calleeMembers,
  370. callExpr,
  371. members,
  372. memberRanges
  373. ) => {
  374. if (callExpr.arguments.length !== 1) return;
  375. const param = parser.evaluateExpression(callExpr.arguments[0]);
  376. if (
  377. param.isString() &&
  378. !getLocalModule(parser.state, /** @type {string} */ (param.string))
  379. ) {
  380. const dep = new CommonJsFullRequireDependency(
  381. /** @type {string} */ (param.string),
  382. /** @type {Range} */ (expr.range),
  383. members,
  384. /** @type {Range[]} */ memberRanges
  385. );
  386. dep.asiSafe = !parser.isAsiPosition(
  387. /** @type {Range} */ (expr.range)[0]
  388. );
  389. dep.optional = !!parser.scope.inTry;
  390. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  391. parser.state.current.addDependency(dep);
  392. return true;
  393. }
  394. };
  395. /**
  396. * @param {CallExpression} expr expression
  397. * @param {string[]} calleeMembers callee members
  398. * @param {CallExpression} callExpr call expression
  399. * @param {string[]} members members
  400. * @param {Range[]} memberRanges member ranges
  401. * @returns {boolean | void} true when handled
  402. */
  403. const callChainHandler = (
  404. expr,
  405. calleeMembers,
  406. callExpr,
  407. members,
  408. memberRanges
  409. ) => {
  410. if (callExpr.arguments.length !== 1) return;
  411. const param = parser.evaluateExpression(callExpr.arguments[0]);
  412. if (
  413. param.isString() &&
  414. !getLocalModule(parser.state, /** @type {string} */ (param.string))
  415. ) {
  416. const dep = new CommonJsFullRequireDependency(
  417. /** @type {string} */ (param.string),
  418. /** @type {Range} */ (expr.callee.range),
  419. members,
  420. /** @type {Range[]} */ memberRanges
  421. );
  422. dep.call = true;
  423. dep.asiSafe = !parser.isAsiPosition(
  424. /** @type {Range} */ (expr.range)[0]
  425. );
  426. dep.optional = !!parser.scope.inTry;
  427. dep.loc = /** @type {DependencyLocation} */ (expr.callee.loc);
  428. parser.state.current.addDependency(dep);
  429. parser.walkExpressions(expr.arguments);
  430. return true;
  431. }
  432. };
  433. parser.hooks.memberChainOfCallMemberChain
  434. .for("require")
  435. .tap("CommonJsImportsParserPlugin", chainHandler);
  436. parser.hooks.memberChainOfCallMemberChain
  437. .for("module.require")
  438. .tap("CommonJsImportsParserPlugin", chainHandler);
  439. parser.hooks.callMemberChainOfCallMemberChain
  440. .for("require")
  441. .tap("CommonJsImportsParserPlugin", callChainHandler);
  442. parser.hooks.callMemberChainOfCallMemberChain
  443. .for("module.require")
  444. .tap("CommonJsImportsParserPlugin", callChainHandler);
  445. //#endregion
  446. //#region Require.resolve
  447. /**
  448. * @param {CallExpression} expr call expression
  449. * @param {boolean} weak weak
  450. * @returns {boolean | void} true when handled
  451. */
  452. const processResolve = (expr, weak) => {
  453. if (expr.arguments.length !== 1) return;
  454. const param = parser.evaluateExpression(expr.arguments[0]);
  455. if (param.isConditional()) {
  456. for (const option of /** @type {BasicEvaluatedExpression[]} */ (
  457. param.options
  458. )) {
  459. const result = processResolveItem(expr, option, weak);
  460. if (result === undefined) {
  461. processResolveContext(expr, option, weak);
  462. }
  463. }
  464. const dep = new RequireResolveHeaderDependency(
  465. /** @type {Range} */ (expr.callee.range)
  466. );
  467. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  468. parser.state.module.addPresentationalDependency(dep);
  469. return true;
  470. } else {
  471. const result = processResolveItem(expr, param, weak);
  472. if (result === undefined) {
  473. processResolveContext(expr, param, weak);
  474. }
  475. const dep = new RequireResolveHeaderDependency(
  476. /** @type {Range} */ (expr.callee.range)
  477. );
  478. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  479. parser.state.module.addPresentationalDependency(dep);
  480. return true;
  481. }
  482. };
  483. /**
  484. * @param {CallExpression} expr call expression
  485. * @param {BasicEvaluatedExpression} param param
  486. * @param {boolean} weak weak
  487. * @returns {boolean | void} true when handled
  488. */
  489. const processResolveItem = (expr, param, weak) => {
  490. if (param.isString()) {
  491. const dep = new RequireResolveDependency(
  492. /** @type {string} */ (param.string),
  493. /** @type {Range} */ (param.range),
  494. getContext()
  495. );
  496. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  497. dep.optional = !!parser.scope.inTry;
  498. dep.weak = weak;
  499. parser.state.current.addDependency(dep);
  500. return true;
  501. }
  502. };
  503. /**
  504. * @param {CallExpression} expr call expression
  505. * @param {BasicEvaluatedExpression} param param
  506. * @param {boolean} weak weak
  507. * @returns {boolean | void} true when handled
  508. */
  509. const processResolveContext = (expr, param, weak) => {
  510. const dep = ContextDependencyHelpers.create(
  511. RequireResolveContextDependency,
  512. /** @type {Range} */ (param.range),
  513. param,
  514. expr,
  515. options,
  516. {
  517. category: "commonjs",
  518. mode: weak ? "weak" : "sync"
  519. },
  520. parser,
  521. getContext()
  522. );
  523. if (!dep) return;
  524. dep.loc = /** @type {DependencyLocation} */ (expr.loc);
  525. dep.optional = !!parser.scope.inTry;
  526. parser.state.current.addDependency(dep);
  527. return true;
  528. };
  529. parser.hooks.call
  530. .for("require.resolve")
  531. .tap("CommonJsImportsParserPlugin", expr => {
  532. return processResolve(expr, false);
  533. });
  534. parser.hooks.call
  535. .for("require.resolveWeak")
  536. .tap("CommonJsImportsParserPlugin", expr => {
  537. return processResolve(expr, true);
  538. });
  539. //#endregion
  540. //#region Create require
  541. if (!options.createRequire) return;
  542. /** @type {ImportSource[]} */
  543. let moduleName = [];
  544. /** @type {string | undefined} */
  545. let specifierName;
  546. if (options.createRequire === true) {
  547. moduleName = ["module", "node:module"];
  548. specifierName = "createRequire";
  549. } else {
  550. let moduleName;
  551. const match = /^(.*) from (.*)$/.exec(options.createRequire);
  552. if (match) {
  553. [, specifierName, moduleName] = match;
  554. }
  555. if (!specifierName || !moduleName) {
  556. const err = new WebpackError(
  557. `Parsing javascript parser option "createRequire" failed, got ${JSON.stringify(
  558. options.createRequire
  559. )}`
  560. );
  561. err.details =
  562. 'Expected string in format "createRequire from module", where "createRequire" is specifier name and "module" name of the module';
  563. throw err;
  564. }
  565. }
  566. tapRequireExpressionTag(createdRequireIdentifierTag);
  567. tapRequireExpressionTag(createRequireSpecifierTag);
  568. parser.hooks.evaluateCallExpression
  569. .for(createRequireSpecifierTag)
  570. .tap("CommonJsImportsParserPlugin", expr => {
  571. const context = parseCreateRequireArguments(expr);
  572. if (context === undefined) return;
  573. const ident = parser.evaluatedVariable({
  574. tag: createdRequireIdentifierTag,
  575. data: { context },
  576. next: undefined
  577. });
  578. return new BasicEvaluatedExpression()
  579. .setIdentifier(
  580. /** @type {TODO} */ (ident),
  581. /** @type {TODO} */ (ident),
  582. () => []
  583. )
  584. .setSideEffects(false)
  585. .setRange(/** @type {Range} */ (expr.range));
  586. });
  587. parser.hooks.unhandledExpressionMemberChain
  588. .for(createdRequireIdentifierTag)
  589. .tap("CommonJsImportsParserPlugin", (expr, members) => {
  590. return expressionIsUnsupported(
  591. parser,
  592. `createRequire().${members.join(".")} is not supported by webpack.`
  593. )(expr);
  594. });
  595. parser.hooks.canRename
  596. .for(createdRequireIdentifierTag)
  597. .tap("CommonJsImportsParserPlugin", () => true);
  598. parser.hooks.canRename
  599. .for(createRequireSpecifierTag)
  600. .tap("CommonJsImportsParserPlugin", () => true);
  601. parser.hooks.rename
  602. .for(createRequireSpecifierTag)
  603. .tap("CommonJsImportsParserPlugin", defineUndefined);
  604. parser.hooks.expression
  605. .for(createdRequireIdentifierTag)
  606. .tap("CommonJsImportsParserPlugin", requireAsExpressionHandler);
  607. parser.hooks.call
  608. .for(createdRequireIdentifierTag)
  609. .tap("CommonJsImportsParserPlugin", createRequireHandler(false));
  610. /**
  611. * @param {CallExpression} expr call expression
  612. * @returns {string | void} context
  613. */
  614. const parseCreateRequireArguments = expr => {
  615. const args = expr.arguments;
  616. if (args.length !== 1) {
  617. const err = new WebpackError(
  618. "module.createRequire supports only one argument."
  619. );
  620. err.loc = /** @type {DependencyLocation} */ (expr.loc);
  621. parser.state.module.addWarning(err);
  622. return;
  623. }
  624. const arg = args[0];
  625. const evaluated = parser.evaluateExpression(arg);
  626. if (!evaluated.isString()) {
  627. const err = new WebpackError(
  628. "module.createRequire failed parsing argument."
  629. );
  630. err.loc = /** @type {DependencyLocation} */ (arg.loc);
  631. parser.state.module.addWarning(err);
  632. return;
  633. }
  634. const ctx = /** @type {string} */ (evaluated.string).startsWith("file://")
  635. ? fileURLToPath(/** @type {string} */ (evaluated.string))
  636. : /** @type {string} */ (evaluated.string);
  637. // argument always should be a filename
  638. return ctx.slice(0, ctx.lastIndexOf(ctx.startsWith("/") ? "/" : "\\"));
  639. };
  640. parser.hooks.import.tap(
  641. {
  642. name: "CommonJsImportsParserPlugin",
  643. stage: -10
  644. },
  645. (statement, source) => {
  646. if (
  647. !moduleName.includes(source) ||
  648. statement.specifiers.length !== 1 ||
  649. statement.specifiers[0].type !== "ImportSpecifier" ||
  650. statement.specifiers[0].imported.type !== "Identifier" ||
  651. statement.specifiers[0].imported.name !== specifierName
  652. )
  653. return;
  654. // clear for 'import { createRequire as x } from "module"'
  655. // if any other specifier was used import module
  656. const clearDep = new ConstDependency(
  657. parser.isAsiPosition(/** @type {Range} */ (statement.range)[0])
  658. ? ";"
  659. : "",
  660. /** @type {Range} */ (statement.range)
  661. );
  662. clearDep.loc = /** @type {DependencyLocation} */ (statement.loc);
  663. parser.state.module.addPresentationalDependency(clearDep);
  664. parser.unsetAsiPosition(/** @type {Range} */ (statement.range)[1]);
  665. return true;
  666. }
  667. );
  668. parser.hooks.importSpecifier.tap(
  669. {
  670. name: "CommonJsImportsParserPlugin",
  671. stage: -10
  672. },
  673. (statement, source, id, name) => {
  674. if (!moduleName.includes(source) || id !== specifierName) return;
  675. parser.tagVariable(name, createRequireSpecifierTag);
  676. return true;
  677. }
  678. );
  679. parser.hooks.preDeclarator.tap(
  680. "CommonJsImportsParserPlugin",
  681. declarator => {
  682. if (
  683. declarator.id.type !== "Identifier" ||
  684. !declarator.init ||
  685. declarator.init.type !== "CallExpression" ||
  686. declarator.init.callee.type !== "Identifier"
  687. )
  688. return;
  689. const variableInfo =
  690. /** @type {TODO} */
  691. (parser.getVariableInfo(declarator.init.callee.name));
  692. if (
  693. variableInfo &&
  694. variableInfo.tagInfo &&
  695. variableInfo.tagInfo.tag === createRequireSpecifierTag
  696. ) {
  697. const context = parseCreateRequireArguments(declarator.init);
  698. if (context === undefined) return;
  699. parser.tagVariable(declarator.id.name, createdRequireIdentifierTag, {
  700. name: declarator.id.name,
  701. context
  702. });
  703. return true;
  704. }
  705. }
  706. );
  707. parser.hooks.memberChainOfCallMemberChain
  708. .for(createRequireSpecifierTag)
  709. .tap(
  710. "CommonJsImportsParserPlugin",
  711. (expr, calleeMembers, callExpr, members) => {
  712. if (
  713. calleeMembers.length !== 0 ||
  714. members.length !== 1 ||
  715. members[0] !== "cache"
  716. )
  717. return;
  718. // createRequire().cache
  719. const context = parseCreateRequireArguments(callExpr);
  720. if (context === undefined) return;
  721. return requireCache(expr);
  722. }
  723. );
  724. parser.hooks.callMemberChainOfCallMemberChain
  725. .for(createRequireSpecifierTag)
  726. .tap(
  727. "CommonJsImportsParserPlugin",
  728. (expr, calleeMembers, innerCallExpression, members) => {
  729. if (
  730. calleeMembers.length !== 0 ||
  731. members.length !== 1 ||
  732. members[0] !== "resolve"
  733. )
  734. return;
  735. // createRequire().resolve()
  736. return processResolve(expr, false);
  737. }
  738. );
  739. parser.hooks.expressionMemberChain
  740. .for(createdRequireIdentifierTag)
  741. .tap("CommonJsImportsParserPlugin", (expr, members) => {
  742. // require.cache
  743. if (members.length === 1 && members[0] === "cache") {
  744. return requireCache(expr);
  745. }
  746. });
  747. parser.hooks.callMemberChain
  748. .for(createdRequireIdentifierTag)
  749. .tap("CommonJsImportsParserPlugin", (expr, members) => {
  750. // require.resolve()
  751. if (members.length === 1 && members[0] === "resolve") {
  752. return processResolve(expr, false);
  753. }
  754. });
  755. parser.hooks.call
  756. .for(createRequireSpecifierTag)
  757. .tap("CommonJsImportsParserPlugin", expr => {
  758. const clearDep = new ConstDependency(
  759. "/* createRequire() */ undefined",
  760. /** @type {Range} */ (expr.range)
  761. );
  762. clearDep.loc = /** @type {DependencyLocation} */ (expr.loc);
  763. parser.state.module.addPresentationalDependency(clearDep);
  764. return true;
  765. });
  766. //#endregion
  767. }
  768. }
  769. module.exports = CommonJsImportsParserPlugin;