node-html-parser 5.2.6 → 5.3.0

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

@@ -832,6 +832,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

package/dist/nodes/html.d.ts

@@ -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

package/dist/nodes/html.js

@@ -544,6 +544,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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-html-parser",
-	"version": "5.2.6",
+	"version": "5.3.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",