node-html-parser 6.1.12 → 6.1.15-0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [6.1.14](https://github.com/taoqf/node-fast-html-parser/compare/v6.1.13...v6.1.14) (2024-05-14)
+
+
+### Bug Fixes
+
+* [#274](https://github.com/taoqf/node-fast-html-parser/issues/274) ([fef574d](https://github.com/taoqf/node-fast-html-parser/commit/fef574da98ce224980ce6fb9f9ea033d3331a161))
+
+### [6.1.13](https://github.com/taoqf/node-fast-html-parser/compare/v6.1.12...v6.1.13) (2024-03-29)
+
+
+### Bug Fixes
+
+* add rawTagName [#269](https://github.com/taoqf/node-fast-html-parser/issues/269) [#270](https://github.com/taoqf/node-fast-html-parser/issues/270) ([9ac642d](https://github.com/taoqf/node-fast-html-parser/commit/9ac642d7b6a97c84fd4471b8eaa0bd9debf5e325))
+
 ### [6.1.12](https://github.com/taoqf/node-fast-html-parser/compare/v6.1.11...v6.1.12) (2023-12-25)
 
 

package/README.md

@@ -81,15 +81,17 @@ Parse the data provided, and return the root of the generated DOM.
 
   ```js
   {
-    lowerCaseTagName: false,  // convert tag name to lower case (hurts performance heavily)
-    comment: false,            // retrieve comments (hurts performance slightly)
-    voidTag:{
+    lowerCaseTagName: false,		// convert tag name to lower case (hurts performance heavily)
+    comment: false,           		// retrieve comments (hurts performance slightly)
+    fixNestedATags: false,    		// fix invalid nested <a> HTML tags 
+    parseNoneClosedTags: false, 	// close none closed HTML tags instead of removing them 
+    voidTag: {
       tags: ['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', 'track', 'wbr'],	// optional and case insensitive, default value is ['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', 'track', 'wbr']
-      closingSlash: true     // optional, default false. void tag serialisation, add a final slash <br/>
+      closingSlash: true	// optional, default false. void tag serialisation, add a final slash <br/>
     },
     blockTextElements: {
-      script: true,	// keep text content when parsing
-      noscript: true,	// keep text content when parsing
+      script: true,		// keep text content when parsing
+      noscript: true,		// keep text content when parsing
       style: true,		// keep text content when parsing
       pre: true			// keep text content when parsing
     }
@@ -184,6 +186,7 @@ Node --|> TextNode
 Node ..> ClassList
 ```
 
+
 ## HTMLElement Methods
 
 ### trimRight()
@@ -214,9 +217,26 @@ Note: Use * for all elements.
 
 Query closest element by css selector. `null` if not found.
 
+### before(...nodesOrStrings)
+
+Insert one or multiple nodes or text before the current element. Does not work on root.
+
+### after(...nodesOrStrings)
+
+Insert one or multiple nodes or text after the current element. Does not work on root.
+
+### prepend(...nodesOrStrings)
+
+Insert one or multiple nodes or text to the first position of an element's child nodes.
+
+### append(...nodesOrStrings)
+
+Insert one or multiple nodes or text to the last position of an element's child nodes.
+This is similar to appendChild, but accepts arbitrarily many nodes and converts strings to text nodes.
+
 ### appendChild(node)
 
-Append a child node to childNodes
+Append a node to an element's child nodes.
 
 ### insertAdjacentHTML(where, html)
 
@@ -296,6 +316,7 @@ Clone a node.
 
 Get element by it's ID.
 
+
 ## HTMLElement Properties
 
 ### text
@@ -310,7 +331,7 @@ Get escaped (as-is) text value of current node and its children. May have
 
 ### tagName
 
-Get or Set tag name of HTMLElement. Notice: the returned value would be an uppercase string.
+Get or Set tag name of HTMLElement. Note that the returned value is an uppercase string.
 
 ### structuredText
 
@@ -320,13 +341,33 @@ Get structured Text.
 
 Get DOM structure.
 
+### childNodes
+
+Get all child nodes. A child node can be a TextNode, a CommentNode and a HTMLElement.
+
+### children
+
+Get all child elements, so all child nodes of type HTMLELement.
+
 ### firstChild
 
-Get first child node. `undefined` if no child.
+Get first child node. `undefined` if the node has no children.
 
 ### lastChild
 
-Get last child node. `undefined` if no child
+Get last child node. `undefined` if the node has no children.
+
+### firstElementChild
+
+Get the first child of type HTMLElement. `undefined` if none exists.
+
+### lastElementChild
+
+Get the first child of type HTMLElement. `undefined` if none exists.
+
+### childElementCount
+
+Get the number of children that are of type HTMLElement.
 
 ### innerHTML
 

package/dist/main.js

@@ -263,6 +263,7 @@ define("nodes/text", ["require", "exports", "he", "nodes/node", "nodes/type"], f
              * @type {Number}
              */
             _this.nodeType = type_2.default.TEXT_NODE;
+            _this.rawTagName = '';
             _this._rawText = rawText;
             return _this;
         }
@@ -737,7 +738,8 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 return child === _this;
             });
             resetParent([this], null);
-            parent.childNodes = __spreadArray(__spreadArray(__spreadArray([], parent.childNodes.slice(0, idx), true), resetParent(content, parent), true), parent.childNodes.slice(idx + 1), true);
+            resetParent(content, parent);
+            parent.childNodes = __spreadArray(__spreadArray(__spreadArray([], parent.childNodes.slice(0, idx), true), content, true), parent.childNodes.slice(idx + 1), true);
             return this;
         };
         Object.defineProperty(HTMLElement.prototype, "outerHTML", {
@@ -823,6 +825,13 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 _this.childNodes[o++] = node;
             });
             this.childNodes.length = o;
