ModuleChunkLoadingPlugin.js 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  1. /*
  2. MIT License http://www.opensource.org/licenses/mit-license.php
  3. Author Tobias Koppers @sokra
  4. */
  5. "use strict";
  6. const RuntimeGlobals = require("../RuntimeGlobals");
  7. const ExportWebpackRequireRuntimeModule = require("./ExportWebpackRequireRuntimeModule");
  8. const ModuleChunkLoadingRuntimeModule = require("./ModuleChunkLoadingRuntimeModule");
  9. /** @typedef {import("../Chunk")} Chunk */
  10. /** @typedef {import("../Compiler")} Compiler */
  11. const PLUGIN_NAME = "ModuleChunkLoadingPlugin";
  12. class ModuleChunkLoadingPlugin {
  13. /**
  14. * Apply the plugin
  15. * @param {Compiler} compiler the compiler instance
  16. * @returns {void}
  17. */
  18. apply(compiler) {
  19. compiler.hooks.thisCompilation.tap(PLUGIN_NAME, compilation => {
  20. const globalChunkLoading = compilation.outputOptions.chunkLoading;
  21. /**
  22. * @param {Chunk} chunk chunk to check
  23. * @returns {boolean} true, when the plugin is enabled for the chunk
  24. */
  25. const isEnabledForChunk = chunk => {
  26. const options = chunk.getEntryOptions();
  27. const chunkLoading =
  28. options && options.chunkLoading !== undefined
  29. ? options.chunkLoading
  30. : globalChunkLoading;
  31. return chunkLoading === "import";
  32. };
  33. const onceForChunkSet = new WeakSet();
  34. /**
  35. * @param {Chunk} chunk chunk to check
  36. * @param {Set<string>} set runtime requirements
  37. */
  38. const handler = (chunk, set) => {
  39. if (onceForChunkSet.has(chunk)) return;
  40. onceForChunkSet.add(chunk);
  41. if (!isEnabledForChunk(chunk)) return;
  42. set.add(RuntimeGlobals.moduleFactoriesAddOnly);
  43. set.add(RuntimeGlobals.hasOwnProperty);
  44. compilation.addRuntimeModule(
  45. chunk,
  46. new ModuleChunkLoadingRuntimeModule(set)
  47. );
  48. };
  49. compilation.hooks.runtimeRequirementInTree
  50. .for(RuntimeGlobals.ensureChunkHandlers)
  51. .tap(PLUGIN_NAME, handler);
  52. compilation.hooks.runtimeRequirementInTree
  53. .for(RuntimeGlobals.baseURI)
  54. .tap(PLUGIN_NAME, handler);
  55. compilation.hooks.runtimeRequirementInTree
  56. .for(RuntimeGlobals.externalInstallChunk)
  57. .tap(PLUGIN_NAME, handler);
  58. compilation.hooks.runtimeRequirementInTree
  59. .for(RuntimeGlobals.onChunksLoaded)
  60. .tap(PLUGIN_NAME, handler);
  61. compilation.hooks.runtimeRequirementInTree
  62. .for(RuntimeGlobals.externalInstallChunk)
  63. .tap(PLUGIN_NAME, (chunk, set) => {
  64. if (!isEnabledForChunk(chunk)) return;
  65. compilation.addRuntimeModule(
  66. chunk,
  67. new ExportWebpackRequireRuntimeModule()
  68. );
  69. });
  70. // We need public path only when we prefetch/preload chunk or public path is not `auto`
  71. compilation.hooks.runtimeRequirementInTree
  72. .for(RuntimeGlobals.prefetchChunkHandlers)
  73. .tap(PLUGIN_NAME, (chunk, set) => {
  74. if (!isEnabledForChunk(chunk)) return;
  75. set.add(RuntimeGlobals.publicPath);
  76. });
  77. compilation.hooks.runtimeRequirementInTree
  78. .for(RuntimeGlobals.preloadChunkHandlers)
  79. .tap(PLUGIN_NAME, (chunk, set) => {
  80. if (!isEnabledForChunk(chunk)) return;
  81. set.add(RuntimeGlobals.publicPath);
  82. });
  83. compilation.hooks.runtimeRequirementInTree
  84. .for(RuntimeGlobals.ensureChunkHandlers)
  85. .tap(PLUGIN_NAME, (chunk, set) => {
  86. if (!isEnabledForChunk(chunk)) return;
  87. if (compilation.outputOptions.publicPath !== "auto") {
  88. set.add(RuntimeGlobals.publicPath);
  89. }
  90. set.add(RuntimeGlobals.getChunkScriptFilename);
  91. });
  92. });
  93. }
  94. }
  95. module.exports = ModuleChunkLoadingPlugin;