@creejs/commons-lang 2.1.14 → 2.1.16

package/dist/cjs/index-dev.cjs

@@ -1381,7 +1381,7 @@ function substringsBetween (str, startMarker, endMarker) {
  * 1. Executes a task silently, suppressing any errors or rejections.
  * 2. if loggerLike is provided, will log the error via it
  * @param {Function} task - The export function to execute.
- * @param {LoggerLike} loggerLike - The logger-like object to use for logging.
+ * @param {LoggerLike} [loggerLike] - The logger-like object to use for logging.
  * @returns {Promise<*>|*} The return value of the task, or a Promise if the task is asynchronous.
  */
 function quiet (task, loggerLike) {
@@ -1389,13 +1389,13 @@ function quiet (task, loggerLike) {
   try {
     const rtnVal = task();
     if (isPromise(rtnVal)) {
-      return rtnVal.catch(() => {
-        // do nothing
+      return rtnVal.catch((/** @type {any} */ err) => {
+        loggerLike && loggerLike.isErrorEnabled() && loggerLike.error('quiet() with async error:', err);
       })
     }
     return rtnVal
-  } catch (e) {
-    // do nothing
+  } catch (err) {
+    loggerLike && loggerLike.isErrorEnabled() && loggerLike.error('quiet() with sync error:', err);
   }
 }
 
@@ -1441,6 +1441,14 @@ var ExecUtils = {
  * }} Deferred
  */
 
+/**
+ * @typedef {{
+ *  promise: Promise<*>,
+ *  timerHandler: NodeJS.Timeout,
+ *  resolve: (...args:any[])=> void
+ * }} Waiter
+ */
+
 /**
  * @module PromiseUtils
  * @description Promise utility functions for enhanced promise handling, including timeout, delay, parallel execution, and series execution.
@@ -1454,7 +1462,8 @@ var PromiseUtils = {
   series,
   seriesAllSettled,
   parallel,
-  parallelAllSettled
+  parallelAllSettled,
+  wait
 };
 
 /**
@@ -1758,6 +1767,38 @@ async function parallelAllSettled (tasks, maxParallel = 5) {
   return rtnVal
 }
 
+/**
+ * Creates a "Waiter" Object
+ * 1. wait the specified time
+ * 2. can be wakeup immediately by calling resolve
+ * @param {number} waitTime - Timeout duration in milliseconds
+ * @returns {Waiter}
+ */
+function wait (waitTime) {
+  assertNotNegative(waitTime);
+  /** @type {Waiter} */
+  const rtnVal = {};
+
+  /**
+   * @type {NodeJS.Timeout}
+   */
+  let timerHandler;
+  rtnVal.timerHandler = timerHandler = setTimeout(() => {
+    clearTimeout(timerHandler); // must clear it
+    rtnVal.resolve();
+  }, waitTime);
+
+  rtnVal.promise = new Promise((resolve, reject) => {
+    rtnVal.resolve = (arg) => {
+      if (timerHandler != null) {
+        clearTimeout(timerHandler); // must clear it
+      }
+      resolve(arg);
+    };
+  });
+  return rtnVal
+}
+
 // owned
 
 // module vars