ModuleParseError.js 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
  1. /*
  2. MIT License http://www.opensource.org/licenses/mit-license.php
  3. Author Tobias Koppers @sokra
  4. */
  5. "use strict";
  6. const WebpackError = require("./WebpackError");
  7. const makeSerializable = require("./util/makeSerializable");
  8. /** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
  9. /** @typedef {import("./Dependency").SourcePosition} SourcePosition */
  10. /** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
  11. /** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
  12. const WASM_HEADER = Buffer.from([0x00, 0x61, 0x73, 0x6d]);
  13. class ModuleParseError extends WebpackError {
  14. /**
  15. * Creates an instance of ModuleParseError.
  16. * @param {string | Buffer} source source code
  17. * @param {Error & { loc?: SourcePosition }} err the parse error
  18. * @param {string[]} loaders the loaders used
  19. * @param {string} type module type
  20. */
  21. constructor(source, err, loaders, type) {
  22. let message = `Module parse failed: ${err && err.message}`;
  23. /** @type {undefined | DependencyLocation} */
  24. let loc;
  25. if (
  26. ((Buffer.isBuffer(source) && source.subarray(0, 4).equals(WASM_HEADER)) ||
  27. (typeof source === "string" && /^\0asm/.test(source))) &&
  28. !type.startsWith("webassembly")
  29. ) {
  30. message +=
  31. "\nThe module seem to be a WebAssembly module, but module is not flagged as WebAssembly module for webpack.";
  32. message +=
  33. "\nBREAKING CHANGE: Since webpack 5 WebAssembly is not enabled by default and flagged as experimental feature.";
  34. message +=
  35. "\nYou need to enable one of the WebAssembly experiments via 'experiments.asyncWebAssembly: true' (based on async modules) or 'experiments.syncWebAssembly: true' (like webpack 4, deprecated).";
  36. message +=
  37. "\nFor files that transpile to WebAssembly, make sure to set the module type in the 'module.rules' section of the config (e. g. 'type: \"webassembly/async\"').";
  38. } else if (!loaders) {
  39. message +=
  40. "\nYou may need an appropriate loader to handle this file type. " +
  41. "See https://webpack.js.org/concepts/loaders";
  42. } else if (loaders.length >= 1) {
  43. message += `\nFile was processed with these loaders:${loaders
  44. .map((loader) => `\n * ${loader}`)
  45. .join("")}`;
  46. message +=
  47. "\nYou may need an additional loader to handle the result of these loaders.";
  48. } else {
  49. message +=
  50. "\nYou may need an appropriate loader to handle this file type, currently no loaders are configured to process this file. See https://webpack.js.org/concepts#loaders";
  51. }
  52. if (
  53. err &&
  54. err.loc &&
  55. typeof err.loc === "object" &&
  56. typeof err.loc.line === "number"
  57. ) {
  58. const lineNumber = err.loc.line;
  59. if (
  60. Buffer.isBuffer(source) ||
  61. // eslint-disable-next-line no-control-regex
  62. /[\0\u0001\u0002\u0003\u0004\u0005\u0006\u0007]/.test(source)
  63. ) {
  64. // binary file
  65. message += "\n(Source code omitted for this binary file)";
  66. } else {
  67. const sourceLines = source.split(/\r?\n/);
  68. const start = Math.max(0, lineNumber - 3);
  69. const linesBefore = sourceLines.slice(start, lineNumber - 1);
  70. const theLine = sourceLines[lineNumber - 1];
  71. const linesAfter = sourceLines.slice(lineNumber, lineNumber + 2);
  72. message += `${linesBefore
  73. .map((l) => `\n| ${l}`)
  74. .join(
  75. ""
  76. )}\n> ${theLine}${linesAfter.map((l) => `\n| ${l}`).join("")}`;
  77. }
  78. loc = { start: err.loc };
  79. } else if (err && err.stack) {
  80. message += `\n${err.stack}`;
  81. }
  82. super(message);
  83. /** @type {string} */
  84. this.name = "ModuleParseError";
  85. this.loc = loc;
  86. this.error = err;
  87. }
  88. /**
  89. * Serializes this instance into the provided serializer context.
  90. * @param {ObjectSerializerContext} context context
  91. */
  92. serialize(context) {
  93. const { write } = context;
  94. write(this.error);
  95. super.serialize(context);
  96. }
  97. /**
  98. * Restores this instance from the provided deserializer context.
  99. * @param {ObjectDeserializerContext} context context
  100. */
  101. deserialize(context) {
  102. const { read } = context;
  103. this.error = read();
  104. super.deserialize(context);
  105. }
  106. }
  107. makeSerializable(ModuleParseError, "webpack/lib/ModuleParseError");
  108. module.exports = ModuleParseError;