node-html-parser 6.1.11 → 6.1.13

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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.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)
+
+
+### Bug Fixes
+
+* [#258](https://github.com/taoqf/node-fast-html-parser/issues/258) ([5a6a614](https://github.com/taoqf/node-fast-html-parser/commit/5a6a61489a62264221dde5e8f76a5d35b18d17bd))
+* nullable return types of HTMLElement ([fe83c3e](https://github.com/taoqf/node-fast-html-parser/commit/fe83c3ee405b2fd973a9d46e4b2ff40f68a5471f))
+
 ### [6.1.11](https://github.com/taoqf/node-fast-html-parser/compare/v6.1.10...v6.1.11) (2023-10-25)
 
 

package/README.md

@@ -202,7 +202,7 @@ Note: Full range of CSS3 selectors supported since v3.0.0.
 
 ### querySelector(selector)
 
-Query CSS Selector to find matching node.
+Query CSS Selector to find matching node. `null` if not found.
 
 ### getElementsByTagName(tagName)
 
@@ -212,7 +212,7 @@ Note: Use * for all elements.
 
 ### closest(selector)
 
-Query closest element by css selector.
+Query closest element by css selector. `null` if not found.
 
 ### appendChild(node)
 
@@ -236,7 +236,7 @@ Remove `key` attribute.
 
 ### getAttribute(key: string)
 
-Get `key` attribute.
+Get `key` attribute. `undefined` if not set.
 
 ### exchangeChild(oldNode: Node, newNode: Node)
 
@@ -292,7 +292,7 @@ Get class names.
 
 Clone a node.
 
-#### getElementById(id: string): HTMLElement
+#### getElementById(id: string): HTMLElement | null
 
 Get element by it's ID.
 
@@ -322,11 +322,11 @@ Get DOM structure.
 
 ### firstChild
 
-Get first child node.
+Get first child node. `undefined` if no child.
 
 ### lastChild
 
-Get last child node.
+Get last child node. `undefined` if no child
 
 ### innerHTML
 
@@ -338,19 +338,19 @@ Get outerHTML.
 
 ### nextSibling
 
-Returns a reference to the next child node of the current element's parent.
+Returns a reference to the next child node of the current element's parent. `null` if not found.
 
 ### nextElementSibling
 
-Returns a reference to the next child element of the current element's parent.
+Returns a reference to the next child element of the current element's parent. `null` if not found.
 
 ### previousSibling
 
-Returns a reference to the previous child node of the current element's parent.
+Returns a reference to the previous child node of the current element's parent. `null` if not found.
 
 ### previousElementSibling
 
-Returns a reference to the previous child element of the current element's parent.
+Returns a reference to the previous child element of the current element's parent. `null` if not found.
 
 ### textContent
 

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;
         }
@@ -888,6 +889,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
         /**
          * find element by it's id
          * @param {string} id the id of the element to select
+         * @returns {HTMLElement | null} the element with the given id or null if not found
          */
         HTMLElement.prototype.getElementById = function (id) {
             var stack = [];
@@ -925,6 +927,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
         /**
          * 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
+         * @returns {HTMLElement | null} the element with the given id or null if not found
          */
         HTMLElement.prototype.closest = function (selector) {
             var mapChild = new Map();
@@ -986,7 +989,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
         Object.defineProperty(HTMLElement.prototype, "firstChild", {
             /**
              * Get first child node
-             * @return {Node} first child node
+             * @return {Node | undefined} first child node; or undefined if none
              */
             get: function () {
                 return this.childNodes[0];
@@ -997,7 +1000,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
         Object.defineProperty(HTMLElement.prototype, "lastChild", {
             /**
              * Get last child node
-             * @return {Node} last child node
+             * @return {Node | undefined} last child node; or undefined if none
              */
             get: function () {
                 return (0, back_1.default)(this.childNodes);
@@ -1078,9 +1081,8 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
             this.rawAttrs = Object.keys(attrs)
                 .map(function (name) {
                 var val = _this.quoteAttribute(attrs[name]);
-                if (val === undefined || val === 'null') {
+                if (val === 'null' || val === '""')
                     return name;
-                }
                 return "".concat(name, "=").concat(val);
             })
                 .join(' ');
@@ -1095,7 +1097,7 @@ define("nodes/html", ["require", "exports", "css-select", "he", "back", "matcher
         };
         /**
          * Get an attribute
-         * @return {string} value of the attribute
+         * @return {string | undefined} value of the attribute; or undefined if not exist
          */
         HTMLElement.prototype.getAttribute = function (key) {
             return this.attrs[key.toLowerCase()];
@@ -1557,10 +1559,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}
@@ -1569,7 +1573,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

@@ -137,13 +137,15 @@ export default class HTMLElement extends Node {
     /**
      * find element by it's id
      * @param {string} id the id of the element to select
+     * @returns {HTMLElement | null} the element with the given id or null if not found
      */
-    getElementById(id: string): HTMLElement;
+    getElementById(id: string): HTMLElement | 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
+     * @returns {HTMLElement | null} the element with the given id or null if not found
      */
-    closest(selector: string): HTMLElement;
+    closest(selector: string): HTMLElement | null;
     /**
      * Append a child node to childNodes
      * @param  {Node} node node to append
@@ -152,14 +154,14 @@ export default class HTMLElement extends Node {
     appendChild<T extends Node = Node>(node: T): T;
     /**
      * Get first child node
-     * @return {Node} first child node
+     * @return {Node | undefined} first child node; or undefined if none
      */
-    get firstChild(): Node;
+    get firstChild(): Node | undefined;
     /**
      * Get last child node
-     * @return {Node} last child node
+     * @return {Node | undefined} last child node; or undefined if none
      */
-    get lastChild(): Node;
+    get lastChild(): Node | undefined;
     /**
      * Get attributes
      * @access private
@@ -176,7 +178,7 @@ export default class HTMLElement extends Node {
     hasAttribute(key: string): boolean;
     /**
      * Get an attribute
-     * @return {string} value of the attribute
+     * @return {string | undefined} value of the attribute; or undefined if not exist
      */
     getAttribute(key: string): string | undefined;
     /**
@@ -191,10 +193,10 @@ export default class HTMLElement extends Node {
      */
     setAttributes(attributes: Attributes): this;
     insertAdjacentHTML(where: InsertPosition, html: string): this;
-    get nextSibling(): Node;
-    get nextElementSibling(): HTMLElement;
-    get previousSibling(): Node;
-    get previousElementSibling(): HTMLElement;
+    get nextSibling(): Node | null;
+    get nextElementSibling(): HTMLElement | null;
+    get previousSibling(): Node | null;
+    get previousElementSibling(): HTMLElement | null;
     get classNames(): string;
     /**
      * Clone this Node

package/dist/nodes/html.js

@@ -554,6 +554,7 @@ var HTMLElement = /** @class */ (function (_super) {
     /**
      * find element by it's id
      * @param {string} id the id of the element to select
+     * @returns {HTMLElement | null} the element with the given id or null if not found
      */
     HTMLElement.prototype.getElementById = function (id) {
         var stack = [];
@@ -591,6 +592,7 @@ var HTMLElement = /** @class */ (function (_super) {
     /**
      * 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
+     * @returns {HTMLElement | null} the element with the given id or null if not found
      */
     HTMLElement.prototype.closest = function (selector) {
         var mapChild = new Map();
@@ -652,7 +654,7 @@ var HTMLElement = /** @class */ (function (_super) {
     Object.defineProperty(HTMLElement.prototype, "firstChild", {
         /**
          * Get first child node
-         * @return {Node} first child node
+         * @return {Node | undefined} first child node; or undefined if none
          */
         get: function () {
             return this.childNodes[0];
@@ -663,7 +665,7 @@ var HTMLElement = /** @class */ (function (_super) {
     Object.defineProperty(HTMLElement.prototype, "lastChild", {
         /**
          * Get last child node
-         * @return {Node} last child node
+         * @return {Node | undefined} last child node; or undefined if none
          */
         get: function () {
             return (0, back_1.default)(this.childNodes);
@@ -744,9 +746,8 @@ var HTMLElement = /** @class */ (function (_super) {
         this.rawAttrs = Object.keys(attrs)
             .map(function (name) {
             var val = _this.quoteAttribute(attrs[name]);
-            if (val === undefined || val === 'null') {
+            if (val === 'null' || val === '""')
                 return name;
-            }
             return "".concat(name, "=").concat(val);
         })
             .join(' ');
@@ -761,7 +762,7 @@ var HTMLElement = /** @class */ (function (_super) {
     };
     /**
      * Get an attribute
-     * @return {string} value of the attribute
+     * @return {string | undefined} value of the attribute; or undefined if not exist
      */
     HTMLElement.prototype.getAttribute = function (key) {
         return this.attrs[key.toLowerCase()];

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.11",
+	"version": "6.1.13",
 	"description": "A very fast HTML parser, generating a simplified DOM, with basic element query support.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",