html-react-parser 5.2.15 → 5.2.17

package/README.md

@@ -614,9 +614,9 @@ npm run benchmark
 Output of benchmark run on MacBook Pro 2024:
 
 ```
-html-to-react - Single x 1,230,874 ops/sec ±0.21% (97 runs sampled)
-html-to-react - Multiple x 502,028 ops/sec ±0.89% (94 runs sampled)
-html-to-react - Complex x 54,401 ops/sec ±0.76% (93 runs sampled)
+html-to-react - Single x 1,270,990 ops/sec ±0.21% (100 runs sampled)
+html-to-react - Multiple x 522,472 ops/sec ±0.64% (94 runs sampled)
+html-to-react - Complex x 54,028 ops/sec ±0.82% (98 runs sampled)
 ```
 
 Run [Size Limit](https://github.com/ai/size-limit):

package/dist/html-react-parser.js

@@ -810,7 +810,7 @@
 			}, {});
 			exports$1.CARRIAGE_RETURN = '\r';
 			exports$1.CARRIAGE_RETURN_REGEX = new RegExp(exports$1.CARRIAGE_RETURN, 'g');
-			exports$1.CARRIAGE_RETURN_PLACEHOLDER = "__HTML_DOM_PARSER_CARRIAGE_RETURN_PLACEHOLDER_".concat(Date.now(), "__");
+			exports$1.CARRIAGE_RETURN_PLACEHOLDER = "__HTML_DOM_PARSER_CARRIAGE_RETURN_PLACEHOLDER_".concat(Date.now().toString(), "__");
 			exports$1.CARRIAGE_RETURN_PLACEHOLDER_REGEX = new RegExp(exports$1.CARRIAGE_RETURN_PLACEHOLDER, 'g');
 			
 		} (constants));
@@ -824,6 +824,7 @@
 		hasRequiredUtilities$2 = 1;
 		Object.defineProperty(utilities$2, "__esModule", { value: true });
 		utilities$2.formatAttributes = formatAttributes;
+		utilities$2.hasOpenTag = hasOpenTag;
 		utilities$2.escapeSpecialCharacters = escapeSpecialCharacters;
 		utilities$2.revertEscapedCharacters = revertEscapedCharacters;
 		utilities$2.formatDOM = formatDOM;
@@ -870,6 +871,28 @@
 		    }
 		    return tagName;
 		}
+		/**
+		 * Checks if an HTML string contains an opening tag (case-insensitive).
+		 *
+		 * @param html - HTML string.
+		 * @param tagName - Tag name to search for (e.g., 'head' or 'body').
+		 * @returns - Whether the tag is found.
+		 */
+		function hasOpenTag(html, tagName) {
+		    var openTag = '<' + tagName;
+		    var index = html.toLowerCase().indexOf(openTag);
+		    if (index === -1) {
+		        return false;
+		    }
+		    var char = html[index + openTag.length];
+		    // the character after the tag name must be '>' or whitespace (for attributes)
+		    return (char === '>' ||
+		        char === ' ' ||
+		        char === '\t' ||
+		        char === '\n' ||
+		        char === '\r' ||
+		        char === '/');
+		}
 		/**
 		 * Escapes special characters before parsing.
 		 *
@@ -897,6 +920,7 @@
 		 * @returns - Nodes.
 		 */
 		function formatDOM(nodes, parent, directive) {
+		    var _a, _b, _c, _d;
 		    if (parent === void 0) { parent = null; }
 		    var domNodes = [];
 		    var current;
@@ -918,16 +942,17 @@
 		                break;
 		            }
 		            case 3:
-		                current = new domhandler_1.Text(revertEscapedCharacters(node.nodeValue));
+		                current = new domhandler_1.Text(revertEscapedCharacters((_a = node.nodeValue) !== null && _a !== void 0 ? _a : ''));
 		                break;
 		            case 8:
-		                current = new domhandler_1.Comment(node.nodeValue);
+		                current = new domhandler_1.Comment((_b = node.nodeValue) !== null && _b !== void 0 ? _b : '');
 		                break;
 		            default:
 		                continue;
 		        }
 		        // set previous node next
