tiny-essentials 1.22.2 → 1.22.3

package/dist/v1/libs/TinyHtml.cjs

@@ -6736,6 +6736,31 @@ class TinyHtml {
     return TinyHtml.toggleProp(this, name, force);
   }
 
+  /**
+   * Get properties on an element.
+   *
+   * @param {TinyHtmlElement} el - Target element.
+   * @param {string} name - Property name.
+   * @returns {any} - Property value if getting, otherwise `undefined`.
+   */
+  static prop(el, name) {
+    if (typeof name !== 'string')
+      throw new TypeError('Invalid arguments passed to prop(). Expected string for "name".');
+    const elem = TinyHtml._preElem(el, 'attr');
+    // @ts-ignore
+    return elem[name];
+  }
+
+  /**
+   * Get properties on an element.
+   *
+   * @param {string} name - Property name.
+   * @returns {any} - Property value if getting, otherwise `undefined`.
+   */
+  prop(name) {
+    return TinyHtml.prop(this, name);
+  }
+
   /////////////////////////////////////////////////////
 
   // TITLE: Remove Element

package/dist/v1/libs/TinyHtml.d.mts

@@ -2409,6 +2409,14 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * @returns {T}
      */
     static toggleProp<T extends TinyElement | TinyElement[]>(el: T, name: string | string[], force?: boolean): T;
+    /**
+     * Get properties on an element.
+     *
+     * @param {TinyHtmlElement} el - Target element.
+     * @param {string} name - Property name.
+     * @returns {any} - Property value if getting, otherwise `undefined`.
+     */
+    static prop(el: TinyHtmlElement, name: string): any;
     /**
      * Removes an element from the DOM.
      * @template {TinyElement|TinyElement[]} T
@@ -3554,6 +3562,13 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * @returns {this}
      */
     toggleProp(name: string | string[], force?: boolean): this;
+    /**
+     * Get properties on an element.
+     *
+     * @param {string} name - Property name.
+     * @returns {any} - Property value if getting, otherwise `undefined`.
+     */
+    prop(name: string): any;
     /**
      * Removes the element from the DOM.
      * @returns {this}

package/dist/v1/libs/TinyHtml.mjs

@@ -6051,6 +6051,29 @@ class TinyHtml {
     toggleProp(name, force) {
         return TinyHtml.toggleProp(this, name, force);
     }
+    /**
+     * Get properties on an element.
+     *
+     * @param {TinyHtmlElement} el - Target element.
+     * @param {string} name - Property name.
+     * @returns {any} - Property value if getting, otherwise `undefined`.
+     */
+    static prop(el, name) {
+        if (typeof name !== 'string')
+            throw new TypeError('Invalid arguments passed to prop(). Expected string for "name".');
+        const elem = TinyHtml._preElem(el, 'attr');
+        // @ts-ignore
+        return elem[name];
+    }
+    /**
+     * Get properties on an element.
+     *
+     * @param {string} name - Property name.
+     * @returns {any} - Property value if getting, otherwise `undefined`.
+     */
+    prop(name) {
+        return TinyHtml.prop(this, name);
+    }
     /////////////////////////////////////////////////////
     // TITLE: Remove Element
     /**

package/docs/v1/libs/TinyHtml.md

@@ -2081,11 +2081,12 @@ Safe and type-checked — throws if misuse is detected.
 
 ---
 
-### 🧲 `.hasProp()` / `.addProp()` / `.removeProp()` / `.toggleProp()`
+### 🧲 `.hasProp()` / `.addProp()` / `.removeProp()` / `.toggleProp()` / `.prop()`
 
 Properties
 
 ```js
+element.prop('scrollHeight');           // get scrollHeight value
 element.hasProp("disabled");            // true/false
 element.addProp("checked");             // set true
 element.removeProp("checked");          // set false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.22.2",
+  "version": "1.22.3",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",