@schukai/monster 3.98.3 → 3.99.0

package/source/dom/error.mjs

@@ -0,0 +1,106 @@
+/**
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
+ * Node module: @schukai/monster
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
+ */
+
+import {validateInstance, validateString} from "../types/validate.mjs";
+import {ATTRIBUTE_ERRORMESSAGE} from "./constants.mjs";
+
+
+export {addErrorAttribute, removeErrorAttribute};
+
+/**
+ * This method can be used to add an error message to an element.
+ *
+ * @license AGPLv3
+ * @since 3.99.0
+ * @copyright schukai GmbH
+ * @param {HTMLElement} element
+ * @param {string} message
+ * @return {HTMLElement}
+ */
+function addErrorAttribute(element, message) {
+    validateInstance(element, HTMLElement);
+
+    if(message instanceof Error) {
+        message = message.message;
+    }
+
+    if(typeof message !== "string") {
+        if(typeof message === "object" && message !== null) {
+            if(typeof message.toString === "function") {
+                message = message.toString();
+            } else {
+                message = JSON.stringify(message);
+            }
+        } else {
+            message = String(message);
+        }
+    }
+
+    validateString(message);
+
+    if (!element.hasAttribute(ATTRIBUTE_ERRORMESSAGE)) {
+        element.setAttribute(ATTRIBUTE_ERRORMESSAGE, message);
+        return element;
+    }
+
+    const current = element.getAttribute(ATTRIBUTE_ERRORMESSAGE);
+    const list = current.split("::");
+
+    for(let i = 0; i < list.length; i++) {
+        if(list[i] === message) {
+            return element;
+        }
+    }
+
+    list.push(message);
+
+    element.setAttribute(
+        ATTRIBUTE_ERRORMESSAGE,
+        list.join("::")
+    );
+
+    return element;
+}
+
+/**
+ * This method can be used to remove an error message from an element.
+ * @license AGPLv3
+ * @since 3.99.0
+ * @param element
+ * @param message
+ * @param {HTMLElement} element
+ * @param {string} message
+ * @return {HTMLElement}
+ */
+function removeErrorAttribute(element, message) {
+    validateInstance(element, HTMLElement);
+    validateString(message);
+
+    if (!element.hasAttribute(ATTRIBUTE_ERRORMESSAGE)) {
+        return element;
+    }
+
+    const current = element.getAttribute(ATTRIBUTE_ERRORMESSAGE);
+    const list = current.split("::");
+    const newList = list.filter(function (token) {
+        return token !== message;
+    });
+
+    element.setAttribute(
+        ATTRIBUTE_ERRORMESSAGE,
+        newList.join("::")
+    );
+
+    return element;
+}

package/source/types/version.mjs

@@ -156,7 +156,7 @@ function getMonsterVersion() {
 	}
 
 	/** don't touch, replaced by make with package.json version */
-	monsterVersion = new Version("3.98.1");
+	monsterVersion = new Version("3.98.3");
 
 	return monsterVersion;
 }

package/test/cases/dom/customcontrol.mjs

@@ -138,7 +138,7 @@ describe('DOM', function () {
 
                 expect(document.getElementsByTagName('monster-customcontrol').length).is.equal(1);
                 // no data-monster-objectlink="Symbol(monsterUpdater)" because it has nothing to update 
-                expect(document.getElementById('test1')).contain.html('<monster-customcontrol data-monster-error="Error: html is not set."></monster-customcontrol>')
+                expect(document.getElementById('test1')).contain.html('<monster-customcontrol data-monster-error="html is not set."></monster-customcontrol>')
             });
         });
 

package/test/cases/dom/customelement.mjs

@@ -242,7 +242,7 @@ describe('DOM', function () {
                 expect(document.getElementsByTagName('monster-testclass').length).is.equal(1);
                 // no data-monster-objectlink="Symbol(monsterUpdater)" because it has nothing to update
                 // but data-monster-error="Error: html is not set."
-                expect(document.getElementById('test1')).contain.html('<monster-testclass data-monster-error="Error: html is not set."></monster-testclass>');
+                expect(document.getElementById('test1')).contain.html('<monster-testclass data-monster-error="html is not set."></monster-testclass>');
             });
         });
 
@@ -402,7 +402,7 @@ describe('DOM', function () {
                 div.append(d);
 
 
-                expect(div).contain.html('data-monster-error="TypeError: value is not an instance of CSSStyleSheet"');
+                expect(div).contain.html('data-monster-error="value is not an instance of CSSStyleSheet"');
                 done();
 
             })
@@ -637,4 +637,4 @@ describe('DOM', function () {
         })
 
     });
-})
+})

package/test/cases/monster.mjs

@@ -7,7 +7,7 @@ describe('Monster', function () {
         let monsterVersion
 
         /** don´t touch, replaced by make with package.json version */
-        monsterVersion = new Version("3.98.1")
+        monsterVersion = new Version("3.98.3")
 
         let m = getMonsterVersion();
 

package/test/web/test.html

@@ -9,8 +9,8 @@
 </head>
 <body>
 <div id="headline" style="display: flex;align-items: center;justify-content: center;flex-direction: column;">
-  <h1 style='margin-bottom: 0.1em;'>Monster 3.98.1</h1>
-  <div id="lastupdate" style='font-size:0.7em'>last update Di 7. Jan 17:53:37 CET 2025</div>
+  <h1 style='margin-bottom: 0.1em;'>Monster 3.98.3</h1>
+  <div id="lastupdate" style='font-size:0.7em'>last update Di 7. Jan 22:59:33 CET 2025</div>
 </div>
 <div id="mocha-errors"
      style="color: red;font-weight: bold;display: flex;align-items: center;justify-content: center;flex-direction: column;margin:20px;"></div>