html-minifier-next 4.2.0 → 4.3.0

package/README.md

@@ -4,7 +4,7 @@
 
 HTML Minifier Next (HMN) is a highly **configurable, well-tested, JavaScript-based HTML minifier**.
 
-The project has been based on [HTML Minifier Terser](https://github.com/terser/html-minifier-terser), which in turn had been based on [Juriy Zaytsev’s HTML Minifier](https://github.com/kangax/html-minifier) (HMN offers additional features, but is compatible with both). It was set up because as of 2025, both HTML Minifier Terser and HTML Minifier have been unmaintained for some time. As the project seems maintainable [to me, [Jens](https://meiert.com/)]—even more so with community support—, it’s being updated and documented further in this place.
+The project was based on [HTML Minifier Terser](https://github.com/terser/html-minifier-terser), which in turn had been based on [Juriy Zaytsev’s HTML Minifier](https://github.com/kangax/html-minifier). HMN offers additional features, but is backwards-compatible with both. The project was set up because as of 2025, both HTML Minifier Terser and HTML Minifier had been unmaintained for a few years. As the project seems maintainable [to me, [Jens](https://meiert.com/)]—even more so with community support—, it’s being [updated, extended, and documented](https://github.com/j9t/html-minifier-next/blob/main/CHANGELOG.md) further in this place.
 
 ## Installation
 
@@ -114,6 +114,7 @@ Options can be used in config files (camelCase) or via CLI flags (kebab-case wit
 | `collapseInlineTagWhitespace`<br>`--collapse-inline-tag-whitespace` | Don’t leave any spaces between `display: inline;` elements when collapsing—use with `collapseWhitespace: true` | `false` |
 | `collapseWhitespace`<br>`--collapse-whitespace` | [Collapse whitespace that contributes to text nodes in a document tree](https://perfectionkills.com/experimenting-with-html-minifier#collapse_whitespace) | `false` |
 | `conservativeCollapse`<br>`--conservative-collapse` | Always collapse to 1 space (never remove it entirely)—use with `collapseWhitespace: true` | `false` |
+| `continueOnMinifyError`<br>`--no-continue-on-minify-error` | Continue on minification errors; when `false`, minification errors throw and abort processing | `true` |
 | `continueOnParseError`<br>`--continue-on-parse-error` | [Handle parse errors](https://html.spec.whatwg.org/multipage/parsing.html#parse-errors) instead of aborting | `false` |
 | `customAttrAssign`<br>`--custom-attr-assign` | Arrays of regexes that allow to support custom attribute assign expressions (e.g., `<div flex?="{{mode != cover}}"></div>`) | `[]` |
 | `customAttrCollapse`<br>`--custom-attr-collapse` | Regex that specifies custom attribute to strip newlines from (e.g., `/ng-class/`) | |
@@ -178,10 +179,10 @@ const result = await minify(html, {
 
 Available Lightning CSS options when passed as an object:
 
-* `targets`: Browser targets for vendor prefix optimization (e.g., `{ chrome: 95, firefox: 90 }`)
-* `unusedSymbols`: Array of class names, IDs, keyframe names, and CSS variables to remove
-* `errorRecovery`: Boolean to skip invalid rules instead of throwing errors (disabled in Lightning CSS, but enabled by default in HMN)
-* `sourceMap`: Boolean to generate source maps
+* `targets`: Browser targets for vendor prefix optimization (e.g., `{ chrome: 95, firefox: 90 }`).
+* `unusedSymbols`: Array of class names, IDs, keyframe names, and CSS variables to remove.
+* `errorRecovery`: Boolean to skip invalid rules instead of throwing errors. This is disabled by default in Lightning CSS, but enabled in HMN when the `continueOnMinifyError` option is set to `true` (the default). Explicitly setting `errorRecovery` in `minifyCSS` options will override this automatic behavior.
+* `sourceMap`: Boolean to generate source maps.
 
 For advanced usage, you can also pass a function:
 
@@ -202,23 +203,23 @@ How does HTML Minifier Next compare to other solutions, like [minimize](https://
 | Site | Original Size (KB) | HTML Minifier Next | minimize | html­compressor.com | htmlnano | minify-html |
 | --- | --- | --- | --- | --- | --- | --- |
 | [A List Apart](https://alistapart.com/) | 62 | **52** | 58 | 56 | 54 | 55 |
-| [Amazon](https://www.amazon.com/) | 206 | **195** | 203 | 200 | 196 | n/a |
-| [Apple](https://www.apple.com/) | 153 | **116** | 140 | 140 | 133 | 138 |
-| [BBC](https://www.bbc.co.uk/) | 590 | **534** | 585 | n/a | 553 | 555 |
-| [CSS-Tricks](https://css-tricks.com/) | 165 | **124** | 151 | 147 | 129 | 146 |
-| [ECMAScript](https://tc39.es/ecma262/) | 7238 | **6342** | 6614 | n/a | 6561 | 6567 |
-| [EFF](https://www.eff.org/) | 57 | **48** | 52 | 51 | 51 | 49 |
-| [FAZ](https://www.faz.net/aktuell/) | 1847 | 1722 | 1762 | n/a | **1628** | n/a |
-| [Frontend Dogma](https://frontenddogma.com/) | 219 | **211** | 237 | 218 | 232 | 218 |
-| [Google](https://www.google.com/) | 18 | **16** | 18 | 18 | 17 | n/a |
-| [Ground News](https://ground.news/) | 1709 | **1463** | 1696 | n/a | 1567 | n/a |
+| [Amazon](https://www.amazon.com/) | 822 | **735** | 806 | n/a | n/a | n/a |
+| [Apple](https://www.apple.com/) | 210 | **166** | 195 | 192 | 186 | 191 |
+| [BBC](https://www.bbc.co.uk/) | 698 | **632** | 692 | n/a | 655 | 656 |
+| [CSS-Tricks](https://css-tricks.com/) | 163 | **124** | 149 | 146 | 127 | 145 |
+| [ECMAScript](https://tc39.es/ecma262/) | 7238 | **6342** | 6615 | n/a | 6561 | 6567 |
+| [EFF](https://www.eff.org/) | 54 | **46** | 49 | 49 | 49 | 47 |
+| [FAZ](https://www.faz.net/aktuell/) | 1860 | **1737** | 1775 | n/a | n/a | 1779 |
+| [Frontend Dogma](https://frontenddogma.com/) | 218 | **209** | 235 | 216 | 230 | 217 |
+| [Google](https://www.google.com/) | 18 | **17** | 18 | 18 | **17** | n/a |
+| [Ground News](https://ground.news/) | 1827 | **1585** | 1814 | n/a | 1679 | n/a |
 | [HTML](https://html.spec.whatwg.org/multipage/) | 149 | **147** | 155 | 148 | 153 | 149 |
-| [Leanpub](https://leanpub.com/) | 1424 | **1190** | 1418 | n/a | 1197 | n/a |
+| [Leanpub](https://leanpub.com/) | 1161 | **974** | 1155 | n/a | 981 | n/a |
 | [Mastodon](https://mastodon.social/explore) | 35 | **26** | 34 | 34 | 30 | 33 |
 | [MDN](https://developer.mozilla.org/en-US/) | 107 | **62** | 67 | 68 | 64 | n/a |
-| [Middle East Eye](https://www.middleeasteye.net/) | 224 | **197** | 203 | 204 | 204 | 201 |
-| [SitePoint](https://www.sitepoint.com/) | 536 | **405** | 532 | n/a | 474 | 516 |
-| [United Nations](https://www.un.org/en/) | 151 | **113** | 130 | 123 | 121 | 125 |
+| [Middle East Eye](https://www.middleeasteye.net/) | 223 | **196** | 203 | 203 | 203 | 200 |
+| [SitePoint](https://www.sitepoint.com/) | 494 | **353** | 491 | n/a | 429 | 474 |
+| [United Nations](https://www.un.org/en/) | 152 | **113** | 131 | 124 | 122 | 126 |
 | [W3C](https://www.w3.org/) | 50 | **36** | 41 | 39 | 39 | 39 |
 
 ## Examples

package/cli.js

@@ -121,6 +121,7 @@ const mainOptions = {
   collapseInlineTagWhitespace: 'Don’t leave any spaces between “display: inline;” elements when collapsing—use with “collapseWhitespace=true”',
   collapseWhitespace: 'Collapse whitespace that contributes to text nodes in a document tree',
   conservativeCollapse: 'Always collapse to 1 space (never remove it entirely)—use with “collapseWhitespace=true”',
+  continueOnMinifyError: 'Continue on minification errors',
   continueOnParseError: 'Handle parse errors instead of aborting',
   customAttrAssign: ['Arrays of regexes that allow to support custom attribute assign expressions (e.g., “<div flex?="{{mode != cover}}"></div>”)', parseJSONRegExpArray],
   customAttrCollapse: ['Regex that specifies custom attribute to strip newlines from (e.g., /ng-class/)', parseRegExp],
@@ -167,7 +168,7 @@ mainOptionKeys.forEach(function (key) {
     key = key === 'minifyURLs' ? '--minify-urls' : '--' + paramCase(key);
     key += option[1] === parseJSON ? ' [value]' : ' <value>';
     program.option(key, option[0], option[1]);
-  } else if (~['html5', 'includeAutoGeneratedTags'].indexOf(key)) {
+  } else if (~['html5', 'includeAutoGeneratedTags', 'continueOnMinifyError'].indexOf(key)) {
     program.option('--no-' + paramCase(key), option);
   } else {
     program.option('--' + paramCase(key), option);
@@ -180,8 +181,8 @@ program.option('-d --dry', 'Dry run: process and report statistics without writi
 function readFile(file) {
   try {
     return fs.readFileSync(file, { encoding: 'utf8' });
-  } catch (e) {
-    fatal('Cannot read ' + file + '\n' + e.message);
+  } catch (err) {
+    fatal('Cannot read ' + file + '\n' + err.message);
   }
 }
 
@@ -196,7 +197,7 @@ async function loadConfigFromPath(configPath) {
   // Try JSON first
   try {
     return JSON.parse(data);
-  } catch (je) {
+  } catch (jsonErr) {
     const abs = path.resolve(configPath);
 
     // Try CJS require
@@ -204,13 +205,13 @@ async function loadConfigFromPath(configPath) {
       const result = require(abs);
       // Handle ESM interop: if `require()` loads an ESM file, it may return `{__esModule: true, default: …}`
       return (result && result.__esModule && result.default) ? result.default : result;
-    } catch (ne) {
+    } catch (cjsErr) {
       // Try ESM import
       try {
         const mod = await import(pathToFileURL(abs).href);
         return mod.default || mod;
-      } catch (ee) {
-        fatal('Cannot read the specified config file.\nAs JSON: ' + je.message + '\nAs CJS: ' + ne.message + '\nAs ESM: ' + ee.message);
+      } catch (esmErr) {
+        fatal('Cannot read the specified config file.\nAs JSON: ' + jsonErr.message + '\nAs CJS: ' + cjsErr.message + '\nAs ESM: ' + esmErr.message);
       }
     }
   }
@@ -307,8 +308,8 @@ program.option('--file-ext <extensions>', 'Specify file extension(s) to process
     let minified;
     try {
       minified = await minify(data, createOptions());
-    } catch (e) {
-      fatal('Minification error on ' + inputFile + '\n' + e.message);
+    } catch (err) {
+      fatal('Minification error on ' + inputFile + '\n' + err.message);
     }
 
     const stats = calculateStats(data, minified);
@@ -466,8 +467,8 @@ program.option('--file-ext <extensions>', 'Specify file extension(s) to process
 
     try {
       minified = await minify(content, minifierOptions);
-    } catch (e) {
-      fatal('Minification error:\n' + e.message);
+    } catch (err) {
+      fatal('Minification error:\n' + err.message);
     }
 
     const stats = calculateStats(content, minified);

package/dist/htmlminifier.cjs

@@ -835,6 +835,9 @@ async function cleanAttributeValue(tag, attrName, attrValue, options, attrs, min
       const out = await options.minifyURLs(attrValue);
       return typeof out === 'string' ? out : attrValue;
     } catch (err) {
+      if (!options.continueOnMinifyError) {
+        throw err;
+      }
       options.log && options.log(err);
       return attrValue;
     }
@@ -867,6 +870,9 @@ async function cleanAttributeValue(tag, attrName, attrValue, options, attrs, min
         const out = await options.minifyURLs(url);
         return (typeof out === 'string' ? out : url) + descriptor;
       } catch (err) {
+        if (!options.continueOnMinifyError) {
+          throw err;
+        }
         options.log && options.log(err);
         return url + descriptor;
       }
@@ -1221,6 +1227,7 @@ const processOptions = (inputOptions) => {
     },
     canCollapseWhitespace,
     canTrimWhitespace,
+    continueOnMinifyError: true,
     html5: true,
     ignoreCustomComments: [
       /^!/,
@@ -1266,6 +1273,9 @@ const processOptions = (inputOptions) => {
               const out = await options.minifyURLs(url);
               return prefix + quote + (typeof out === 'string' ? out : url) + quote + suffix;
             } catch (err) {
+              if (!options.continueOnMinifyError) {
+                throw err;
+              }
               options.log && options.log(err);
               return match;
             }
@@ -1279,7 +1289,7 @@ const processOptions = (inputOptions) => {
             filename: 'input.css',
             code: Buffer.from(inputCSS),
             minify: true,
-            errorRecovery: true,
+            errorRecovery: !!options.continueOnMinifyError,
             ...lightningCssOptions
           });
 
@@ -1303,6 +1313,9 @@ const processOptions = (inputOptions) => {
 
           return outputCSS;
         } catch (err) {
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
           options.log && options.log(err);
           return text;
         }
@@ -1328,8 +1341,11 @@ const processOptions = (inputOptions) => {
         try {
           const result = await terser.minify(code, terserOptions);
           return result.code.replace(/;$/, '');
-        } catch (error) {
-          options.log(error);
+        } catch (err) {
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
+          options.log && options.log(err);
           return text;
         }
       };
@@ -1350,7 +1366,10 @@ const processOptions = (inputOptions) => {
         try {
           return RelateURL.relate(text, relateUrlOptions);
         } catch (err) {
-          options.log(err);
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
+          options.log && options.log(err);
           return text;
         }
       };
@@ -2061,6 +2080,13 @@ var htmlminifier = { minify };
  *
  *  Default: `false`
  *
+ * @prop {boolean} [continueOnMinifyError]
+ *  When set to `false`, minification errors may throw.
+ *  By default, the minifier will attempt to recover from minification
+ *  errors, or ignore them and preserve the original content.
+ *
+ *  Default: `true`
+ *
  * @prop {boolean} [continueOnParseError]
  *  When true, the parser will attempt to continue on recoverable parse
  *  errors. Otherwise, parsing errors may throw.

package/dist/htmlminifier.esm.bundle.js

@@ -39888,6 +39888,9 @@ async function cleanAttributeValue(tag, attrName, attrValue, options, attrs, min
       const out = await options.minifyURLs(attrValue);
       return typeof out === 'string' ? out : attrValue;
     } catch (err) {
+      if (!options.continueOnMinifyError) {
+        throw err;
+      }
       options.log && options.log(err);
       return attrValue;
     }
@@ -39920,6 +39923,9 @@ async function cleanAttributeValue(tag, attrName, attrValue, options, attrs, min
         const out = await options.minifyURLs(url);
         return (typeof out === 'string' ? out : url) + descriptor;
       } catch (err) {
+        if (!options.continueOnMinifyError) {
+          throw err;
+        }
         options.log && options.log(err);
         return url + descriptor;
       }
@@ -40274,6 +40280,7 @@ const processOptions = (inputOptions) => {
     },
     canCollapseWhitespace,
     canTrimWhitespace,
+    continueOnMinifyError: true,
     html5: true,
     ignoreCustomComments: [
       /^!/,
@@ -40319,6 +40326,9 @@ const processOptions = (inputOptions) => {
               const out = await options.minifyURLs(url);
               return prefix + quote + (typeof out === 'string' ? out : url) + quote + suffix;
             } catch (err) {
+              if (!options.continueOnMinifyError) {
+                throw err;
+              }
               options.log && options.log(err);
               return match;
             }
@@ -40332,7 +40342,7 @@ const processOptions = (inputOptions) => {
             filename: 'input.css',
             code: Buffer.from(inputCSS),
             minify: true,
-            errorRecovery: true,
+            errorRecovery: !!options.continueOnMinifyError,
             ...lightningCssOptions
           });
 
@@ -40356,6 +40366,9 @@ const processOptions = (inputOptions) => {
 
           return outputCSS;
         } catch (err) {
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
           options.log && options.log(err);
           return text;
         }
@@ -40381,8 +40394,11 @@ const processOptions = (inputOptions) => {
         try {
           const result = await minify$1(code, terserOptions);
           return result.code.replace(/;$/, '');
-        } catch (error) {
-          options.log(error);
+        } catch (err) {
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
+          options.log && options.log(err);
           return text;
         }
       };
@@ -40403,7 +40419,10 @@ const processOptions = (inputOptions) => {
         try {
           return RelateURL.relate(text, relateUrlOptions);
         } catch (err) {
-          options.log(err);
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
+          options.log && options.log(err);
           return text;
         }
       };
@@ -41114,6 +41133,13 @@ var htmlminifier = { minify };
  *
  *  Default: `false`
  *
+ * @prop {boolean} [continueOnMinifyError]
+ *  When set to `false`, minification errors may throw.
+ *  By default, the minifier will attempt to recover from minification
+ *  errors, or ignore them and preserve the original content.
+ *
+ *  Default: `true`
+ *
  * @prop {boolean} [continueOnParseError]
  *  When true, the parser will attempt to continue on recoverable parse
  *  errors. Otherwise, parsing errors may throw.

package/dist/types/htmlminifier.d.ts

@@ -73,6 +73,14 @@ export type MinifierOptions = {
      * Default: `false`
      */
     conservativeCollapse?: boolean;
+    /**
+     * When set to `false`, minification errors may throw.
+     * By default, the minifier will attempt to recover from minification
+     * errors, or ignore them and preserve the original content.
+     *
+     * Default: `true`
+     */
+    continueOnMinifyError?: boolean;
     /**
      * When true, the parser will attempt to continue on recoverable parse
      * errors. Otherwise, parsing errors may throw.

package/dist/types/htmlminifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"htmlminifier.d.ts","sourceRoot":"","sources":["../../src/htmlminifier.js"],"names":[],"mappings":"AAm7CO,8BAJI,MAAM,YACN,eAAe,GACb,OAAO,CAAC,MAAM,CAAC,CAQ3B;;;;;;;;;UAQS,MAAM;YACN,MAAM;YACN,MAAM;mBACN,MAAM;iBACN,MAAM;kBACN,MAAM;;;;;;;;;;;;;4BAQN,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,qBAAqB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,KAAK,OAAO;;;;;;;wBAMjG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,KAAK,OAAO;;;;;;;;oBAMhH,OAAO;;;;;;;;gCAOP,OAAO;;;;;;;;kCAOP,OAAO;;;;;;;;yBAOP,OAAO;;;;;;;;2BAOP,OAAO;;;;;;;2BAOP,OAAO;;;;;;;;uBAMP,MAAM,EAAE;;;;;;yBAOR,MAAM;;;;;;yBAKN,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;;;;;;;4BAKlB,MAAM,EAAE;;;;;;;oCAMR,MAAM;;;;;;;qBAMN,OAAO;;;;;;;YAMP,OAAO;;;;;;;;2BAMP,MAAM,EAAE;;;;;;;;;4BAOR,MAAM,EAAE;;;;;;;+BAQR,OAAO;;;;;;;2BAMP,SAAS,CAAC,MAAM,CAAC;;;;;;uBAMjB,OAAO;;;;;;;;UAKP,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;;;;;;;;qBAO1B,MAAM;;;;;;;oBAON,MAAM;;;;;;;;;;gBAMN,OAAO,GAAG,OAAO,CAAC,OAAO,cAAc,EAAE,gBAAgB,CAAC,OAAO,cAAc,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;;;;;;;;;;eAS9J,OAAO,GAAG,OAAO,QAAQ,EAAE,aAAa,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;;;;;;;;;;iBASzG,OAAO,GAAG,MAAM,GAAG,OAAO,WAAW,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;;;;;;;;WAS7F,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;;;;;;;+BAOxB,OAAO;;;;;;;;yBAMP,OAAO;;;;;;;gCAOP,OAAO;;;;;;;;iCAMP,OAAO;;;;;;;;;;qBAOP,MAAM,EAAE;;;;;;;qBASR,IAAI,GAAG,GAAG;;;;;;;4BAMV,OAAO;;;;;;;;qBAMP,OAAO;;;;;;;;;4BAOP,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;;;;;;;;0BAQtD,OAAO;;;;;;;;yBAOP,OAAO;;;;;;;;gCAOP,OAAO;;;;;;;iCAOP,OAAO;;;;;;;oCAMP,OAAO;;;;;;;;;;0BAMP,OAAO;;;;;;;;;qBASP,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;;;;;;;;;oBAQzD,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;;;;;;;;0BAQrC,OAAO;;;;;;;sBAOP,OAAO"}
+{"version":3,"file":"htmlminifier.d.ts","sourceRoot":"","sources":["../../src/htmlminifier.js"],"names":[],"mappings":"AAs8CO,8BAJI,MAAM,YACN,eAAe,GACb,OAAO,CAAC,MAAM,CAAC,CAQ3B;;;;;;;;;UAQS,MAAM;YACN,MAAM;YACN,MAAM;mBACN,MAAM;iBACN,MAAM;kBACN,MAAM;;;;;;;;;;;;;4BAQN,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,qBAAqB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,KAAK,OAAO;;;;;;;wBAMjG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,KAAK,OAAO;;;;;;;;oBAMhH,OAAO;;;;;;;;gCAOP,OAAO;;;;;;;;kCAOP,OAAO;;;;;;;;yBAOP,OAAO;;;;;;;;2BAOP,OAAO;;;;;;;;4BAOP,OAAO;;;;;;;2BAOP,OAAO;;;;;;;;uBAMP,MAAM,EAAE;;;;;;yBAOR,MAAM;;;;;;yBAKN,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;;;;;;;4BAKlB,MAAM,EAAE;;;;;;;oCAMR,MAAM;;;;;;;qBAMN,OAAO;;;;;;;YAMP,OAAO;;;;;;;;2BAMP,MAAM,EAAE;;;;;;;;;4BAOR,MAAM,EAAE;;;;;;;+BAQR,OAAO;;;;;;;2BAMP,SAAS,CAAC,MAAM,CAAC;;;;;;uBAMjB,OAAO;;;;;;;;UAKP,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;;;;;;;;qBAO1B,MAAM;;;;;;;oBAON,MAAM;;;;;;;;;;gBAMN,OAAO,GAAG,OAAO,CAAC,OAAO,cAAc,EAAE,gBAAgB,CAAC,OAAO,cAAc,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;;;;;;;;;;eAS9J,OAAO,GAAG,OAAO,QAAQ,EAAE,aAAa,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;;;;;;;;;;iBASzG,OAAO,GAAG,MAAM,GAAG,OAAO,WAAW,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;;;;;;;;WAS7F,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;;;;;;;+BAOxB,OAAO;;;;;;;;yBAMP,OAAO;;;;;;;gCAOP,OAAO;;;;;;;;iCAMP,OAAO;;;;;;;;;;qBAOP,MAAM,EAAE;;;;;;;qBASR,IAAI,GAAG,GAAG;;;;;;;4BAMV,OAAO;;;;;;;;qBAMP,OAAO;;;;;;;;;4BAOP,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;;;;;;;;0BAQtD,OAAO;;;;;;;;yBAOP,OAAO;;;;;;;;gCAOP,OAAO;;;;;;;iCAOP,OAAO;;;;;;;oCAMP,OAAO;;;;;;;;;;0BAMP,OAAO;;;;;;;;;qBASP,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;;;;;;;;;oBAQzD,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;;;;;;;;0BAQrC,OAAO;;;;;;;sBAOP,OAAO"}

package/package.json

@@ -22,10 +22,10 @@
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^0.4.4",
     "eslint": "^9.39.1",
-    "rollup": "^4.52.5",
+    "rollup": "^4.53.2",
     "rollup-plugin-polyfill-node": "^0.13.0",
     "typescript": "^5.9.3",
-    "vite": "^7.1.12"
+    "vite": "^7.2.2"
   },
   "exports": {
     ".": {
@@ -84,5 +84,5 @@
     "test:watch": "node --test --watch tests/*.spec.js"
   },
   "type": "module",
-  "version": "4.2.0"
+  "version": "4.3.0"
 }

package/src/htmlminifier.js

@@ -305,6 +305,9 @@ async function cleanAttributeValue(tag, attrName, attrValue, options, attrs, min
       const out = await options.minifyURLs(attrValue);
       return typeof out === 'string' ? out : attrValue;
     } catch (err) {
+      if (!options.continueOnMinifyError) {
+        throw err;
+      }
       options.log && options.log(err);
       return attrValue;
     }
@@ -337,6 +340,9 @@ async function cleanAttributeValue(tag, attrName, attrValue, options, attrs, min
         const out = await options.minifyURLs(url);
         return (typeof out === 'string' ? out : url) + descriptor;
       } catch (err) {
+        if (!options.continueOnMinifyError) {
+          throw err;
+        }
         options.log && options.log(err);
         return url + descriptor;
       }
@@ -691,6 +697,7 @@ const processOptions = (inputOptions) => {
     },
     canCollapseWhitespace,
     canTrimWhitespace,
+    continueOnMinifyError: true,
     html5: true,
     ignoreCustomComments: [
       /^!/,
@@ -736,6 +743,9 @@ const processOptions = (inputOptions) => {
               const out = await options.minifyURLs(url);
               return prefix + quote + (typeof out === 'string' ? out : url) + quote + suffix;
             } catch (err) {
+              if (!options.continueOnMinifyError) {
+                throw err;
+              }
               options.log && options.log(err);
               return match;
             }
@@ -749,7 +759,7 @@ const processOptions = (inputOptions) => {
             filename: 'input.css',
             code: Buffer.from(inputCSS),
             minify: true,
-            errorRecovery: true,
+            errorRecovery: !!options.continueOnMinifyError,
             ...lightningCssOptions
           });
 
@@ -773,6 +783,9 @@ const processOptions = (inputOptions) => {
 
           return outputCSS;
         } catch (err) {
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
           options.log && options.log(err);
           return text;
         }
@@ -798,8 +811,11 @@ const processOptions = (inputOptions) => {
         try {
           const result = await terser(code, terserOptions);
           return result.code.replace(/;$/, '');
-        } catch (error) {
-          options.log(error);
+        } catch (err) {
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
+          options.log && options.log(err);
           return text;
         }
       };
@@ -820,7 +836,10 @@ const processOptions = (inputOptions) => {
         try {
           return RelateURL.relate(text, relateUrlOptions);
         } catch (err) {
-          options.log(err);
+          if (!options.continueOnMinifyError) {
+            throw err;
+          }
+          options.log && options.log(err);
           return text;
         }
       };
@@ -1531,6 +1550,13 @@ export default { minify };
  *
  *  Default: `false`
  *
+ * @prop {boolean} [continueOnMinifyError]
+ *  When set to `false`, minification errors may throw.
+ *  By default, the minifier will attempt to recover from minification
+ *  errors, or ignore them and preserve the original content.
+ *
+ *  Default: `true`
+ *
  * @prop {boolean} [continueOnParseError]
  *  When true, the parser will attempt to continue on recoverable parse
  *  errors. Otherwise, parsing errors may throw.