utiller 1.0.379 → 1.0.381

package/lib/pooller/index.js

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
@@ -28,7 +27,7 @@ function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.h
  Pooller 有以下特點:
  1.task可以設定timeout
  2.queue滿了的可以設定task interval
- 3.如果是runByEachTask length, queue裡面沒有task時，可以設定sleeptime, 以及Sleepcounts
+ 3.如果是runByEachTask length, queue裡面沒有task時,可以設定sleeptime, 以及Sleepcounts
  4.task 可以cancelled by hash
  5.runByParams,runByTimes,runInInfinite,runByEachTask
  6.可以設定taskFailHandler, 這樣遇到錯誤就不會停掉poollers
@@ -84,27 +83,31 @@ var InfinitePool = /*#__PURE__*/function () {
       return _this.nameOfCurrentPool;
     });
     /** return true if task completed, after 15 secs, force leave
-     *  TODO:應該要設計成當terminate後, 監聽executingTaskInQueue為零時,回傳結束 */
+     * TODO:應該要設計成當terminate後, 監聽executingTaskInQueue為零時,回傳結束 */
     (0, _defineProperty2["default"])(this, "stopInBackground", /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee() {
+      var attempts, maxAttempts;
       return _regenerator["default"].wrap(function _callee$(_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             _this.terminate();
-          case 1:
-            if (!(_lodash["default"].size(_this.queueOfExecutingTask) > 0)) {
-              _context.next = 8;
+            attempts = 0;
+            maxAttempts = 30; // 30 * 500ms = 15 seconds wait
+          case 3:
+            if (!(_lodash["default"].size(_this.queueOfExecutingTask) > 0 && attempts < maxAttempts)) {
+              _context.next = 11;
               break;
             }
-            _context.next = 4;
+            _context.next = 6;
             return _index2.utiller.syncDelay(500);
-          case 4:
+          case 6:
             _this.printLogMessage("784512, \u54AC\u5728 stopInBackground \u51FA\u4E0D\u4F86,".concat(_this.getLogMessageOfExecutingTaskQueueCount()));
             _this.showState();
-            _context.next = 1;
+            attempts++;
+            _context.next = 3;
             break;
-          case 8:
+          case 11:
             return _context.abrupt("return", true);
-          case 9:
+          case 12:
           case "end":
             return _context.stop();
         }
@@ -461,26 +464,34 @@ var InfinitePool = /*#__PURE__*/function () {
             case 0:
               _context6.prev = 0;
               _context6.next = 3;
-              return asyncfunc.apply(void 0, params);
+              return asyncfunc.apply(_this, params);
             case 3:
-              _context6.next = 8;
+              _context6.next = 12;
               break;
             case 5:
               _context6.prev = 5;
               _context6.t0 = _context6["catch"](0);
+              if (!(_context6.t0 instanceof _exceptioner["default"])) {
+                _context6.next = 11;
+                break;
+              }
+              _this.printLogMessage("7812123, runInBackGround() \u57F7\u884C\u932F\u8AA4: ".concat(_context6.t0.message), true, _context6.t0);
+              _context6.next = 12;
+              break;
+            case 11:
               throw new _exceptioner["default"](4009, {
                 message: "".concat(_this.getPoollerLogFormat(""))
               }, _context6.t0);
-            case 8:
-              _context6.prev = 8;
+            case 12:
+              _context6.prev = 12;
               _this.terminate();
               _this.printLogMessage("7812123, runInBackGround() \u8D70\u5230finally");
-              return _context6.finish(8);
-            case 12:
+              return _context6.finish(12);
+            case 16:
             case "end":
               return _context6.stop();
           }
-        }, _callee6, null, [[0, 5, 8, 12]]);
+        }, _callee6, null, [[0, 5, 12, 16]]);
       })), 1);
     });
     (0, _defineProperty2["default"])(this, "getPoollerLogFormat", function (msg) {
@@ -500,9 +511,9 @@ var InfinitePool = /*#__PURE__*/function () {
         case _configerer.configerer.POOLLER_STATE.RUN_BY_PARAMS:
           return _this.isRunning() && !_this.isExecutingQueueFull() && _lodash["default"].size(_this.queueOfWaitingParam) > 0;
         case _configerer.configerer.POOLLER_STATE.RUN_BY_TIMES:
-          return _this.isRunning() && !_this.isExecutingQueueFull() && _this.countsOfRunByTimes > 0;
         case _configerer.configerer.POOLLER_STATE.RUN_INFINITE:
-          return _this.isRunning() && !_this.isExecutingQueueFull();
+          // 這三種模式的任務數在 AssignTaskQueue 中只有一個或一組
+          return _this.isRunning() && !_this.isExecutingQueueFull() && _this.getCountOfAssignTaskInQueue() > 0;
         default:
           throw new _exceptioner["default"](4005, "this.state ==> ".concat(_this.state));
       }
@@ -637,6 +648,16 @@ var InfinitePool = /*#__PURE__*/function () {
         }
       }, _callee9);
     })));
