node-html-parser 5.2.6 → 5.3.2

package/README.md

@@ -203,6 +203,10 @@ Get class names.
 
 Clone a node.
 
+#### Node#getElementById(id: string): HTMLElement;
+
+Get element by it's ID.
+
 ## HTMLElement Properties
 
 ### HTMLElement#text

package/dist/main.js

@@ -73,6 +73,20 @@ define("nodes/node", ["require", "exports", "he"], function (require, exports, h
                 value: range !== null && range !== void 0 ? range : [-1, -1]
             });
         }
+        /**
+         * Remove current node
+         */
+        Node.prototype.remove = function () {
+            var _this = this;
+            if (this.parentNode) {
+                var children = this.parentNode.childNodes;
+                this.parentNode.childNodes = children.filter(function (child) {
+                    return _this !== child;
+                });
+                this.parentNode = null;
+            }
+            return this;
+        };
         Object.defineProperty(Node.prototype, "innerText", {
             get: function () {
                 return this.rawText;
@@ -485,18 +499,6 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             }
             return JSON.stringify(attr.replace(/"/g, '"'));
         };
-        /**
-         * Remove current element
-         */
-        HTMLElement.prototype.remove = function () {
-            var _this = this;
-            if (this.parentNode) {
-                var children = this.parentNode.childNodes;
-                this.parentNode.childNodes = children.filter(function (child) {
-                    return _this !== child;
-                });
-            }
-        };
         /**
          * Remove Child element from childNodes array
          * @param {HTMLElement} node     node to remove
@@ -505,6 +507,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             this.childNodes = this.childNodes.filter(function (child) {
                 return child !== node;
             });
+            return this;
         };
         /**
          * Exchanges given child with new child
@@ -519,6 +522,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 }
                 return child;
             });
+            return this;
         };
         Object.defineProperty(HTMLElement.prototype, "tagName", {
             get: function () {
@@ -647,7 +651,10 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             set: function (content) {
                 //const r = parse(content, global.options); // TODO global.options ?
                 var r = parse(content);
-                this.childNodes = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
+                var nodes = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
+                resetParent(nodes, this);
+                resetParent(this.childNodes, null);
+                this.childNodes = nodes;
             },
             enumerable: false,
             configurable: true
@@ -661,7 +668,10 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 var r = parse(content, options);
                 content = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
             }
+            resetParent(this.childNodes, null);
+            resetParent(content, this);
             this.childNodes = content;
+            return this;
         };
         HTMLElement.prototype.replaceWith = function () {
             var _this = this;
@@ -669,6 +679,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             for (var _i = 0; _i < arguments.length; _i++) {
                 nodes[_i] = arguments[_i];
             }
+            var parent = this.parentNode;
             var content = nodes
                 .map(function (node) {
                 if (node instanceof node_2.default) {
@@ -682,10 +693,11 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 return [];
             })
                 .flat();
-            var idx = this.parentNode.childNodes.findIndex(function (child) {
+            var idx = parent.childNodes.findIndex(function (child) {
                 return child === _this;
             });
-            this.parentNode.childNodes = __spreadArray(__spreadArray(__spreadArray([], this.parentNode.childNodes.slice(0, idx), true), content, true), this.parentNode.childNodes.slice(idx + 1), true);
+            resetParent([this], null);
+            parent.childNodes = __spreadArray(__spreadArray(__spreadArray([], parent.childNodes.slice(0, idx), true), resetParent(content, parent), true), parent.childNodes.slice(idx + 1), true);
         };
         Object.defineProperty(HTMLElement.prototype, "outerHTML", {
             get: function () {
@@ -832,6 +844,43 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             }
             return re;
         };
+        /**
+         * find element by it's id
+         * @param {string} id the id of the element to select
+         */
+        HTMLElement.prototype.getElementById = function (id) {
+            var stack = [];
+            var currentNodeReference = this;
+            var index = 0;
+            // index turns to undefined once the stack is empty and the first condition occurs
+            // which happens once all relevant children are searched through
+            while (index !== undefined) {
+                var child = void 0;
+                // make it work with sparse arrays
+                do {
+                    child = currentNodeReference.childNodes[index++];
+                } while (index < currentNodeReference.childNodes.length && child === undefined);
+                // if the child does not exist we move on with the last provided index (which belongs to the parentNode)
+                if (child === undefined) {
+                    currentNodeReference = currentNodeReference.parentNode;
+                    index = stack.pop();
+                    continue;
+                }
+                if (child.nodeType === type_3.default.ELEMENT_NODE) {
+                    if (child.id === id) {
+                        return child;
+                    }
+                    ;
+                    // if children are existing push the current status to the stack and keep searching for elements in the level below
+                    if (child.childNodes.length > 0) {
+                        stack.push(index);
+                        currentNodeReference = child;
+                        index = 0;
+                    }
+                }
+            }
+            return null;
+        };
         /**
          * traverses the Element and its parents (heading toward the document root) until it finds a node that matches the provided selector string. Will return itself or the matching ancestor. If no such element exists, it returns null.
          * @param selector a DOMString containing a selector list
@@ -887,7 +936,8 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
          * @return {Node}      node appended
          */
         HTMLElement.prototype.appendChild = function (node) {
-            // node.parentNode = this;
+            // remove the node from it's parent
+            node.remove();
             this.childNodes.push(node);
             node.parentNode = this;
             return node;
@@ -996,6 +1046,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             if (key === 'id') {
                 this.id = '';
             }
+            return this;
         };
         HTMLElement.prototype.hasAttribute = function (key) {
             return key.toLowerCase() in this.attrs;
@@ -1067,6 +1118,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 return "".concat(name, "=").concat(_this.quoteAttribute(String(val)));
             })
                 .join(' ');
+            return this;
         };
         HTMLElement.prototype.insertAdjacentHTML = function (where, html) {
             var _a, _b, _c;
@@ -1079,14 +1131,11 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 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));
-                p.childNodes.forEach(function (n) {
-                    if (n instanceof HTMLElement) {
-                        n.parentNode = _this.parentNode;
-                    }
-                });
             }
             else if (where === 'afterbegin') {
+                resetParent(p.childNodes, this);
                 (_b = this.childNodes).unshift.apply(_b, p.childNodes);
             }
             else if (where === 'beforeend') {
@@ -1098,16 +1147,13 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 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));
-                p.childNodes.forEach(function (n) {
-                    if (n instanceof HTMLElement) {
-                        n.parentNode = _this.parentNode;
-                    }
-                });
             }
             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;
             // }
