@creejs/commons-lang 2.1.25 → 2.1.27

package/dist/umd/index.dev.js

@@ -2047,11 +2047,15 @@
    * 2. Maybe multiple tasks are executed as a bulk block, and all of them resolved.
    *    * only the first fulfilled value is returned
    *    * other results are dropped
+   * 3. Notice:
+   *    * In Beginning, we start bulk(maxParallel) of tasks
+   *    * One task failed, it will start next task immediately, Not Wait for the bulk(maxParallel) to complete
    * @param {Array<Function|Promise<any>>} tasks - Array of async functions to execute
    * @param {number} [maxParallel=5] - Maximum number of tasks to run in parallel
+   * @param {string} [failureMessage] - Error message when all tasks failed
    * @returns {Promise<any>} Resolves with the result of the first successfully completed task
    */
-  async function parallelAny (tasks, maxParallel = 5) {
+  async function parallelAny (tasks, maxParallel = 5, failureMessage) {
     assertArray(tasks, 'tasks');
     assertNumber(maxParallel);
     if (tasks.length === 0) {
@@ -2084,28 +2088,29 @@
         // @ts-ignore
         taskPromise = returnValuePromised(task);
       } else {
-        errors.push(new TypeError(`Invalid task: ${task}`));
-        takeTaskAndRun();
-        return
+        taskPromise = Promise.reject(new TypeError(`Invalid task: ${typeof task}, Only Promise or Function allowed`));
       }
+
       taskPromise.then(/** @type {any} */ rtnVal => {
-        deferred.resolve(rtnVal);
+        runningTasksCount--; // DO Not put in finally
+        // any task resolved,  whole parallelAny resolved
+        deferred.resolve(rtnVal); // This may be called many times: In worst case, "maxParallel" times
       }).catch(e => {
         errors.push(e);
         // No task left, and No successful execution, reject with errors
         if (errors.length >= tasks.length) {
           if (deferred.pending) {
-            deferred.reject(new AggregatedError('All Tasks Failed', errors));
+            deferred.reject(new AggregatedError(failureMessage ?? 'All Tasks Failed', errors));
             return
           }
         }
-        takeTaskAndRun();
-      }).finally(() => {
-        runningTasksCount--;
+        runningTasksCount--; // DO Not put in finally, must reduce before takeTaskAndRun()
+        takeTaskAndRun(); // start next task
       });
     }
-    // start tasks until maxParallel
-    while (runningTasksCount < maxParallel) {
+    // start tasks until maxParallel or no more task
+    const parallelCount = Math.min(tasks.length, maxParallel);
+    for (let i = 0; i < parallelCount; i++) {
       takeTaskAndRun();
     }
     return deferred.promise
@@ -2533,6 +2538,7 @@
   var TimeUtils = {
     s2ns,
     ms2ns,
+    timestamp,
     timestamp64,
     lapseNano,
     lapseMillis,
@@ -2541,8 +2547,9 @@
   };
 
   /**
-   * Gets the current timestamp in nanoseconds (if running in Node.js) or milliseconds (in browser).
-   * Uses `process.hrtime.bigint()` for high-resolution timestamps in Node.js, falls back to `Date.now()` in browsers.
+   * Gets the current timestamp in nanoseconds
+   * * If "performance" API is available, uses performance timeOrigin + now()
+   * * Else fall back to `Date.now()` to get milliseconds and convert to nanoseconds
    * @returns {bigint} Current timestamp as a BigInt
    */
   function timestamp64 () {
@@ -2557,6 +2564,24 @@
     return BigInt(Date.now() * ms2ns)
   }
 
+  /**
+   * Gets the current timestamp in milliseconds
+   * * If "performance" API is available, uses performance timeOrigin + now(), then convert to milliseconds
+   * * Else fall back to `Date.now()`
+   * @returns {number} Current timestamp in milliseconds
+   */
+  function timestamp () {
+    // sinon can not fake performance.timeOrigin, so we have to check it
+    if (typeof performance !== 'undefined' && typeof performance.timeOrigin === 'number') {
+      // timeOrigin specifies the high resolution millisecond timestamp, eg. 1756350801931.159
+      const base = performance.timeOrigin;
+      // the current high resolution millisecond timestamp, eg.31767926.416357
+      const now = performance.now();
+      return Math.ceil((base + now) / ms2ns)
+    }
+    return Date.now()
+  }
+
   /**
    * Calculates the time elapsed in nanoseconds between the given timestamp and now.
    * @param {bigint} start - start timestamp64, in nanoseconds.