feat: validate chunk-related options for the plugin

index.js

@@ -15,6 +15,7 @@ const {
 } = require("./lib/html-tags");
 const prettyError = require("./lib/errors.js");
 const chunkSorter = require("./lib/chunksorter.js");
+const validateChunkNames = require("./lib/validators");
 const { AsyncSeriesWaterfallHook } = require("tapable");
 
 /** @typedef {import("./typings").HtmlTagObject} HtmlTagObject */
@@ -1195,6 +1196,34 @@ class HtmlWebpackPlugin {
     return result;
   }
 
+  /**
+   * @param {(string | null | undefined)[]} allChunkNames - all compilation chunk names
+   * @returns {Error[]} validation errors
+   */
+  validateOptions(allChunkNames) {
+    const validationErrors = [];
+    if (this.options.chunks !== "all") {
+      const chunksErr = validateChunkNames(
+        allChunkNames,
+        this.options.chunks,
+        "chunks",
+      );
+      if (chunksErr) {
+        validationErrors.push(chunksErr);
+      }
+    }
+    const excludeChunksErr = validateChunkNames(
+      allChunkNames,
+      this.options.excludeChunks,
+      "excludeChunks",
+    );
+    if (excludeChunksErr) {
+      validationErrors.push(excludeChunksErr);
+    }
+
+    return validationErrors;
+  }
+
   /**
    * Replace [contenthash] in filename
    *
@@ -1261,6 +1290,15 @@ class HtmlWebpackPlugin {
   ) {
     // Get all entry point names for this html file
     const entryNames = Array.from(compilation.entrypoints.keys());
+
+    // Get all chunk names
+    const allChunkNames = Array.from(compilation.chunks).map((c) => c.name);
+
+    const validationErrors = this.validateOptions(allChunkNames);
+    if (validationErrors.length) {
+      compilation.errors.push(...validationErrors);
+    }
+
     const filteredEntryNames = this.filterEntryChunks(
       entryNames,
       this.options.chunks,

lib/validators.js

@@ -0,0 +1,22 @@
+/**
+ * Validates that all expected chunks are part of the compilation result
+ *
+ * @param {(string | null | undefined)[]} allChunkNames - all compilation chunk names
+ * @param {string[]} expectedChunkNames - expected chunk names
+ * @param {string} label
+ * @returns {Error | undefined} validation errors
+ */
+module.exports = function (allChunkNames, expectedChunkNames, label) {
+  if (Array.isArray(expectedChunkNames)) {
+    const missingChunks = expectedChunkNames.filter(
+      (chunkName) => !allChunkNames.includes(chunkName),
+    );
+
+    if (missingChunks.length) {
+      const chunksStr = missingChunks.join(", ");
+      return new Error(
+        `HtmlWebpackPlugin: The following chunks provided in the '${label}' option were not found: ${chunksStr}`,
+      );
+    }
+  }
+};

spec/basic.spec.js

@@ -3048,6 +3048,60 @@ describe("HtmlWebpackPlugin", () => {
     );
   });
 
+  it("throws an error if a specified chunk in the chunks option is not found", (done) => {
+    testHtmlPlugin(
+      {
+        mode: "production",
+        entry: {
+          app: path.join(__dirname, "fixtures/index.js"),
+        },
+        output: {
+          path: OUTPUT_DIR,
+          filename: "[name]_bundle.js",
+        },
+        optimization: {
+          emitOnErrors: true,
+        },
+        plugins: [
+          new HtmlWebpackPlugin({
+            chunks: ["app", "non_existent_chunk"],
+          }),
+        ],
+      },
+      [],
+      null,
+      done,
+      true,
+    );
+  });
+
+  it("throws an error if a specified chunk in the excludeChunks option is not found", (done) => {
+    testHtmlPlugin(
+      {
+        mode: "production",
+        entry: {
+          app: path.join(__dirname, "fixtures/index.js"),
+        },
+        output: {
+          path: OUTPUT_DIR,
+          filename: "[name]_bundle.js",
+        },
+        optimization: {
+          emitOnErrors: true,
+        },
+        plugins: [
+          new HtmlWebpackPlugin({
+            excludeChunks: ["non_existent_chunk"],
+          }),
+        ],
+      },
+      [],
+      null,
+      done,
+      true,
+    );
+  });
+
   it("should add the webpack compilation object as a property of the templateParam object", (done) => {
     testHtmlPlugin(
       {