@@ -1482,6 +1528,12 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
         return root;
     }
     exports.parse = parse;
+    function resetParent(nodes, parent) {
+        return nodes.map(function (node) {
+            node.parentNode = parent;
+            return node;
+        });
+    }
 });
 define("nodes/comment", ["require", "exports", "nodes/node", "nodes/type"], function (require, exports, node_3, type_4) {
     "use strict";

package/dist/nodes/html.d.ts

@@ -60,21 +60,17 @@ export default class HTMLElement extends Node {
      * @memberof HTMLElement
      */
     constructor(tagName: string, keyAttrs: KeyAttributes, rawAttrs: string, parentNode: HTMLElement | null, range?: [number, number]);
-    /**
-     * Remove current element
-     */
-    remove(): void;
     /**
      * Remove Child element from childNodes array
      * @param {HTMLElement} node     node to remove
      */
-    removeChild(node: Node): void;
+    removeChild(node: Node): this;
     /**
      * Exchanges given child with new child
      * @param {HTMLElement} oldNode     node to exchange
      * @param {HTMLElement} newNode     new node
      */
-    exchangeChild(oldNode: Node, newNode: Node): void;
+    exchangeChild(oldNode: Node, newNode: Node): this;
     get tagName(): string;
     set tagName(newname: string);
     get localName(): string;
@@ -99,7 +95,7 @@ export default class HTMLElement extends Node {
     toString(): string;
     get innerHTML(): string;
     set innerHTML(content: string);
-    set_content(content: string | Node | Node[], options?: Options): void;
+    set_content(content: string | Node | Node[], options?: Options): this;
     replaceWith(...nodes: (string | Node)[]): void;
     get outerHTML(): string;
     /**
@@ -135,6 +131,11 @@ export default class HTMLElement extends Node {
      * @param {string} tagName the tagName of the elements to select
      */
     getElementsByTagName(tagName: string): Array<HTMLElement>;
+    /**
+     * find element by it's id
+     * @param {string} id the id of the element to select
+     */
+    getElementById(id: string): HTMLElement;
     /**
      * traverses the Element and its parents (heading toward the document root) until it finds a node that matches the provided selector string. Will return itself or the matching ancestor. If no such element exists, it returns null.
      * @param selector a DOMString containing a selector list
@@ -168,7 +169,7 @@ export default class HTMLElement extends Node {
      * @return {Object} parsed attributes
      */
     get rawAttributes(): RawAttributes;
-    removeAttribute(key: string): void;
+    removeAttribute(key: string): this;
     hasAttribute(key: string): boolean;
     /**
      * Get an attribute
@@ -185,8 +186,8 @@ export default class HTMLElement extends Node {
      * Replace all the attributes of the HTMLElement by the provided attributes
      * @param {Attributes} attributes the new attribute set
      */
-    setAttributes(attributes: Attributes): void;
-    insertAdjacentHTML(where: InsertPosition, html: string): void;
+    setAttributes(attributes: Attributes): this;
+    insertAdjacentHTML(where: InsertPosition, html: string): this;
     get nextSibling(): Node;
     get nextElementSibling(): HTMLElement;
     get previousSibling(): Node;

package/dist/nodes/html.js

@@ -197,18 +197,6 @@ var HTMLElement = /** @class */ (function (_super) {
         }
         return JSON.stringify(attr.replace(/"/g, '"'));
     };
-    /**
-     * Remove current element
-     */
-    HTMLElement.prototype.remove = function () {
-        var _this = this;
-        if (this.parentNode) {
-            var children = this.parentNode.childNodes;
-            this.parentNode.childNodes = children.filter(function (child) {
-                return _this !== child;
-            });
-        }
-    };
     /**
      * Remove Child element from childNodes array
      * @param {HTMLElement} node     node to remove
@@ -217,6 +205,7 @@ var HTMLElement = /** @class */ (function (_super) {
         this.childNodes = this.childNodes.filter(function (child) {
             return child !== node;
         });
+        return this;
     };
     /**
      * Exchanges given child with new child
@@ -231,6 +220,7 @@ var HTMLElement = /** @class */ (function (_super) {
             }
             return child;
         });
+        return this;
     };
     Object.defineProperty(HTMLElement.prototype, "tagName", {
         get: function () {
@@ -359,7 +349,10 @@ var HTMLElement = /** @class */ (function (_super) {
         set: function (content) {
             //const r = parse(content, global.options); // TODO global.options ?
             var r = parse(content);
-            this.childNodes = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
+            var nodes = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
+            resetParent(nodes, this);
+            resetParent(this.childNodes, null);
+            this.childNodes = nodes;
         },
         enumerable: false,
         configurable: true
@@ -373,7 +366,10 @@ var HTMLElement = /** @class */ (function (_super) {
             var r = parse(content, options);
             content = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
         }
+        resetParent(this.childNodes, null);
+        resetParent(content, this);
         this.childNodes = content;
+        return this;
     };
     HTMLElement.prototype.replaceWith = function () {
         var _this = this;
@@ -381,6 +377,7 @@ var HTMLElement = /** @class */ (function (_super) {
         for (var _i = 0; _i < arguments.length; _i++) {
             nodes[_i] = arguments[_i];
         }
+        var parent = this.parentNode;
         var content = nodes
             .map(function (node) {
             if (node instanceof node_1.default) {
@@ -394,10 +391,11 @@ var HTMLElement = /** @class */ (function (_super) {
             return [];
         })
             .flat();
-        var idx = this.parentNode.childNodes.findIndex(function (child) {
+        var idx = parent.childNodes.findIndex(function (child) {
             return child === _this;
         });
-        this.parentNode.childNodes = __spreadArray(__spreadArray(__spreadArray([], this.parentNode.childNodes.slice(0, idx), true), content, true), this.parentNode.childNodes.slice(idx + 1), true);
+        resetParent([this], null);
+        parent.childNodes = __spreadArray(__spreadArray(__spreadArray([], parent.childNodes.slice(0, idx), true), resetParent(content, parent), true), parent.childNodes.slice(idx + 1), true);
     };
     Object.defineProperty(HTMLElement.prototype, "outerHTML", {
         get: function () {
@@ -544,6 +542,43 @@ var HTMLElement = /** @class */ (function (_super) {
         }
         return re;
     };
+    /**
+     * find element by it's id
+     * @param {string} id the id of the element to select
+     */
+    HTMLElement.prototype.getElementById = function (id) {
+        var stack = [];
+        var currentNodeReference = this;
+        var index = 0;
+        // index turns to undefined once the stack is empty and the first condition occurs
+        // which happens once all relevant children are searched through
+        while (index !== undefined) {
+            var child = void 0;
+            // make it work with sparse arrays
+            do {
+                child = currentNodeReference.childNodes[index++];
+            } while (index < currentNodeReference.childNodes.length && child === undefined);
+            // if the child does not exist we move on with the last provided index (which belongs to the parentNode)
+            if (child === undefined) {
+                currentNodeReference = currentNodeReference.parentNode;
+                index = stack.pop();
+                continue;
+            }
+            if (child.nodeType === type_1.default.ELEMENT_NODE) {
+                if (child.id === id) {
+                    return child;
+                }
+                ;
+                // if children are existing push the current status to the stack and keep searching for elements in the level below
+                if (child.childNodes.length > 0) {
+                    stack.push(index);
+                    currentNodeReference = child;
+                    index = 0;
+                }
+            }
+        }
+        return null;
+    };
     /**
      * traverses the Element and its parents (heading toward the document root) until it finds a node that matches the provided selector string. Will return itself or the matching ancestor. If no such element exists, it returns null.
      * @param selector a DOMString containing a selector list
@@ -599,7 +634,8 @@ var HTMLElement = /** @class */ (function (_super) {
      * @return {Node}      node appended
      */
     HTMLElement.prototype.appendChild = function (node) {
-        // node.parentNode = this;
+        // remove the node from it's parent
+        node.remove();
         this.childNodes.push(node);
         node.parentNode = this;
         return node;
@@ -708,6 +744,7 @@ var HTMLElement = /** @class */ (function (_super) {
         if (key === 'id') {
             this.id = '';
         }
+        return this;
     };
     HTMLElement.prototype.hasAttribute = function (key) {
         return key.toLowerCase() in this.attrs;
@@ -779,6 +816,7 @@ var HTMLElement = /** @class */ (function (_super) {
             return "".concat(name, "=").concat(_this.quoteAttribute(String(val)));
         })
             .join(' ');
+        return this;
     };
     HTMLElement.prototype.insertAdjacentHTML = function (where, html) {
         var _a, _b, _c;
@@ -791,14 +829,11 @@ var HTMLElement = /** @class */ (function (_super) {
             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));
-            p.childNodes.forEach(function (n) {
-                if (n instanceof HTMLElement) {
-                    n.parentNode = _this.parentNode;
-                }
-            });
         }
         else if (where === 'afterbegin') {
+            resetParent(p.childNodes, this);
             (_b = this.childNodes).unshift.apply(_b, p.childNodes);
         }
         else if (where === 'beforeend') {
@@ -810,16 +845,13 @@ var HTMLElement = /** @class */ (function (_super) {
             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));
-            p.childNodes.forEach(function (n) {
-                if (n instanceof HTMLElement) {
-                    n.parentNode = _this.parentNode;
-                }
-            });
         }
         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;
         // }
@@ -1194,3 +1226,9 @@ function parse(data, options) {
     return root;
 }
 exports.parse = parse;
+function resetParent(nodes, parent) {
+    return nodes.map(function (node) {
+        node.parentNode = parent;
+        return node;
+    });
+}

package/dist/nodes/node.d.ts

@@ -13,6 +13,10 @@ export default abstract class Node {
     abstract toString(): string;
     abstract clone(): Node;
     constructor(parentNode?: HTMLElement, range?: [number, number]);
+    /**
+     * Remove current node
+     */
+    remove(): this;
     get innerText(): string;
     get textContent(): string;
     set textContent(val: string);

package/dist/nodes/node.js

@@ -16,6 +16,20 @@ var Node = /** @class */ (function () {
             value: range !== null && range !== void 0 ? range : [-1, -1]
         });
     }
+    /**
+     * Remove current node
+     */
+    Node.prototype.remove = function () {
+        var _this = this;
+        if (this.parentNode) {
+            var children = this.parentNode.childNodes;
+            this.parentNode.childNodes = children.filter(function (child) {
+                return _this !== child;
+            });
+            this.parentNode = null;
+        }
+        return this;
+    };
     Object.defineProperty(Node.prototype, "innerText", {
         get: function () {
             return this.rawText;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-html-parser",
-	"version": "5.2.6",
+	"version": "5.3.2",
 	"description": "A very fast HTML parser, generating a simplified DOM, with basic element query support.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",