+    /** [新增] 輔助方法：獲取用於重複執行模式的任務資訊（複製任務並賦予新 hash） */
+    (0, _defineProperty2["default"])(this, "getTaskInfoForRepetitiveRun", function (originalTaskInfo) {
+      // 必須複製任務函數並給予一個新的 hash，用於在 executingTaskQueue 中追蹤
+      var newTaskInfo = {
+        task: originalTaskInfo.task,
+        hash: _index2.utiller.getRandomHash()
+      };
+      _this.appendHashTaskMap(newTaskInfo); // 追蹤這個新的 hash 直到任務開始執行
+      return newTaskInfo;
+    });
     /** taskInfo = { task, hash }*/
     (0, _defineProperty2["default"])(this, "getTaskInfoDependOnPriority", function () {
       var _iterator3 = _createForOfIteratorHelper(_configerer.configerer.POOLLER_PRIORITY),
@@ -647,13 +668,17 @@ var InfinitePool = /*#__PURE__*/function () {
           if (_this.queueOfAssignTask[prior].length > 0) {
             switch (_this.state) {
               case _configerer.configerer.POOLLER_STATE.RUN_BY_EACH_TASK:
+                // [修正] RUN_BY_EACH_TASK: 移除任務
                 return _this.queueOfAssignTask[prior].shift();
               case _configerer.configerer.POOLLER_STATE.RUN_BY_PARAMS:
               case _configerer.configerer.POOLLER_STATE.RUN_BY_TIMES:
               case _configerer.configerer.POOLLER_STATE.RUN_INFINITE:
-                var taskInfo = _this.queueOfAssignTask[prior].shift();
-                _this.add(taskInfo.task);
-                return taskInfo;
+                // [重大 Bug 修正] 針對重複執行模式：
+                // 1. 不使用 shift() 移除任務 (因為需要重複執行)
+                // 2. 獲取任務函數的引用 (Peek)
+                // 3. 複製任務函數並賦予新的 Hash 以便追蹤本次執行
+                var originalTaskInfo = _this.queueOfAssignTask[prior][0];
+                return _this.getTaskInfoForRepetitiveRun(originalTaskInfo);
               default:
                 throw new _exceptioner["default"](4005, "this.state ==> ".concat(_this.state));
             }
@@ -894,9 +919,11 @@ var InfinitePool = /*#__PURE__*/function () {
     function setState(_state) {
       this.state = _state;
     }
+
+    /** [優化] 重新命名以明確說明它具有副作用 (Side Effect) */
   }, {
-    key: "isFirstTaskCompleted",
-    value: function isFirstTaskCompleted() {
+    key: "checkAndMarkInitialTaskStatus",
+    value: function checkAndMarkInitialTaskStatus() {
       if (!this.initialTaskCompleted) {
         this.initialTaskCompleted = true;
         return false;
@@ -950,11 +977,13 @@ var InfinitePool = /*#__PURE__*/function () {
           while (1) switch (_context11.prev = _context11.next) {
             case 0:
               this.printLogMessage("448984466, \u8D70\u9032\u4F86\u4E86 syncTaskDispatcher()");
-              initialTaskShouldNotRun = this.disableFirstRun && !this.isFirstTaskCompleted();
+
+              // [修正/優化] 使用新的方法名稱，並將檢查和標記分開處理
+              initialTaskShouldNotRun = this.disableFirstRun && !this.checkAndMarkInitialTaskStatus();
               isExecutingTaskAlmostFull = this.queueOfExecutingTask.length >= this.maximumOfWorker - 1;
               /** 因為走能到syncTaskDispatcher表示其中一個工作完成了, 這個瞬間不可能 === maximumOfWorker,
-               *  所以必須減1, 除非這個syncTaskDispatcher是單獨一個線程 */
-              comparison = this.isFirstTaskCompleted() && isExecutingTaskAlmostFull && this.enableOfTaskSleepByInterval;
+               * 所以必須減1, 除非這個syncTaskDispatcher是單獨一個線程 */
+              comparison = this.checkAndMarkInitialTaskStatus() && isExecutingTaskAlmostFull && this.enableOfTaskSleepByInterval;
               if (!(initialTaskShouldNotRun || comparison)) {
                 _context11.next = 9;
                 break;
@@ -974,8 +1003,13 @@ var InfinitePool = /*#__PURE__*/function () {
                 _context11.next = 17;
                 break;
               }
-              promise = this.taskWrapper(taskInfo.task, taskInfo.hash, this.queueOfWaitingParam.shift());
-              this.removeTaskMapByHash(taskInfo.hash);
+              promise = this.taskWrapper(taskInfo.task, taskInfo.hash, this.queueOfWaitingParam.shift()); // 如果是重複執行的 Task，就不移除 TaskMap，因為它只追蹤任務函數的參考，並在下次執行時產生新的 Hash
+              if (this.state === _configerer.configerer.POOLLER_STATE.RUN_BY_EACH_TASK) {
+                this.removeTaskMapByHash(taskInfo.hash);
+              } else {
+                // 對於重複執行的任務，只需移除本次執行時生成的臨時 Hash
+                // 由於 getTaskInfoDependOnPriority 現在會產生新的 hash，這裡不需要額外處理
+              }
               this.appendTaskToExecuteQueue(taskInfo.hash, promise);
               _context11.next = 19;
               break;
@@ -1005,805 +1039,6 @@ var InfinitePool = /*#__PURE__*/function () {
     function isWait4ResultTask(hash) {
       return this.mapOfHashNCallbackWrapper[hash] !== undefined;
     }
-  }, {
-    key: "exampleOfRunByTaskWait4ResultAndRunInBackground",
-    value: (
-    /** following function are examples **/
-    /** following function are examples **/
-    /** following function are examples **/
-    /** following function are examples **/
-    function () {
-      var _exampleOfRunByTaskWait4ResultAndRunInBackground = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee14() {
-        var pool, asyncTask, startTimoutTask;
-        return _regenerator["default"].wrap(function _callee14$(_context14) {
-          while (1) switch (_context14.prev = _context14.next) {
-            case 0:
-              startTimoutTask = function _startTimoutTask(delayTime, taskSpendTime, sign) {
-                var priority = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : "low";
-                setTimeout( /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee13() {
-                  var printSign;
-                  return _regenerator["default"].wrap(function _callee13$(_context13) {
-                    while (1) switch (_context13.prev = _context13.next) {
-                      case 0:
-                        _context13.prev = 0;
-                        _context13.next = 3;
-                        return pool.addTaskAndWait4Result(asyncTask(sign, taskSpendTime), priority);
-                      case 3:
-                        printSign = _context13.sent;
-                        _index2.utiller.appendInfo("answer => ", printSign);
-                        _context13.next = 10;
-                        break;
-                      case 7:
-                        _context13.prev = 7;
-                        _context13.t0 = _context13["catch"](0);
-                        _index2.utiller.appendError("sign ".concat(sign, " perform fail"), _context13.t0.message);
-                      case 10:
-                      case "end":
-                        return _context13.stop();
-                    }
-                  }, _callee13, null, [[0, 7]]);
-                })), delayTime);
-              };
-              asyncTask = function _asyncTask(sign) {
-                var taskSpend = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2000;
-                return /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee12() {
-                  return _regenerator["default"].wrap(function _callee12$(_context12) {
-                    while (1) switch (_context12.prev = _context12.next) {
-                      case 0:
-                        _context12.next = 2;
-                        return _index2.utiller.syncDelay(taskSpend);
-                      case 2:
-                        return _context12.abrupt("return", sign);
-                      case 3:
-                      case "end":
-                        return _context12.stop();
-                    }
-                  }, _callee12);
-                }));
-              };
-              pool = new InfinitePool(1, "david").runByEachTaskInBackGround();
-              pool.enableTaskTimeout(true, 3000);
-              startTimoutTask(0, 1000, "A", "low");
-              startTimoutTask(1000, 1000, "C", "low");
-              startTimoutTask(1000, 1000, "G", "high");
-              startTimoutTask(500, 4000, "B", "low");
-              startTimoutTask(3000, 1000, "D", "medium");
-              startTimoutTask(10000, 2000, "E", "medium");
-            case 10:
-              if (!pool.isRunning()) {
-                _context14.next = 17;
-                break;
-              }
-              console.log("system is running");
-              pool.showState();
-              _context14.next = 15;
-              return _index2.utiller.syncDelay(1000);
-            case 15:
-              _context14.next = 10;
-              break;
-            case 17:
-            case "end":
-              return _context14.stop();
-          }
-        }, _callee14);
-      }));
-      function exampleOfRunByTaskWait4ResultAndRunInBackground() {
-        return _exampleOfRunByTaskWait4ResultAndRunInBackground.apply(this, arguments);
-      }
-      return exampleOfRunByTaskWait4ResultAndRunInBackground;
-    }())
-  }, {
-    key: "exampleOfRunInBackgroundInfinite",
-    value: function () {
-      var _exampleOfRunInBackgroundInfinite = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee17() {
-        var myAsyncTask, _myAsyncTask, pool;
-        return _regenerator["default"].wrap(function _callee17$(_context17) {
-          while (1) switch (_context17.prev = _context17.next) {
-            case 0:
-              _myAsyncTask = function _myAsyncTask3() {
-                _myAsyncTask = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee16() {
-                  var taskSpend, sign;
-                  return _regenerator["default"].wrap(function _callee16$(_context16) {
-                    while (1) switch (_context16.prev = _context16.next) {
-                      case 0:
-                        taskSpend = _index2.utiller.getRandomValue(1000, 1000);
-                        sign = _index2.utiller.getRandomHash(15);
-                        if (!_index2.utiller.isOdd(taskSpend)) {
-                          _context16.next = 4;
-                          break;
-                        }
-                        throw new Error("45100 Oops, ".concat(taskSpend, " is odd\u5566"));
-                      case 4:
-                        _context16.next = 6;
-                        return _index2.utiller.syncDelay(taskSpend);
-                      case 6:
-                        _index2.utiller.appendInfo(sign, taskSpend);
-                        return _context16.abrupt("return", sign);
-                      case 8:
-                      case "end":
-                        return _context16.stop();
-                    }
-                  }, _callee16);
-                }));
-                return _myAsyncTask.apply(this, arguments);
-              };
-              myAsyncTask = function _myAsyncTask2() {
-                return _myAsyncTask.apply(this, arguments);
-              };
-              pool = new InfinitePool(2);
-              pool.runInfiniteInBackground(myAsyncTask, 5000);
-              pool.setDisableFirstRun(true);
-              pool.setTaskFailHandler(function (error) {
-                console.error(error.message);
-              });
-              setTimeout( /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee15() {
-                return _regenerator["default"].wrap(function _callee15$(_context15) {
-                  while (1) switch (_context15.prev = _context15.next) {
-                    case 0:
-                      _context15.next = 2;
-                      return pool.stopInBackground();
-                    case 2:
-                    case "end":
-                      return _context15.stop();
-                  }
-                }, _callee15);
-              })), 100000);
-            case 7:
-              if (!pool.isRunning()) {
-                _context17.next = 14;
-                break;
-              }
-              _index2.utiller.appendInfo("system is running");
-              _context17.next = 11;
-              return _index2.utiller.syncDelay(3000);
-            case 11:
-              pool.showState();
-              _context17.next = 7;
-              break;
-            case 14:
-            case "end":
-              return _context17.stop();
-          }
-        }, _callee17);
-      }));
-      function exampleOfRunInBackgroundInfinite() {
-        return _exampleOfRunInBackgroundInfinite.apply(this, arguments);
-      }
-      return exampleOfRunInBackgroundInfinite;
-    }()
-  }, {
-    key: "exampleOfRunInfinite",
-    value: function () {
-      var _exampleOfRunInfinite = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee19() {
-        return _regenerator["default"].wrap(function _callee19$(_context19) {
-          while (1) switch (_context19.prev = _context19.next) {
-            case 0:
-              _context19.next = 2;
-              return new InfinitePool(3).runInInfinite( /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee18() {
-                return _regenerator["default"].wrap(function _callee18$(_context18) {
-                  while (1) switch (_context18.prev = _context18.next) {
-                    case 0:
-                      console.log("1000");
-                    case 1:
-                    case "end":
-                      return _context18.stop();
-                  }
-                }, _callee18);
-              })), 1000);
-            case 2:
-            case "end":
-              return _context19.stop();
-          }
-        }, _callee19);
-      }));
-      function exampleOfRunInfinite() {
-        return _exampleOfRunInfinite.apply(this, arguments);
-      }
-      return exampleOfRunInfinite;
-    }()
-  }, {
-    key: "exampleOfRunByParamInBackground",
-    value: function () {
-      var _exampleOfRunByParamInBackground = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee21() {
-        var pool;
-        return _regenerator["default"].wrap(function _callee21$(_context21) {
-          while (1) switch (_context21.prev = _context21.next) {
-            case 0:
-              pool = new InfinitePool(0);
-              pool.runByParamInBackGround( /*#__PURE__*/function () {
-                var _ref12 = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee20(param) {
-                  var ms;
-                  return _regenerator["default"].wrap(function _callee20$(_context20) {
-                    while (1) switch (_context20.prev = _context20.next) {
-                      case 0:
-                        _context20.next = 2;
-                        return _index2.utiller.syncDelayRandom();
-                      case 2:
-                        ms = _context20.sent;
-                        console.log("wait ".concat(ms, " ms"), "param", param);
-                      case 4:
-                      case "end":
-                        return _context20.stop();
-                    }
-                  }, _callee20);
-                }));
-                return function (_x4) {
-                  return _ref12.apply(this, arguments);
-                };
-              }(), "david", "susan", "golden", "weber", "kevin");
-              setTimeout(function () {
-                pool.appendParamInToQueue("apple", "Rui", "Rui", "Qui", "Seiu", "Bikky", "apple", "Rui", "Rui", "Qui", "Seiu", "Bikky");
-              }, 12000);
-              setTimeout(function () {
-                pool.setWorker(5);
-              }, 6000);
-            case 4:
-              if (!true) {
-                _context21.next = 10;
-                break;
-              }
-              _index2.utiller.appendInfo("system is running after 2 seconds");
-              _context21.next = 8;
-              return _index2.utiller.syncDelay(2000);
-            case 8:
-              _context21.next = 4;
-              break;
-            case 10:
-            case "end":
-              return _context21.stop();
-          }
-        }, _callee21);
-      }));
-      function exampleOfRunByParamInBackground() {
-        return _exampleOfRunByParamInBackground.apply(this, arguments);
-      }
-      return exampleOfRunByParamInBackground;
-    }()
-  }, {
-    key: "exampleOfRunByTimesInBackground",
-    value: function () {
-      var _exampleOfRunByTimesInBackground = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee23() {
-        var pool, count;
-        return _regenerator["default"].wrap(function _callee23$(_context23) {
-          while (1) switch (_context23.prev = _context23.next) {
-            case 0:
-              pool = new InfinitePool(0);
-              count = 0;
-              pool.runByTimesInBackGround( /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee22() {
-                var ms;
-                return _regenerator["default"].wrap(function _callee22$(_context22) {
-                  while (1) switch (_context22.prev = _context22.next) {
-                    case 0:
-                      _context22.next = 2;
-                      return _index2.utiller.syncDelayRandom();
-                    case 2:
-                      ms = _context22.sent;
-                      count++;
-                      console.log("wait for time: ".concat(ms, " ms, count:").concat(count));
-                    case 5:
-                    case "end":
-                      return _context22.stop();
-                  }
-                }, _callee22);
-              })), 50);
-              setTimeout(function () {
-                pool.setWorker(3);
-              }, 10000);
-            case 4:
-              if (!true) {
-                _context23.next = 10;
-                break;
-              }
-              _index2.utiller.appendInfo("system is running after 2.5 seconds");
-              _context23.next = 8;
-              return _index2.utiller.syncDelay(2500);
-            case 8:
-              _context23.next = 4;
-              break;
-            case 10:
-            case "end":
-              return _context23.stop();
-          }
-        }, _callee23);
-      }));
-      function exampleOfRunByTimesInBackground() {
-        return _exampleOfRunByTimesInBackground.apply(this, arguments);
-      }
-      return exampleOfRunByTimesInBackground;
-    }()
-  }, {
-    key: "exampleOfRunByParam",
-    value: function () {
-      var _exampleOfRunByParam = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee25() {
-        var oneToTen, pool;
-        return _regenerator["default"].wrap(function _callee25$(_context25) {
-          while (1) switch (_context25.prev = _context25.next) {
-            case 0:
-              oneToTen = _lodash["default"].range(1, 10);
-              pool = new InfinitePool(5);
-              _index2.utiller.appendInfo("....start method of runByParams");
-              _context25.next = 5;
-              return pool.runByParams.apply(pool, [( /*#__PURE__*/function () {
-                var _ref14 = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee24(param) {
-                  var ms;
-                  return _regenerator["default"].wrap(function _callee24$(_context24) {
-                    while (1) switch (_context24.prev = _context24.next) {
-                      case 0:
-                        _context24.next = 2;
-                        return _index2.utiller.syncDelayRandom();
-                      case 2:
-                        ms = _context24.sent;
-                        console.log(param, "".concat(ms, " ms"));
-                      case 4:
-                      case "end":
-                        return _context24.stop();
-                    }
-                  }, _callee24);
-                }));
-                return function (_x5) {
-                  return _ref14.apply(this, arguments);
-                };
-              }())].concat((0, _toConsumableArray2["default"])(oneToTen)));
-            case 5:
-              _index2.utiller.appendInfo("....finish method of runByParams");
-            case 6:
-            case "end":
-              return _context25.stop();
-          }
-        }, _callee25);
-      }));
-      function exampleOfRunByParam() {
-        return _exampleOfRunByParam.apply(this, arguments);
-      }
-      return exampleOfRunByParam;
-    }()
-  }, {
-    key: "exampleOfRunByTask",
-    value: function () {
-      var _exampleOfRunByTask = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee26() {
-        var pool, tasks, all;
-        return _regenerator["default"].wrap(function _callee26$(_context26) {
-          while (1) switch (_context26.prev = _context26.next) {
-            case 0:
-              pool = new InfinitePool(1);
-              tasks = _lodash["default"].range(1, 5).map(function (each) {
-                return _index2.utiller.asyncUnitTaskFunction(each * 1000);
-              });
-              _index2.utiller.appendInfo("....start method of exampleOfRunByTask");
-              _context26.next = 5;
-              return pool.runByEachTask(tasks);
-            case 5:
-              all = _context26.sent;
-              _index2.utiller.appendInfo(all);
-              _index2.utiller.appendInfo("....finish method of exampleOfRunByTask");
-            case 8:
-            case "end":
-              return _context26.stop();
-          }
-        }, _callee26);
-      }));
-      function exampleOfRunByTask() {
-        return _exampleOfRunByTask.apply(this, arguments);
-      }
-      return exampleOfRunByTask;
-    }()
-  }, {
-    key: "exampleOfRunByTimes",
-    value: function () {
-      var _exampleOfRunByTimes = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee28() {
-        var pool, time;
-        return _regenerator["default"].wrap(function _callee28$(_context28) {
-          while (1) switch (_context28.prev = _context28.next) {
-            case 0:
-              pool = new InfinitePool(5);
-              time = 0;
-              _index2.utiller.appendInfo("....start method of runByTimes");
-              _context28.next = 5;
-              return pool.runByTimes( /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee27() {
-                return _regenerator["default"].wrap(function _callee27$(_context27) {
-                  while (1) switch (_context27.prev = _context27.next) {
-                    case 0:
-                      _context27.next = 2;
-                      return _index2.utiller.syncDelay(1000);
-                    case 2:
-                      time++;
-                      console.log("execute the ".concat(time, " time"));
-                    case 4:
-                    case "end":
-                      return _context27.stop();
-                  }
-                }, _callee27);
-              })), 10);
-            case 5:
-              _index2.utiller.appendInfo("....finish method of runByTimes");
-            case 6:
-            case "end":
-              return _context28.stop();
-          }
-        }, _callee28);
-      }));
-      function exampleOfRunByTimes() {
-        return _exampleOfRunByTimes.apply(this, arguments);
-      }
-      return exampleOfRunByTimes;
-    }()
-  }, {
-    key: "exampleOfAsyncTaskOfFunctionInside",
-    value: function () {
-      var _exampleOfAsyncTaskOfFunctionInside = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee35() {
-        var result;
-        return _regenerator["default"].wrap(function _callee35$(_context35) {
-          while (1) switch (_context35.prev = _context35.next) {
-            case 0:
-              result = [];
-              _context35.next = 3;
-              return new InfinitePool(2).runByEachTask([/*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee29() {
-                var item;
-                return _regenerator["default"].wrap(function _callee29$(_context29) {
-                  while (1) switch (_context29.prev = _context29.next) {
-                    case 0:
-                      item = _index2.utiller.asyncUnitTaskFunction(1000);
-                      _context29.t0 = result;
-                      _context29.next = 4;
-                      return item();
-                    case 4:
-                      _context29.t1 = _context29.sent;
-                      _context29.t0.push.call(_context29.t0, _context29.t1);
-                    case 6:
-                    case "end":
-                      return _context29.stop();
-                  }
-                }, _callee29);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee30() {
-                var item;
-                return _regenerator["default"].wrap(function _callee30$(_context30) {
-                  while (1) switch (_context30.prev = _context30.next) {
-                    case 0:
-                      _context30.next = 2;
-                      return _index2.utiller.asyncUnitTaskFunction(3000);
-                    case 2:
-                      item = _context30.sent;
-                      _context30.t0 = result;
-                      _context30.next = 6;
-                      return item();
-                    case 6:
-                      _context30.t1 = _context30.sent;
-                      _context30.t0.push.call(_context30.t0, _context30.t1);
-                    case 8:
-                    case "end":
-                      return _context30.stop();
-                  }
-                }, _callee30);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee31() {
-                var item;
-                return _regenerator["default"].wrap(function _callee31$(_context31) {
-                  while (1) switch (_context31.prev = _context31.next) {
-                    case 0:
-                      _context31.next = 2;
-                      return _index2.utiller.asyncUnitTaskFunction(4000);
-                    case 2:
-                      item = _context31.sent;
-                      _context31.t0 = result;
-                      _context31.next = 6;
-                      return item();
-                    case 6:
-                      _context31.t1 = _context31.sent;
-                      _context31.t0.push.call(_context31.t0, _context31.t1);
-                    case 8:
-                    case "end":
-                      return _context31.stop();
-                  }
-                }, _callee31);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee32() {
-                var item;
-                return _regenerator["default"].wrap(function _callee32$(_context32) {
-                  while (1) switch (_context32.prev = _context32.next) {
-                    case 0:
-                      _context32.next = 2;
-                      return _index2.utiller.asyncUnitTaskFunction(9000);
-                    case 2:
-                      item = _context32.sent;
-                      _context32.t0 = result;
-                      _context32.next = 6;
-                      return item();
-                    case 6:
-                      _context32.t1 = _context32.sent;
-                      _context32.t0.push.call(_context32.t0, _context32.t1);
-                    case 8:
-                    case "end":
-                      return _context32.stop();
-                  }
-                }, _callee32);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee33() {
-                var item;
-                return _regenerator["default"].wrap(function _callee33$(_context33) {
-                  while (1) switch (_context33.prev = _context33.next) {
-                    case 0:
-                      _context33.next = 2;
-                      return _index2.utiller.asyncUnitTaskFunction(6000);
-                    case 2:
-                      item = _context33.sent;
-                      _context33.t0 = result;
-                      _context33.next = 6;
-                      return item();
-                    case 6:
-                      _context33.t1 = _context33.sent;
-                      _context33.t0.push.call(_context33.t0, _context33.t1);
-                    case 8:
-                    case "end":
-                      return _context33.stop();
-                  }
-                }, _callee33);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee34() {
-                var item;
-                return _regenerator["default"].wrap(function _callee34$(_context34) {
-                  while (1) switch (_context34.prev = _context34.next) {
-                    case 0:
-                      _context34.next = 2;
-                      return _index2.utiller.asyncUnitTaskFunction(6000);
-                    case 2:
-                      item = _context34.sent;
-                      _context34.t0 = result;
-                      _context34.next = 6;
-                      return item();
-                    case 6:
-                      _context34.t1 = _context34.sent;
-                      _context34.t0.push.call(_context34.t0, _context34.t1);
-                    case 8:
-                    case "end":
-                      return _context34.stop();
-                  }
-                }, _callee34);
-              }))]);
-            case 3:
-              _index2.utiller.appendInfo(result);
-            case 4:
-            case "end":
-              return _context35.stop();
-          }
-        }, _callee35);
-      }));
-      function exampleOfAsyncTaskOfFunctionInside() {
-        return _exampleOfAsyncTaskOfFunctionInside.apply(this, arguments);
-      }
-      return exampleOfAsyncTaskOfFunctionInside;
-    }()
-  }, {
-    key: "exampleOfInfiniteUnStopLoopingIssue",
-    value: function () {
-      var _exampleOfInfiniteUnStopLoopingIssue = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee37() {
-        var persistTone, _persistTone, poollers, pool, isRequiredTerminate, random, _iterator6, _step6, pooller;
-        return _regenerator["default"].wrap(function _callee37$(_context37) {
-          while (1) switch (_context37.prev = _context37.next) {
-            case 0:
-              _persistTone = function _persistTone3() {
-                _persistTone = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee36() {
-                  var sign, time;
-                  return _regenerator["default"].wrap(function _callee36$(_context36) {
-                    while (1) switch (_context36.prev = _context36.next) {
-                      case 0:
-                        _context36.prev = 0;
-                        sign = _index2.utiller.getRandomHash(20);
-                        _context36.next = 4;
-                        return _index2.utiller.syncDelayRandom(1, 10);
-                      case 4:
-                        time = _context36.sent;
-                        _index2.utiller.appendInfo("".concat(time, " ms, yoyoyo ").concat(sign));
-                        // Util.appendInfo(`沒有TONE可以下載了....隨機睡個${await Util.syncDelayRandom(1500, 3500)}`)
-                        return _context36.abrupt("return", "\u4EFB\u52D9ID:".concat(sign));
-                      case 9:
-                        _context36.prev = 9;
-                        _context36.t0 = _context36["catch"](0);
-                        _index2.utiller.appendError(_context36.t0.message);
-                      case 12:
-                      case "end":
-                        return _context36.stop();
-                    }
-                  }, _callee36, null, [[0, 9]]);
-                }));
-                return _persistTone.apply(this, arguments);
-              };
-              persistTone = function _persistTone2() {
-                return _persistTone.apply(this, arguments);
-              };
-              poollers = [];
-              pool = new InfinitePool(3);
-              pool.setPoolId("tone fetch");
-              pool.setDisableFirstRun(true);
-              pool.runInfiniteInBackground(persistTone, 5000);
-              pool.setTaskFailHandler(function (error) {
-                return _index2.utiller.appendError("5165 error ".concat(error.message));
-              });
-              poollers.push(pool);
-              isRequiredTerminate = false;
-              setTimeout(function () {
-                isRequiredTerminate = true;
-              }, 20000);
-            case 11:
-              if (!true) {
-                _context37.next = 43;
-                break;
-              }
-              _index2.utiller.exeAll(poollers, function (each) {
-                return each.showState();
-              });
-              _context37.next = 15;
-              return _index2.utiller.syncDelayRandom();
-            case 15:
-              random = _context37.sent;
-              _context37.next = 18;
-              return _index2.utiller.syncDelay(random);
-            case 18:
-              if (!isRequiredTerminate) {
-                _context37.next = 41;
-                break;
-              }
-              _index2.utiller.appendInfo("\u4E3B\u7DDA\u7A0B\u6536\u5230\u95DC\u9589\u6307\u4EE4...");
-              _iterator6 = _createForOfIteratorHelper(poollers);
-              _context37.prev = 21;
-              _iterator6.s();
-            case 23:
-              if ((_step6 = _iterator6.n()).done) {
-                _context37.next = 32;
-                break;
-              }
-              pooller = _step6.value;
-              _index2.utiller.appendInfo("POOLER ".concat(pooller.getPoolId(), " \u6B63\u5728\u95DC\u9589\u4E2D"));
-              _context37.next = 28;
-              return pooller.stopInBackground();
-            case 28:
-              pooller.showState();
-              _index2.utiller.appendInfo("POOLER ".concat(pooller.getPoolId(), " \u95DC\u9589\u6210\u529F!"));
-            case 30:
-              _context37.next = 23;
-              break;
-            case 32:
-              _context37.next = 37;
-              break;
-            case 34:
-              _context37.prev = 34;
-              _context37.t0 = _context37["catch"](21);
-              _iterator6.e(_context37.t0);
-            case 37:
-              _context37.prev = 37;
-              _iterator6.f();
-              return _context37.finish(37);
-            case 40:
-              return _context37.abrupt("break", 43);
-            case 41:
-              _context37.next = 11;
-              break;
-            case 43:
-            case "end":
-              return _context37.stop();
-          }
-        }, _callee37, null, [[21, 34, 37, 40]]);
-      }));
-      function exampleOfInfiniteUnStopLoopingIssue() {
-        return _exampleOfInfiniteUnStopLoopingIssue.apply(this, arguments);
-      }
-      return exampleOfInfiniteUnStopLoopingIssue;
-    }()
-  }, {
-    key: "sampleOfEachTaskInFreeMarker",
-    value: function () {
-      var _sampleOfEachTaskInFreeMarker = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee44() {
-        var test;
-        return _regenerator["default"].wrap(function _callee44$(_context44) {
-          while (1) switch (_context44.prev = _context44.next) {
-            case 0:
-              test = [];
-              _context44.next = 3;
-              return new InfinitePool(6).runByEachTask([/*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee38() {
-                var answer;
-                return _regenerator["default"].wrap(function _callee38$(_context38) {
-                  while (1) switch (_context38.prev = _context38.next) {
-                    case 0:
-                      _context38.next = 2;
-                      return _index2.utiller.syncDelayRandom(2000, 5000);
-                    case 2:
-                      answer = _context38.sent;
-                      console.log(answer);
-                      test.push(answer);
-                    case 5:
-                    case "end":
-                      return _context38.stop();
-                  }
-                }, _callee38);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee39() {
-                var answer;
-                return _regenerator["default"].wrap(function _callee39$(_context39) {
-                  while (1) switch (_context39.prev = _context39.next) {
-                    case 0:
-                      _context39.next = 2;
-                      return _index2.utiller.syncDelayRandom(2000, 5000);
-                    case 2:
-                      answer = _context39.sent;
-                      console.log(answer);
-                      test.push(answer);
-                    case 5:
-                    case "end":
-                      return _context39.stop();
-                  }
-                }, _callee39);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee40() {
-                var answer;
-                return _regenerator["default"].wrap(function _callee40$(_context40) {
-                  while (1) switch (_context40.prev = _context40.next) {
-                    case 0:
-                      _context40.next = 2;
-                      return _index2.utiller.syncDelayRandom(2000, 5000);
-                    case 2:
-                      answer = _context40.sent;
-                      console.log(answer);
-                      test.push(answer);
-                    case 5:
-                    case "end":
-                      return _context40.stop();
-                  }
-                }, _callee40);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee41() {
-                var answer;
-                return _regenerator["default"].wrap(function _callee41$(_context41) {
-                  while (1) switch (_context41.prev = _context41.next) {
-                    case 0:
-                      _context41.next = 2;
-                      return _index2.utiller.syncDelayRandom(2000, 5000);
-                    case 2:
-                      answer = _context41.sent;
-                      console.log(answer);
-                      test.push(answer);
-                    case 5:
-                    case "end":
-                      return _context41.stop();
-                  }
-                }, _callee41);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee42() {
-                var answer;
-                return _regenerator["default"].wrap(function _callee42$(_context42) {
-                  while (1) switch (_context42.prev = _context42.next) {
-                    case 0:
-                      _context42.next = 2;
-                      return _index2.utiller.syncDelayRandom(2000, 5000);
-                    case 2:
-                      answer = _context42.sent;
-                      console.log(answer);
-                      test.push(answer);
-                    case 5:
-                    case "end":
-                      return _context42.stop();
-                  }
-                }, _callee42);
-              })), /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee43() {
-                var answer;
-                return _regenerator["default"].wrap(function _callee43$(_context43) {
-                  while (1) switch (_context43.prev = _context43.next) {
-                    case 0:
-                      _context43.next = 2;
-                      return _index2.utiller.syncDelayRandom(2000, 5000);
-                    case 2:
-                      answer = _context43.sent;
-                      console.log(answer);
-                      test.push(answer);
-                    case 5:
-                    case "end":
-                      return _context43.stop();
-                  }
-                }, _callee43);
-              }))]);
-            case 3:
-              console.log("我好了！！", test);
-            case 4:
-            case "end":
-              return _context44.stop();
-          }
-        }, _callee44);
-      }));
-      function sampleOfEachTaskInFreeMarker() {
-        return _sampleOfEachTaskInFreeMarker.apply(this, arguments);
-      }
-      return sampleOfEachTaskInFreeMarker;
-    }()
   }]);
 }();
 var _default = exports["default"] = InfinitePool;

package/lib/utiller/index.js

@@ -930,8 +930,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "accumulate",
     value:
-    /** 就是把 target 放到 condition 裡面處理, 然後取代原本的target
-     *
+    /**
+     * 把敘述句和條件子句累加在一起，讓其變成一個合理的functional呼叫
      * condition2(condition1(target)) =>  為了應付 collection(path).where('age','>',11).orderBy('age');
      * */
     function accumulate(target, conditions) {
@@ -4291,8 +4291,55 @@ var Utiller = /*#__PURE__*/function () {
       }, {});
     }
   }, {
-    key: "getFilteredHeraPeriods",
-    value: /** ============== 排課系統公式 開始 ============== */
+    key: "mergeArrayByKey",
+    value:
+    /**
+     * 📦 mergeArrayByKey(array)
+     * ---------------------------------------
+     * 將陣列中相同 key 的物件進行「巢狀合併」，並直接 mutate 原陣列內容。
+     *
+     * ✅ 特點：
+     * - 自動合併相同 key 的物件內容（深層合併）
+     * - 不建立新陣列，會直接修改傳入的 array
+     * - 適用於需要整併設定、狀態、表單資料等情境
+     *
+     * 🧩 範例：
+     * ```js
+     * const array = [
+     *   { a: { c: 1 } },
+     *   { b: { d: 2 } },
+     *   { a: { f: 3 } }
+     * ];
+     *
+     * ArrayHelper.mergeArrayByKey(array);
+     *
+     * console.log(array);
+     * // 👉 [ { a: { c: 1, f: 3 } }, { b: { d: 2 } } ]
+     * ```
+     *
+     * @param {Array<Object>} array - 需被合併的物件陣列
+     * @returns {Array<Object>} - 回傳同一個（已被 mutate 的）陣列
+     */
+    function mergeArrayByKey(array) {
+      if (!Array.isArray(array)) return array;
+
+      // 1️⃣ 利用 lodash 深層合併所有物件（例如 {a:{x}} + {a:{y}} => {a:{x,y}})
+      var merged = _lodash["default"].merge.apply(_lodash["default"], [{}].concat((0, _toConsumableArray2["default"])(array)));
+
+      // 2️⃣ 清空原陣列（mutate）
+      array.length = 0;
+
+      // 3️⃣ 將合併結果重新拆成 [{a:{...}}, {b:{...}}] 結構
+      Object.entries(merged).forEach(function (_ref12) {
+        var _ref13 = (0, _slicedToArray2["default"])(_ref12, 2),
+          key = _ref13[0],
+          value = _ref13[1];
+        array.push((0, _defineProperty2["default"])({}, key, value));
+      });
+      return array;
+    }
+
+    /** ============== 排課系統公式 開始 ============== */
 
     /**
      * /const arrayWithDup = [
@@ -4309,7 +4356,9 @@ var Utiller = /*#__PURE__*/function () {
      * 2. idOfBooze和idOfVariant為PK， 重複的只保留一組
      * 3. 回傳filter array,(反查出哪些課程重複會用到其他資訊)
      * */
-    function getFilteredHeraPeriods(arr, idOfCurrentBooze) {
+  }, {
+    key: "getFilteredHeraPeriods",
+    value: function getFilteredHeraPeriods(arr, idOfCurrentBooze) {
       return _lodash["default"].chain(arr)
       // 1️⃣ 刪掉 idOfBooze 等於目標值的項目
       .filter(function (item) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utiller",
-  "version": "1.0.379",
+  "version": "1.0.381",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.23",
-    "utiller": "^1.0.378",
+    "utiller": "^1.0.380",
     "linepayer": "^1.0.15",
     "databazer": "^1.0.17",
     "lodash": "^4.17.20",