imp: Updated exceptions handling with new Web standards.

Author: Byloth

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byloth/core",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "An unopinionated collection of useful functions and classes that I use widely in all my projects. 🔧",
   "keywords": [
     "Core",
@@ -61,14 +61,14 @@
   },
   "devDependencies": {
     "@byloth/eslint-config-typescript": "^3.2.2",
-    "@eslint/compat": "^1.4.1",
-    "@types/node": "^22.19.0",
-    "@vitest/coverage-v8": "^4.0.8",
+    "@eslint/compat": "^2.0.0",
+    "@types/node": "^22.19.1",
+    "@vitest/coverage-v8": "^4.0.12",
     "eslint": "^9.39.1",
     "husky": "^9.1.7",
-    "jsdom": "^27.1.0",
+    "jsdom": "^27.2.0",
     "typescript": "^5.9.3",
-    "vite": "^7.2.2",
-    "vitest": "^4.0.8"
+    "vite": "^7.2.4",
+    "vitest": "^4.0.12"
   }
 }

pnpm-lock.yaml

@@ -1,4 +1,4 @@
-export const VERSION = "2.2.1";
+export const VERSION = "2.2.2";
 
 export type { Constructor, Interval, Timeout, ValueOf } from "./core/types.js";
 

src/index.ts

@@ -16,8 +16,7 @@
  *     // Uncaught Exception: The game saves may be corrupted. Try to restart the game.
  *     //     at /src/game/index.ts:37:15
  *     //     at /src/main.ts:23:17
- *     //
- *     // Caused by SyntaxError: Unexpected end of JSON input
+ *     // Caused by: SyntaxError: Unexpected end of JSON input
  *     //     at /src/models/saves.ts:47:17
  *     //     at /src/game/index.ts:12:9
  *     //     at /src/main.ts:23:17
@@ -59,6 +58,7 @@ export default class Exception extends Error
             const exc = new Exception(error.message);
 
             exc.stack = error.stack;
+            exc.cause = error.cause;
             exc.name = error.name;
 
             return exc;
@@ -89,18 +89,6 @@ export default class Exception extends Error
 
         this.cause = cause;
         this.name = name;
-
-        if (cause)
-        {
-            if (cause instanceof Error)
-            {
-                this.stack += `\n\nCaused by ${cause.stack}`;
-            }
-            else
-            {
-                this.stack += `\n\nCaused by ${cause}`;
-            }
-        }
     }
 
     public readonly [Symbol.toStringTag]: string = "Exception";

src/models/exceptions/core.ts

@@ -1066,7 +1066,7 @@ export default class SmartAsyncIterator<T, R = void, N = undefined> implements A
      * {
      *     try
      *     {
-     *         if (value > 5) { throw new Error("The index is too high."); }
+     *         if (value > 5) { throw new Exception("The index is too high."); }
      *
      *         console.log(value); // 1, 2, 3, 4, 5
      *     }

src/models/iterators/smart-async-iterator.ts

@@ -939,7 +939,7 @@ export default class SmartIterator<T, R = void, N = undefined> implements Iterat
      * {
      *     try
      *     {
-     *         if (value > 5) { throw new Error("The index is too high."); }
+     *         if (value > 5) { throw new Exception("The index is too high."); }
      *
      *         console.log(value); // 1, 2, 3, 4, 5
      *     }

src/models/iterators/smart-iterator.ts

@@ -261,10 +261,10 @@ export default class SmartPromise<T = void> implements Promise<T>
      * ```ts
      * const promise = new SmartPromise((resolve, reject) =>
      * {
-     *     setTimeout(() => reject(new Error("An unknown error occurred.")), 1_000);
+     *     setTimeout(() => reject(new Exception("An unknown error occurred.")), 1_000);
      * });
      *
-     * promise.catch(); // Uncaught Error: An unknown error occurred.
+     * promise.catch(); // "Uncaught Exception: An unknown error occurred."
      * ```
      *
      * ---
@@ -288,10 +288,10 @@ export default class SmartPromise<T = void> implements Promise<T>
      * ```ts
      * const promise = new SmartPromise((resolve, reject) =>
      * {
-     *     setTimeout(() => reject(new Error("An unknown error occurred.")), 1_000);
+     *     setTimeout(() => reject(new Exception("An unknown error occurred.")), 1_000);
      * });
      *
-     * promise.catch((reason) => console.error(reason)); // "Error: An unknown error occurred."
+     * promise.catch((reason) => console.error(reason)); // "Uncaught Exception: An unknown error occurred."
      * ```
      *
      * ---

src/models/promises/smart-promise.ts

@@ -21,7 +21,7 @@ import type { MaybePromise, PromiseExecutor } from "./types.js";
  *
  * promise
  *     .then((result) => console.log(result))  // "Hello, World!"
- *     .catch((error) => console.error(error)); // TimeoutException: The operation has timed out.
+ *     .catch((error) => console.error(error)); // "Uncaught TimeoutException: The operation has timed out."
  * ```
  *
  * ---