node-html-parser 5.2.5 → 5.3.1

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

@@ -495,7 +495,9 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
                 this.parentNode.childNodes = children.filter(function (child) {
                     return _this !== child;
                 });
+                this.parentNode = null;
             }
+            return this;
         };
         /**
          * Remove Child element from childNodes array
@@ -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
@@ -996,6 +1045,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 +1117,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 +1130,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 +1146,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 +1527,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

@@ -63,18 +63,18 @@ export default class HTMLElement extends Node {
     /**
      * Remove current element
      */
-    remove(): void;
+    remove(): this;
     /**
      * 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 +99,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 +135,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 +173,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 +190,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

@@ -207,7 +207,9 @@ var HTMLElement = /** @class */ (function (_super) {
             this.parentNode.childNodes = children.filter(function (child) {
                 return _this !== child;
             });
+            this.parentNode = null;
         }
+        return this;
     };
     /**
      * Remove Child element from childNodes array
@@ -217,6 +219,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 +234,7 @@ var HTMLElement = /** @class */ (function (_super) {
             }
             return child;
         });
+        return this;
     };
     Object.defineProperty(HTMLElement.prototype, "tagName", {
         get: function () {
@@ -359,7 +363,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 +380,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 +391,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 +405,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 +556,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
@@ -708,6 +757,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 +829,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 +842,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 +858,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 +1239,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/package.json

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