utiller 1.0.295 → 1.0.297

package/lib/utiller/index.js

@@ -2029,6 +2029,33 @@ var Utiller = /*#__PURE__*/function () {
       })();
     }
 
+    /**
+     * Merge multiple arrays of objects based on a specific identifier key.
+     * If objects have the same identifier, they will be merged,
+     * with properties from later arrays overwriting earlier ones.
+     *
+     * const list1 = [{ id: '123', name: 'david' }];
+     * const list2 = [{ id: '123', age: 13 }];
+     * const list3 = [{ id: '456', name: 'alice' }];
+     * console.log(mergeArrayBy('id', list1, list2, list3)); //[ { href: '123', name: 'david', age: 13 },{ href: '456', name: 'alice' } ]
+     *
+     * @param {string} identifier - The object property used to identify and merge items. Default is 'id'.
+     * @param {...Array<Object>} array - Multiple arrays containing objects to merge.
+     * @returns {Array<Object>} A new array with merged objects based on the identifier.
+     */
+  }, {
+    key: "mergeArrayBy",
+    value: function mergeArrayBy() {
+      var identifier = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "id";
+      for (var _len22 = arguments.length, array = new Array(_len22 > 1 ? _len22 - 1 : 0), _key26 = 1; _key26 < _len22; _key26++) {
+        array[_key26 - 1] = arguments[_key26];
+      }
+      return Object.values(array.flat().reduce(function (acc, item) {
+        if (item[identifier]) acc[item[identifier]] = _objectSpread(_objectSpread({}, acc[item[identifier]] || {}), item);
+        return acc;
+      }, {}));
+    }
+
     /**
      *  rootName : /free_marker/src/exam/web
      *  pathName : /free_marker/src/exam/web/src/base/AlertDialog.js
@@ -2301,8 +2328,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "toObjectMap",
     value: function toObjectMap(array) {
       var newbies = [];
-      for (var _len22 = arguments.length, rules = new Array(_len22 > 1 ? _len22 - 1 : 0), _key26 = 1; _key26 < _len22; _key26++) {
-        rules[_key26 - 1] = arguments[_key26];
+      for (var _len23 = arguments.length, rules = new Array(_len23 > 1 ? _len23 - 1 : 0), _key27 = 1; _key27 < _len23; _key27++) {
+        rules[_key27 - 1] = arguments[_key27];
       }
       var _iterator9 = _createForOfIteratorHelper(array),
         _step9;
@@ -2347,8 +2374,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "exeAll",
     value: function exeAll(collection) {
-      for (var _len23 = arguments.length, funcs = new Array(_len23 > 1 ? _len23 - 1 : 0), _key27 = 1; _key27 < _len23; _key27++) {
-        funcs[_key27 - 1] = arguments[_key27];
+      for (var _len24 = arguments.length, funcs = new Array(_len24 > 1 ? _len24 - 1 : 0), _key28 = 1; _key28 < _len24; _key28++) {
+        funcs[_key28 - 1] = arguments[_key28];
       }
       if (_lodash["default"].isArray(collection)) {
         var _iterator11 = _createForOfIteratorHelper(collection),
@@ -2403,9 +2430,9 @@ var Utiller = /*#__PURE__*/function () {
         return true;
       };
       var collection = {};
-      for (var _key28 in major) {
-        if (predicate(major, minor, _key28)) {
-          collection[_key28] = major[_key28];
+      for (var _key29 in major) {
+        if (predicate(major, minor, _key29)) {
+          collection[_key29] = major[_key29];
         }
       }
       return collection;
@@ -2452,8 +2479,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "isObjectContainAndEqual",
     value: function isObjectContainAndEqual(targetObject, mainObject) {
       var equal = true;
-      for (var _key29 in targetObject) {
-        if (mainObject[_key29] === undefined || mainObject[_key29] !== targetObject[_key29]) {
+      for (var _key30 in targetObject) {
+        if (mainObject[_key30] === undefined || mainObject[_key30] !== targetObject[_key30]) {
           equal = false;
           break;
         }
@@ -2531,8 +2558,8 @@ var Utiller = /*#__PURE__*/function () {
   }, {
     key: "getStateOfStringContainsSign",
     value: function getStateOfStringContainsSign(string) {
-      for (var _len24 = arguments.length, signs = new Array(_len24 > 1 ? _len24 - 1 : 0), _key30 = 1; _key30 < _len24; _key30++) {
-        signs[_key30 - 1] = arguments[_key30];
+      for (var _len25 = arguments.length, signs = new Array(_len25 > 1 ? _len25 - 1 : 0), _key31 = 1; _key31 < _len25; _key31++) {
+        signs[_key31 - 1] = arguments[_key31];
       }
       for (var _i14 = 0, _signs = signs; _i14 < _signs.length; _i14++) {
         var sign = _signs[_i14];
@@ -2554,8 +2581,8 @@ var Utiller = /*#__PURE__*/function () {
     key: "constraintOfParam",
     value: function constraintOfParam(collection, type) {
       var result = false;
-      for (var _len25 = arguments.length, others = new Array(_len25 > 2 ? _len25 - 2 : 0), _key31 = 2; _key31 < _len25; _key31++) {
-        others[_key31 - 2] = arguments[_key31];
+      for (var _len26 = arguments.length, others = new Array(_len26 > 2 ? _len26 - 2 : 0), _key32 = 2; _key32 < _len26; _key32++) {
+        others[_key32 - 2] = arguments[_key32];
       }
       var validOfOthersCondition = _lodash["default"].isEmpty(others) ? true : this.and.apply(this, (0, _toConsumableArray2["default"])(others.map(function (each) {
         return each.logic;
@@ -2704,8 +2731,8 @@ var Utiller = /*#__PURE__*/function () {
         _step15;
       try {
         for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
-          var _key32 = _step15.value;
-          checkValue += "".concat(_key32, "=").concat(clone[_key32], "&");
+          var _key33 = _step15.value;
+          checkValue += "".concat(_key33, "=").concat(clone[_key33], "&");
         }
       } catch (err) {
         _iterator15.e(err);
@@ -2799,10 +2826,10 @@ var Utiller = /*#__PURE__*/function () {
               throw new _exceptioner["default"](9999, "".concat(idOfError, " ATTRIBUTE:'").concat(rule, "' is not Exist"));
             }
           } else if (_lodash["default"].isObject(rule)) {
-            var _key33 = this.getObjectKey(rule);
+            var _key34 = this.getObjectKey(rule);
             var predicate = this.getObjectValue(rule);
-            if (!predicate(content[_key33])) {
-              throw new _exceptioner["default"](9999, "".concat(idOfError, " ATTRIBUTE:'").concat(_key33, "' is not valid of custom rule"));
+            if (!predicate(content[_key34])) {
+              throw new _exceptioner["default"](9999, "".concat(idOfError, " ATTRIBUTE:'").concat(_key34, "' is not valid of custom rule"));
             }
           }
         }
@@ -2836,11 +2863,11 @@ var Utiller = /*#__PURE__*/function () {
       try {
         for (_iterator18.s(); !(_step18 = _iterator18.n()).done;) {
           var item = _step18.value;
-          var _key35 = item[keyOfId];
-          if (obj[_key35] !== undefined) {
-            obj[_key35] = obj[_key35] + item[keyOfSum];
+          var _key36 = item[keyOfId];
+          if (obj[_key36] !== undefined) {
+            obj[_key36] = obj[_key36] + item[keyOfSum];
           } else {
-            obj[_key35] = item[keyOfSum];
+            obj[_key36] = item[keyOfSum];
           }
         }
       } catch (err) {
@@ -2849,10 +2876,10 @@ var Utiller = /*#__PURE__*/function () {
         _iterator18.f();
       }
       var items = [];
-      for (var _key34 in obj) {
+      for (var _key35 in obj) {
         var _obj = {};
-        _obj[keyOfId] = _key34;
-        _obj[keyOfSum] = obj[_key34];
+        _obj[keyOfId] = _key35;
+        _obj[keyOfSum] = obj[_key35];
         items.push(_obj);
       }
       return items;
@@ -3201,9 +3228,9 @@ var Utiller = /*#__PURE__*/function () {
       var _fetchElementAttributes = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee9(dom, stringOfTrait) {
         var defaultValue,
           element,
-          _len26,
+          _len27,
           attributes,
-          _key36,
+          _key37,
           _args10 = arguments;
         return _regenerator["default"].wrap(function _callee9$(_context10) {
           while (1) switch (_context10.prev = _context10.next) {
@@ -3217,8 +3244,8 @@ var Utiller = /*#__PURE__*/function () {
                 _context10.next = 16;
                 break;
               }
-              for (_len26 = _args10.length, attributes = new Array(_len26 > 3 ? _len26 - 3 : 0), _key36 = 3; _key36 < _len26; _key36++) {
-                attributes[_key36 - 3] = _args10[_key36];
+              for (_len27 = _args10.length, attributes = new Array(_len27 > 3 ? _len27 - 3 : 0), _key37 = 3; _key37 < _len27; _key37++) {
+                attributes[_key37 - 3] = _args10[_key37];
               }
               _context10.prev = 6;
               _context10.next = 9;
@@ -3259,9 +3286,9 @@ var Utiller = /*#__PURE__*/function () {
     value: (function () {
       var _writeElementAttributes = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee10(dom, stringOfTrait) {
         var element,
-          _len27,
+          _len28,
           attributes,
-          _key37,
+          _key38,
           _args11 = arguments;
         return _regenerator["default"].wrap(function _callee10$(_context11) {
           while (1) switch (_context11.prev = _context11.next) {
@@ -3270,8 +3297,8 @@ var Utiller = /*#__PURE__*/function () {
               return dom.$(stringOfTrait);
             case 2:
               element = _context11.sent;
-              for (_len27 = _args11.length, attributes = new Array(_len27 > 2 ? _len27 - 2 : 0), _key37 = 2; _key37 < _len27; _key37++) {
-                attributes[_key37 - 2] = _args11[_key37];
+              for (_len28 = _args11.length, attributes = new Array(_len28 > 2 ? _len28 - 2 : 0), _key38 = 2; _key38 < _len28; _key38++) {
+                attributes[_key38 - 2] = _args11[_key38];
               }
               if (this.isUndefinedNullEmpty(element)) {
                 _context11.next = 9;
@@ -3350,6 +3377,25 @@ var Utiller = /*#__PURE__*/function () {
         return Array.from(new Set(array));
       }
     }
+
+    /**
+    * Extract unique values of a specific key from an array of objects.
+    * array = [ { valueOfType: 1 }, { valueOfType: 7, valueOfSubType: 6 }, { valueOfType: 1 } ];
+    console.log(getUniqueValuesBy(array, 'valueOfType')); //[1, 7]
+    *
+    * @param {Array<Object>} array - The array of objects to process.
+    * @param {string} key - The key to extract values from. Default is 'valueOfType'.
+    * @returns {Array<any>} A deduplicated array of the extracted values.
+    */
+  }, {
+    key: "getUniqueValuesBy",
+    value: function getUniqueValuesBy(array) {
+      var key = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "valueOfType";
+      return _lodash["default"].uniq(array.map(function (item) {
+        return item[key];
+      }));
+    }
+    /* 測試資料 */
   }]);
 }();
 var _default = exports["default"] = Utiller;

package/package.json

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

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.11",
-    "utiller": "^1.0.294",
+    "utiller": "^1.0.296",
     "linepayer": "^1.0.4",
     "databazer": "^1.0.12",
     "lodash": "^4.17.20",