@creejs/commons-lang 2.1.15 → 2.1.16

package/dist/cjs/index-dev.cjs

@@ -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