-		        var prev = domNodes[index - 1] || null;
+		        var prev = (_c = domNodes[index - 1]) !== null && _c !== void 0 ? _c : null;
+		        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		        if (prev) {
 		            prev.next = current;
 		        }
@@ -939,7 +964,7 @@
 		    }
 		    if (directive) {
 		        current = new domhandler_1.ProcessingInstruction(directive.substring(0, directive.indexOf(' ')).toLowerCase(), directive);
-		        current.next = domNodes[0] || null;
+		        current.next = (_d = domNodes[0]) !== null && _d !== void 0 ? _d : null;
 		        current.parent = parent;
 		        domNodes.unshift(current);
 		        if (domNodes[1]) {
@@ -965,20 +990,17 @@
 		var HEAD = 'head';
 		var BODY = 'body';
 		var FIRST_TAG_REGEX = /<([a-zA-Z]+[0-9]?)/; // e.g., <h1>
-		// match-all-characters in case of newlines (DOTALL)
-		var HEAD_TAG_REGEX = /<head[^]*>/i;
-		var BODY_TAG_REGEX = /<body[^]*>/i;
 		// falls back to `parseFromString` if `createHTMLDocument` cannot be used
-		// eslint-disable-next-line @typescript-eslint/no-unused-vars
+		/* eslint-disable @typescript-eslint/no-unused-vars */
+		/* istanbul ignore start */
 		var parseFromDocument = function (html, tagName) {
-		    /* istanbul ignore next */
 		    throw new Error('This browser does not support `document.implementation.createHTMLDocument`');
 		};
-		// eslint-disable-next-line @typescript-eslint/no-unused-vars
 		var parseFromString = function (html, tagName) {
-		    /* istanbul ignore next */
 		    throw new Error('This browser does not support `DOMParser.prototype.parseFromString`');
 		};
+		/* istanbul ignore stop */
+		/* eslint-enable @typescript-eslint/no-unused-vars */
 		var DOMParser = typeof window === 'object' && window.DOMParser;
 		/**
 		 * DOMParser (performance: slow).
@@ -996,10 +1018,11 @@
 		     * @returns - Document.
 		     */
 		    parseFromString = function (html, tagName) {
+		        /* istanbul ignore start */
 		        if (tagName) {
-		            /* istanbul ignore next */
 		            html = "<".concat(tagName, ">").concat(html, "</").concat(tagName, ">");
 		        }
+		        /* istanbul ignore stop */
 		        return domParser_1.parseFromString(html, mimeType_1);
 		    };
 		    parseFromDocument = parseFromString;
@@ -1009,6 +1032,7 @@
 		 *
 		 * @see https://developer.mozilla.org/docs/Web/API/DOMImplementation/createHTMLDocument
 		 */
+		// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		if (typeof document === 'object' && document.implementation) {
 		    var htmlDocument_1 = document.implementation.createHTMLDocument();
 		    /**
@@ -1019,6 +1043,7 @@
 		     * @returns - Document
 		     */
 		    parseFromDocument = function (html, tagName) {
+		        /* istanbul ignore start */
 		        if (tagName) {
 		            var element = htmlDocument_1.documentElement.querySelector(tagName);
 		            if (element) {
@@ -1026,6 +1051,7 @@
 		            }
 		            return htmlDocument_1;
 		        }
+		        /* istanbul ignore stop */
 		        htmlDocument_1.documentElement.innerHTML = html;
 		        return htmlDocument_1;
 		    };
@@ -1037,6 +1063,7 @@
 		 */
 		var template = typeof document === 'object' && document.createElement('template');
 		var parseFromTemplate;
+		// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		if (template && template.content) {
 		    /**
 		     * Uses a template element (content fragment) to parse HTML.
@@ -1049,6 +1076,9 @@
 		        return template.content.childNodes;
 		    };
 		}
+		var createNodeList = /* istanbul ignore next */ function () {
+		    return document.createDocumentFragment().childNodes;
+		};
 		/**
 		 * Parses HTML string to DOM nodes.
 		 *
@@ -1056,23 +1086,25 @@
 		 * @returns - DOM nodes.
 		 */
 		function domparser$1(html) {
-		    var _a, _b;
+		    var _a, _b, _c, _d, _e, _f;
 		    // Escape special characters before parsing
 		    html = (0, utilities_1.escapeSpecialCharacters)(html);
-		    var match = html.match(FIRST_TAG_REGEX);
-		    var firstTagName = match && match[1] ? match[1].toLowerCase() : '';
+		    var match = FIRST_TAG_REGEX.exec(html);
+		    var firstTagName = (_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.toLowerCase();
 		    switch (firstTagName) {
 		        case HTML: {
 		            var doc = parseFromString(html);
 		            // the created document may come with filler head/body elements,
 		            // so make sure to remove them if they don't actually exist
-		            if (!HEAD_TAG_REGEX.test(html)) {
+		            if (!(0, utilities_1.hasOpenTag)(html, HEAD)) {
 		                var element = doc.querySelector(HEAD);
-		                (_a = element === null || element === void 0 ? void 0 : element.parentNode) === null || _a === void 0 ? void 0 : _a.removeChild(element);
+		                /* istanbul ignore next */
+		                (_b = element === null || element === void 0 ? void 0 : element.parentNode) === null || _b === void 0 ? void 0 : _b.removeChild(element);
 		            }
-		            if (!BODY_TAG_REGEX.test(html)) {
+		            if (!(0, utilities_1.hasOpenTag)(html, BODY)) {
 		                var element = doc.querySelector(BODY);
-		                (_b = element === null || element === void 0 ? void 0 : element.parentNode) === null || _b === void 0 ? void 0 : _b.removeChild(element);
+		                /* istanbul ignore next */
+		                (_c = element === null || element === void 0 ? void 0 : element.parentNode) === null || _c === void 0 ? void 0 : _c.removeChild(element);
 		            }
 		            return doc.querySelectorAll(HTML);
 		        }
@@ -1080,18 +1112,22 @@
 		        case BODY: {
 		            var elements = parseFromDocument(html).querySelectorAll(firstTagName);
 		            // if there's a sibling element, then return both elements
-		            if (BODY_TAG_REGEX.test(html) && HEAD_TAG_REGEX.test(html)) {
-		                return elements[0].parentNode.childNodes;
+		            if ((0, utilities_1.hasOpenTag)(html, BODY) && (0, utilities_1.hasOpenTag)(html, HEAD)) {
+		                /* istanbul ignore next */
+		                return (_e = (_d = elements[0].parentNode) === null || _d === void 0 ? void 0 : _d.childNodes) !== null && _e !== void 0 ? _e : createNodeList();
 		            }
 		            return elements;
 		        }
 		        // low-level tag or text
 		        default: {
+		            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		            if (parseFromTemplate) {
 		                return parseFromTemplate(html);
 		            }
+		            /* istanbul ignore start */
 		            var element = parseFromDocument(html, BODY).querySelector(BODY);
-		            return element.childNodes;
+		            return (_f = element === null || element === void 0 ? void 0 : element.childNodes) !== null && _f !== void 0 ? _f : createNodeList();
+		            /* istanbul ignore stop */
 		        }
 		    }
 		}
@@ -1126,7 +1162,7 @@
 		        return [];
 		    }
 		    // match directive
-		    var match = html.match(DIRECTIVE_REGEX);
+		    var match = DIRECTIVE_REGEX.exec(html);
 		    var directive = match ? match[1] : undefined;
 		    return (0, utilities_1.formatDOM)((0, domparser_1.default)(html), null, directive);
 		}
@@ -2688,7 +2724,7 @@
 			 * @param arg - The argument to be returned.
 			 * @returns - The input argument `arg`.
 			 */
-			var returnFirstArg = function (arg) { return arg; }; // eslint-disable-line @typescript-eslint/no-explicit-any
+			var returnFirstArg = function (arg) { return arg; };
 			exports$1.returnFirstArg = returnFirstArg;
 			
 		} (utilities$1));
@@ -2742,7 +2778,7 @@
 		                propName = getPropName('default' + attributeNameLowerCased);
 		            }
 		            props[propName] = attributeValue;
-		            switch (propertyInfo && propertyInfo.type) {
+		            switch (propertyInfo === null || propertyInfo === void 0 ? void 0 : propertyInfo.type) {
 		                case react_property_1.BOOLEAN:
 		                    props[propName] = true;
 		                    break;
@@ -2783,6 +2819,7 @@
 	function requireDomToReact () {
 		if (hasRequiredDomToReact) return domToReact;
 		hasRequiredDomToReact = 1;
+		/* eslint-disable @typescript-eslint/no-unsafe-enum-comparison */
 		var __importDefault = (domToReact && domToReact.__importDefault) || function (mod) {
 		    return (mod && mod.__esModule) ? mod : { "default": mod };
 		};
@@ -2804,23 +2841,24 @@
 		 * @returns - String or JSX element(s).
 		 */
 		function domToReact$1(nodes, options) {
+		    var _a, _b, _c, _d, _e;
 		    if (options === void 0) { options = {}; }
 		    var reactElements = [];
 		    var hasReplace = typeof options.replace === 'function';
-		    var transform = options.transform || utilities_1.returnFirstArg;
-		    var _a = options.library || React, cloneElement = _a.cloneElement, createElement = _a.createElement, isValidElement = _a.isValidElement;
+		    var transform = (_a = options.transform) !== null && _a !== void 0 ? _a : utilities_1.returnFirstArg;
+		    var _f = (_b = options.library) !== null && _b !== void 0 ? _b : React, cloneElement = _f.cloneElement, createElement = _f.createElement, isValidElement = _f.isValidElement;
 		    var nodesLength = nodes.length;
 		    for (var index = 0; index < nodesLength; index++) {
 		        var node = nodes[index];
 		        // replace with custom React element (if present)
 		        if (hasReplace) {
-		            var replaceElement = options.replace(node, index);
+		            var replaceElement = (_c = options.replace) === null || _c === void 0 ? void 0 : _c.call(options, node, index);
 		            if (isValidElement(replaceElement)) {
 		                // set "key" prop for sibling elements
 		                // https://react.dev/learn/rendering-lists#rules-of-keys
 		                if (nodesLength > 1) {
 		                    replaceElement = cloneElement(replaceElement, {
-		                        key: replaceElement.key || index,
+		                        key: (_d = replaceElement.key) !== null && _d !== void 0 ? _d : index,
 		                    });
 		                }
 		                reactElements.push(transform(replaceElement, node, index));
@@ -2851,6 +2889,7 @@
 		        if (skipAttributesToProps(element)) {
 		            (0, utilities_1.setStyleProp)(element.attribs.style, element.attribs);
 		            props = element.attribs;
+		            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		        }
 		        else if (element.attribs) {
 		            props = (0, attributes_to_props_1.default)(element.attribs, element.name);
@@ -2872,8 +2911,9 @@
 		                // https://react.dev/reference/react-dom/components/textarea#caveats
 		                if (node.name === 'textarea' && node.children[0]) {
 		                    props.defaultValue = node.children[0].data;
+		                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		                }
-		                else if (node.children && node.children.length) {
+		                else if ((_e = node.children) === null || _e === void 0 ? void 0 : _e.length) {
 		                    // continue recursion of creating React elements (if applicable)
 		                    children = domToReact$1(node.children, options);
 		                }
@@ -2939,13 +2979,14 @@
 			 * @returns - React element(s), empty array, or string.
 			 */
 			function HTMLReactParser(html, options) {
+			    var _a;
 			    if (typeof html !== 'string') {
 			        throw new TypeError('First argument must be a string');
 			    }
 			    if (!html) {
 			        return [];
 			    }
-			    return (0, dom_to_react_1.default)((0, html_dom_parser_1.default)(html, (options === null || options === void 0 ? void 0 : options.htmlparser2) || domParserOptions), options);
+			    return (0, dom_to_react_1.default)((0, html_dom_parser_1.default)(html, (_a = options === null || options === void 0 ? void 0 : options.htmlparser2) !== null && _a !== void 0 ? _a : domParserOptions), options);
 			}
 			
 		} (lib$3));