+            // remove whitespace between attributes
+            var attrs = Object.keys(this.rawAttributes).map(function (key) {
+                var val = _this.rawAttributes[key];
+                return "".concat(key, "=").concat(JSON.stringify(val));
+            }).join(' ');
+            this.rawAttrs = attrs;
+            delete this._rawAttrs;
             return this;
         };
         /**
@@ -979,34 +988,9 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
          * @return {Node}      node appended
          */
         HTMLElement.prototype.appendChild = function (node) {
-            // remove the node from it's parent
-            node.remove();
-            this.childNodes.push(node);
-            node.parentNode = this;
+            this.append(node);
             return node;
         };
-        Object.defineProperty(HTMLElement.prototype, "firstChild", {
-            /**
-             * Get first child node
-             * @return {Node | undefined} first child node; or undefined if none
-             */
-            get: function () {
-                return this.childNodes[0];
-            },
-            enumerable: false,
-            configurable: true
-        });
-        Object.defineProperty(HTMLElement.prototype, "lastChild", {
-            /**
-             * Get last child node
-             * @return {Node | undefined} last child node; or undefined if none
-             */
-            get: function () {
-                return (0, back_1.default)(this.childNodes);
-            },
-            enumerable: false,
-            configurable: true
-        });
         Object.defineProperty(HTMLElement.prototype, "attrs", {
             /**
              * Get attributes
@@ -1165,42 +1149,70 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             return this;
         };
         HTMLElement.prototype.insertAdjacentHTML = function (where, html) {
-            var _a, _b, _c;
-            var _this = this;
             if (arguments.length < 2) {
                 throw new Error('2 arguments required');
             }
             var p = parse(html, this._parseOptions);
             if (where === 'afterend') {
-                var idx = this.parentNode.childNodes.findIndex(function (child) {
-                    return child === _this;
-                });
-                resetParent(p.childNodes, this.parentNode);
-                (_a = this.parentNode.childNodes).splice.apply(_a, __spreadArray([idx + 1, 0], p.childNodes, false));
+                this.after.apply(this, p.childNodes);
             }
             else if (where === 'afterbegin') {
-                resetParent(p.childNodes, this);
-                (_b = this.childNodes).unshift.apply(_b, p.childNodes);
+                this.prepend.apply(this, p.childNodes);
             }
             else if (where === 'beforeend') {
-                p.childNodes.forEach(function (n) {
-                    _this.appendChild(n);
-                });
+                this.append.apply(this, p.childNodes);
             }
             else if (where === 'beforebegin') {
-                var idx = this.parentNode.childNodes.findIndex(function (child) {
-                    return child === _this;
-                });
-                resetParent(p.childNodes, this.parentNode);
-                (_c = this.parentNode.childNodes).splice.apply(_c, __spreadArray([idx, 0], p.childNodes, false));
+                this.before.apply(this, p.childNodes);
             }
             else {
                 throw new Error("The value provided ('".concat(where, "') is not one of 'beforebegin', 'afterbegin', 'beforeend', or 'afterend'"));
             }
             return this;
-            // if (!where || html === undefined || html === null) {
-            // 	return;
-            // }
+        };
+        /** Prepend nodes or strings to this node's children. */
+        HTMLElement.prototype.prepend = function () {
+            var _a;
+            var insertable = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                insertable[_i] = arguments[_i];
+            }
+            var nodes = resolveInsertable(insertable);
+            resetParent(nodes, this);
+            (_a = this.childNodes).unshift.apply(_a, nodes);
+        };
+        /** Append nodes or strings to this node's children. */
+        HTMLElement.prototype.append = function () {
+            var _a;
+            var insertable = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                insertable[_i] = arguments[_i];
+            }
+            var nodes = resolveInsertable(insertable);
+            resetParent(nodes, this);
+            (_a = this.childNodes).push.apply(_a, nodes);
+        };
+        /** Insert nodes or strings before this node. */
+        HTMLElement.prototype.before = function () {
+            var insertable = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                insertable[_i] = arguments[_i];
+            }
+            var nodes = resolveInsertable(insertable);
+            var siblings = this.parentNode.childNodes;
+            resetParent(nodes, this.parentNode);
+            siblings.splice.apply(siblings, __spreadArray([siblings.indexOf(this), 0], nodes, false));
+        };
+        /** Insert nodes or strings after this node. */
+        HTMLElement.prototype.after = function () {
+            var insertable = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                insertable[_i] = arguments[_i];
+            }
+            var nodes = resolveInsertable(insertable);
+            var siblings = this.parentNode.childNodes;
+            resetParent(nodes, this.parentNode);
+            siblings.splice.apply(siblings, __spreadArray([siblings.indexOf(this) + 1, 0], nodes, false));
         };
         Object.defineProperty(HTMLElement.prototype, "nextSibling", {
             get: function () {
@@ -1280,6 +1292,72 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             enumerable: false,
             configurable: true
         });
+        Object.defineProperty(HTMLElement.prototype, "children", {
+            /** Get all childNodes of type {@link HTMLElement}. */
+            get: function () {
+                var children = [];
+                for (var _i = 0, _a = this.childNodes; _i < _a.length; _i++) {
+                    var childNode = _a[_i];
+                    if (childNode instanceof HTMLElement) {
+                        children.push(childNode);
+                    }
+                }
+                return children;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(HTMLElement.prototype, "firstChild", {
+            /**
+             * Get the first child node.
+             * @return The first child or undefined if none exists.
+             */
+            get: function () {
+                return this.childNodes[0];
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(HTMLElement.prototype, "firstElementChild", {
+            /**
+             * Get the first child node of type {@link HTMLElement}.
+             * @return The first child element or undefined if none exists.
+             */
+            get: function () {
+                return this.children[0];
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(HTMLElement.prototype, "lastChild", {
+            /**
+             * Get the last child node.
+             * @return The last child or undefined if none exists.
+             */
+            get: function () {
+                return (0, back_1.default)(this.childNodes);
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(HTMLElement.prototype, "lastElementChild", {
+            /**
+             * Get the last child node of type {@link HTMLElement}.
+             * @return The last child element or undefined if none exists.
+             */
+            get: function () {
+                return this.children[this.children.length - 1];
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(HTMLElement.prototype, "childElementCount", {
+            get: function () {
+                return this.children.length;
+            },
+            enumerable: false,
+            configurable: true
+        });
         Object.defineProperty(HTMLElement.prototype, "classNames", {
             get: function () {
                 return this.classList.toString();
@@ -1287,9 +1365,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             enumerable: false,
             configurable: true
         });
-        /**
-         * Clone this Node
-         */
+        /** Clone this Node */
         HTMLElement.prototype.clone = function () {
             return parse(this.toString(), this._parseOptions).firstChild;
         };
@@ -1498,10 +1574,11 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
      * Parse a chuck of HTML source.
      */
     function parse(data, options) {
+        var _a, _b;
         if (options === void 0) { options = {}; }
         var stack = base_parse(data, options);
         var root = stack[0];
-        var _loop_1 = function () {
+        while (stack.length > 1) {
             // Handle each error elements.
             var last = stack.pop();
             var oneBefore = (0, back_1.default)(stack);
@@ -1511,9 +1588,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                     // this is wrong, becouse this will put the H3 outside the current right position which should be inside the current Html Element, see issue 152 for more info
                     if (options.parseNoneClosedTags !== true) {
                         oneBefore.removeChild(last);
-                        last.childNodes.forEach(function (child) {
-                            oneBefore.parentNode.appendChild(child);
-                        });
+                        (_a = oneBefore.parentNode.childNodes).push.apply(_a, last.childNodes);
                         stack.pop();
                     }
                 }
@@ -1523,31 +1598,43 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                     // eslint-disable-next-line no-lonely-if
                     if (options.parseNoneClosedTags !== true) {
                         oneBefore.removeChild(last);
-                        last.childNodes.forEach(function (child) {
-                            oneBefore.appendChild(child);
-                        });
+                        (_b = oneBefore.childNodes).push.apply(_b, last.childNodes);
                     }
                 }
             }
             else {
                 // If it's final element just skip.
             }
-        };
-        while (stack.length > 1) {
-            _loop_1();
         }
         // response.childNodes.forEach((node) => {
         // 	if (node instanceof HTMLElement) {
         // 		node.parentNode = null;
         // 	}
         // });
+        resetParent(root.childNodes, root, true);
         return root;
     }
     exports.parse = parse;
-    function resetParent(nodes, parent) {
-        return nodes.map(function (node) {
+    /**
+     * Resolves a list of {@link NodeInsertable} to a list of nodes,
+     * and removes nodes from any potential parent.
+     */
+    function resolveInsertable(insertable) {
+        return insertable.map(function (val) {
+            if (typeof val === 'string') {
+                return new text_1.default(val);
+            }
+            val.remove();
+            return val;
+        });
+    }
+    function resetParent(nodes, parent, recursive) {
+        if (recursive === void 0) { recursive = false; }
+        nodes.forEach(function (node) {
             node.parentNode = parent;
-            return node;
+            if (recursive && node instanceof HTMLElement) {
+                resetParent(node.childNodes, node, true);
+            }
         });
     }
 });
@@ -1558,10 +1645,12 @@ define("nodes/comment", ["require", "exports", "nodes/node", "nodes/type"], func
     type_4 = __importDefault(type_4);
     var CommentNode = /** @class */ (function (_super) {
         __extends(CommentNode, _super);
-        function CommentNode(rawText, parentNode, range) {
+        function CommentNode(rawText, parentNode, range, rawTagName) {
             if (parentNode === void 0) { parentNode = null; }
+            if (rawTagName === void 0) { rawTagName = '!--'; }
             var _this = _super.call(this, parentNode, range) || this;
             _this.rawText = rawText;
+            _this.rawTagName = rawTagName;
             /**
              * Node Type declaration.
              * @type {Number}
@@ -1570,7 +1659,7 @@ define("nodes/comment", ["require", "exports", "nodes/node", "nodes/type"], func
             return _this;
         }
         CommentNode.prototype.clone = function () {
-            return new CommentNode(this.rawText, null);
+            return new CommentNode(this.rawText, null, undefined, this.rawTagName);
         };
         Object.defineProperty(CommentNode.prototype, "text", {
             /**

package/dist/nodes/comment.d.ts

@@ -3,8 +3,9 @@ import Node from './node';
 import NodeType from './type';
 export default class CommentNode extends Node {
     rawText: string;
+    rawTagName: string;
     clone(): CommentNode;
-    constructor(rawText: string, parentNode?: HTMLElement, range?: [number, number]);
+    constructor(rawText: string, parentNode?: HTMLElement, range?: [number, number], rawTagName?: string);
     /**
      * Node Type declaration.
      * @type {Number}

package/dist/nodes/comment.js

@@ -22,10 +22,12 @@ var node_1 = __importDefault(require("./node"));
 var type_1 = __importDefault(require("./type"));
 var CommentNode = /** @class */ (function (_super) {
     __extends(CommentNode, _super);
-    function CommentNode(rawText, parentNode, range) {
+    function CommentNode(rawText, parentNode, range, rawTagName) {
         if (parentNode === void 0) { parentNode = null; }
+        if (rawTagName === void 0) { rawTagName = '!--'; }
         var _this = _super.call(this, parentNode, range) || this;
         _this.rawText = rawText;
+        _this.rawTagName = rawTagName;
         /**
          * Node Type declaration.
          * @type {Number}
@@ -34,7 +36,7 @@ var CommentNode = /** @class */ (function (_super) {
         return _this;
     }
     CommentNode.prototype.clone = function () {
-        return new CommentNode(this.rawText, null);
+        return new CommentNode(this.rawText, null, undefined, this.rawTagName);
     };
     Object.defineProperty(CommentNode.prototype, "text", {
         /**

package/dist/nodes/html.d.ts

@@ -11,7 +11,8 @@ export interface Attributes {
 export interface RawAttributes {
     [key: string]: string;
 }
-export declare type InsertPosition = 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend';
+export type InsertPosition = 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend';
+export type NodeInsertable = Node | string;
 declare class DOMTokenList {
     private _set;
     private _afterUpdate;
@@ -152,16 +153,6 @@ export default class HTMLElement extends Node {
      * @return {Node}      node appended
      */
     appendChild<T extends Node = Node>(node: T): T;
-    /**
-     * Get first child node
-     * @return {Node | undefined} first child node; or undefined if none
-     */
-    get firstChild(): Node | undefined;
-    /**
-     * Get last child node
-     * @return {Node | undefined} last child node; or undefined if none
-     */
-    get lastChild(): Node | undefined;
     /**
      * Get attributes
      * @access private
@@ -193,14 +184,43 @@ export default class HTMLElement extends Node {
      */
     setAttributes(attributes: Attributes): this;
     insertAdjacentHTML(where: InsertPosition, html: string): this;
+    /** Prepend nodes or strings to this node's children. */
+    prepend(...insertable: NodeInsertable[]): void;
+    /** Append nodes or strings to this node's children. */
+    append(...insertable: NodeInsertable[]): void;
+    /** Insert nodes or strings before this node. */
+    before(...insertable: NodeInsertable[]): void;
+    /** Insert nodes or strings after this node. */
+    after(...insertable: NodeInsertable[]): void;
     get nextSibling(): Node | null;
     get nextElementSibling(): HTMLElement | null;
     get previousSibling(): Node | null;
     get previousElementSibling(): HTMLElement | null;
-    get classNames(): string;
+    /** Get all childNodes of type {@link HTMLElement}. */
+    get children(): HTMLElement[];
+    /**
+     * Get the first child node.
+     * @return The first child or undefined if none exists.
+     */
+    get firstChild(): Node | undefined;
+    /**
+     * Get the first child node of type {@link HTMLElement}.
+     * @return The first child element or undefined if none exists.
+     */
+    get firstElementChild(): HTMLElement | undefined;
     /**
-     * Clone this Node
+     * Get the last child node.
+     * @return The last child or undefined if none exists.
      */
+    get lastChild(): Node | undefined;
+    /**
+     * Get the last child node of type {@link HTMLElement}.
+     * @return The last child element or undefined if none exists.
+     */
+    get lastElementChild(): HTMLElement | undefined;
+    get childElementCount(): number;
+    get classNames(): string;
+    /** Clone this Node */
     clone(): Node;
 }
 export interface Options {

package/dist/nodes/html.js

@@ -403,7 +403,8 @@ var HTMLElement = /** @class */ (function (_super) {
             return child === _this;
         });
         resetParent([this], null);
-        parent.childNodes = __spreadArray(__spreadArray(__spreadArray([], parent.childNodes.slice(0, idx), true), resetParent(content, parent), true), parent.childNodes.slice(idx + 1), true);
+        resetParent(content, parent);
+        parent.childNodes = __spreadArray(__spreadArray(__spreadArray([], parent.childNodes.slice(0, idx), true), content, true), parent.childNodes.slice(idx + 1), true);
         return this;
     };
     Object.defineProperty(HTMLElement.prototype, "outerHTML", {
@@ -489,6 +490,13 @@ var HTMLElement = /** @class */ (function (_super) {
             _this.childNodes[o++] = node;
         });
         this.childNodes.length = o;
+        // remove whitespace between attributes
+        var attrs = Object.keys(this.rawAttributes).map(function (key) {
+            var val = _this.rawAttributes[key];
+            return "".concat(key, "=").concat(JSON.stringify(val));
+        }).join(' ');
+        this.rawAttrs = attrs;
+        delete this._rawAttrs;
         return this;
     };
     /**
@@ -645,34 +653,9 @@ var HTMLElement = /** @class */ (function (_super) {
      * @return {Node}      node appended
      */
     HTMLElement.prototype.appendChild = function (node) {
-        // remove the node from it's parent
-        node.remove();
-        this.childNodes.push(node);
-        node.parentNode = this;
+        this.append(node);
         return node;
     };
-    Object.defineProperty(HTMLElement.prototype, "firstChild", {
-        /**
-         * Get first child node
-         * @return {Node | undefined} first child node; or undefined if none
-         */
-        get: function () {
-            return this.childNodes[0];
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(HTMLElement.prototype, "lastChild", {
-        /**
-         * Get last child node
-         * @return {Node | undefined} last child node; or undefined if none
-         */
-        get: function () {
-            return (0, back_1.default)(this.childNodes);
-        },
-        enumerable: false,
-        configurable: true
-    });
     Object.defineProperty(HTMLElement.prototype, "attrs", {
         /**
          * Get attributes
@@ -831,42 +814,70 @@ var HTMLElement = /** @class */ (function (_super) {
         return this;
     };
     HTMLElement.prototype.insertAdjacentHTML = function (where, html) {
-        var _a, _b, _c;
-        var _this = this;
         if (arguments.length < 2) {
             throw new Error('2 arguments required');
         }
         var p = parse(html, this._parseOptions);
         if (where === 'afterend') {
-            var idx = this.parentNode.childNodes.findIndex(function (child) {
-                return child === _this;
-            });
-            resetParent(p.childNodes, this.parentNode);
-            (_a = this.parentNode.childNodes).splice.apply(_a, __spreadArray([idx + 1, 0], p.childNodes, false));
+            this.after.apply(this, p.childNodes);
         }
         else if (where === 'afterbegin') {
-            resetParent(p.childNodes, this);
-            (_b = this.childNodes).unshift.apply(_b, p.childNodes);
+            this.prepend.apply(this, p.childNodes);
         }
         else if (where === 'beforeend') {
-            p.childNodes.forEach(function (n) {
-                _this.appendChild(n);
-            });
+            this.append.apply(this, p.childNodes);
         }
         else if (where === 'beforebegin') {
-            var idx = this.parentNode.childNodes.findIndex(function (child) {
-                return child === _this;
-            });
-            resetParent(p.childNodes, this.parentNode);
-            (_c = this.parentNode.childNodes).splice.apply(_c, __spreadArray([idx, 0], p.childNodes, false));
+            this.before.apply(this, p.childNodes);
         }
         else {
             throw new Error("The value provided ('".concat(where, "') is not one of 'beforebegin', 'afterbegin', 'beforeend', or 'afterend'"));
         }
         return this;
-        // if (!where || html === undefined || html === null) {
-        // 	return;
-        // }
+    };
+    /** Prepend nodes or strings to this node's children. */
+    HTMLElement.prototype.prepend = function () {
+        var _a;
+        var insertable = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            insertable[_i] = arguments[_i];
+        }
+        var nodes = resolveInsertable(insertable);
+        resetParent(nodes, this);
+        (_a = this.childNodes).unshift.apply(_a, nodes);
+    };
+    /** Append nodes or strings to this node's children. */
+    HTMLElement.prototype.append = function () {
+        var _a;
+        var insertable = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            insertable[_i] = arguments[_i];
+        }
+        var nodes = resolveInsertable(insertable);
+        resetParent(nodes, this);
+        (_a = this.childNodes).push.apply(_a, nodes);
+    };
+    /** Insert nodes or strings before this node. */
+    HTMLElement.prototype.before = function () {
+        var insertable = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            insertable[_i] = arguments[_i];
+        }
+        var nodes = resolveInsertable(insertable);
+        var siblings = this.parentNode.childNodes;
+        resetParent(nodes, this.parentNode);
+        siblings.splice.apply(siblings, __spreadArray([siblings.indexOf(this), 0], nodes, false));
+    };
+    /** Insert nodes or strings after this node. */
+    HTMLElement.prototype.after = function () {
+        var insertable = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            insertable[_i] = arguments[_i];
+        }
+        var nodes = resolveInsertable(insertable);
+        var siblings = this.parentNode.childNodes;
+        resetParent(nodes, this.parentNode);
+        siblings.splice.apply(siblings, __spreadArray([siblings.indexOf(this) + 1, 0], nodes, false));
     };
     Object.defineProperty(HTMLElement.prototype, "nextSibling", {
         get: function () {
@@ -946,6 +957,72 @@ var HTMLElement = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(HTMLElement.prototype, "children", {
+        /** Get all childNodes of type {@link HTMLElement}. */
+        get: function () {
+            var children = [];
+            for (var _i = 0, _a = this.childNodes; _i < _a.length; _i++) {
+                var childNode = _a[_i];
+                if (childNode instanceof HTMLElement) {
+                    children.push(childNode);
+                }
+            }
+            return children;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(HTMLElement.prototype, "firstChild", {
+        /**
+         * Get the first child node.
+         * @return The first child or undefined if none exists.
+         */
+        get: function () {
+            return this.childNodes[0];
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(HTMLElement.prototype, "firstElementChild", {
+        /**
+         * Get the first child node of type {@link HTMLElement}.
+         * @return The first child element or undefined if none exists.
+         */
+        get: function () {
+            return this.children[0];
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(HTMLElement.prototype, "lastChild", {
+        /**
+         * Get the last child node.
+         * @return The last child or undefined if none exists.
+         */
+        get: function () {
+            return (0, back_1.default)(this.childNodes);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(HTMLElement.prototype, "lastElementChild", {
+        /**
+         * Get the last child node of type {@link HTMLElement}.
+         * @return The last child element or undefined if none exists.
+         */
+        get: function () {
+            return this.children[this.children.length - 1];
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(HTMLElement.prototype, "childElementCount", {
+        get: function () {
+            return this.children.length;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(HTMLElement.prototype, "classNames", {
         get: function () {
             return this.classList.toString();
@@ -953,9 +1030,7 @@ var HTMLElement = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
-    /**
-     * Clone this Node
-     */
+    /** Clone this Node */
     HTMLElement.prototype.clone = function () {
         return parse(this.toString(), this._parseOptions).firstChild;
     };
@@ -1164,10 +1239,11 @@ exports.base_parse = base_parse;
  * Parse a chuck of HTML source.
  */
 function parse(data, options) {
+    var _a, _b;
     if (options === void 0) { options = {}; }
     var stack = base_parse(data, options);
     var root = stack[0];
-    var _loop_1 = function () {
+    while (stack.length > 1) {
         // Handle each error elements.
         var last = stack.pop();
         var oneBefore = (0, back_1.default)(stack);
@@ -1177,9 +1253,7 @@ function parse(data, options) {
                 // this is wrong, becouse this will put the H3 outside the current right position which should be inside the current Html Element, see issue 152 for more info
                 if (options.parseNoneClosedTags !== true) {
                     oneBefore.removeChild(last);
-                    last.childNodes.forEach(function (child) {
-                        oneBefore.parentNode.appendChild(child);
-                    });
+                    (_a = oneBefore.parentNode.childNodes).push.apply(_a, last.childNodes);
                     stack.pop();
                 }
             }
@@ -1189,30 +1263,42 @@ function parse(data, options) {
                 // eslint-disable-next-line no-lonely-if
                 if (options.parseNoneClosedTags !== true) {
                     oneBefore.removeChild(last);
-                    last.childNodes.forEach(function (child) {
-                        oneBefore.appendChild(child);
-                    });
+                    (_b = oneBefore.childNodes).push.apply(_b, last.childNodes);
                 }
             }
         }
         else {
             // If it's final element just skip.
         }
-    };
-    while (stack.length > 1) {
-        _loop_1();
     }
     // response.childNodes.forEach((node) => {
     // 	if (node instanceof HTMLElement) {
     // 		node.parentNode = null;
     // 	}
     // });
+    resetParent(root.childNodes, root, true);
     return root;
 }
 exports.parse = parse;
-function resetParent(nodes, parent) {
-    return nodes.map(function (node) {
+/**
+ * Resolves a list of {@link NodeInsertable} to a list of nodes,
+ * and removes nodes from any potential parent.
+ */
+function resolveInsertable(insertable) {
+    return insertable.map(function (val) {
+        if (typeof val === 'string') {
+            return new text_1.default(val);
+        }
+        val.remove();
+        return val;
+    });
+}
+function resetParent(nodes, parent, recursive) {
+    if (recursive === void 0) { recursive = false; }
+    nodes.forEach(function (node) {
         node.parentNode = parent;
-        return node;
+        if (recursive && node instanceof HTMLElement) {
+            resetParent(node.childNodes, node, true);
+        }
     });
 }

package/dist/nodes/node.d.ts

@@ -5,6 +5,7 @@ import HTMLElement from './html';
  */
 export default abstract class Node {
     parentNode: HTMLElement;
+    abstract rawTagName: string;
     abstract nodeType: NodeType;
     childNodes: Node[];
     range: readonly [number, number];

package/dist/nodes/text.d.ts

@@ -13,6 +13,7 @@ export default class TextNode extends Node {
      * @type {Number}
      */
     nodeType: NodeType;
+    rawTagName: string;
     private _rawText;
     private _trimmedRawText?;
     private _trimmedText?;

package/dist/nodes/text.js

@@ -35,6 +35,7 @@ var TextNode = /** @class */ (function (_super) {
          * @type {Number}
          */
         _this.nodeType = type_1.default.TEXT_NODE;
+        _this.rawTagName = '';
         _this._rawText = rawText;
         return _this;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-html-parser",
-	"version": "6.1.12",
+	"version": "6.1.15-0",
 	"description": "A very fast HTML parser, generating a simplified DOM, with basic element query support.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -12,6 +12,7 @@
 		"compile:amd": "tsc -t es5 -m amd -d false --outFile ./dist/main.js",
 		"lint": "eslint ./src/*.ts ./src/**/*.ts",
 		"---------------": "",
+		"pretest": "cd ./test/ && yarn install && cd ..",
 		"test": "yarn run test:target",
 		"test:src": "cross-env TEST_TARGET=src yarn run test",
 		"test:dist": "cross-env TEST_TARGET=dist yarn run test",