tools-min-ns 1.13.0 → 1.14.0

package/README.md

@@ -5,6 +5,8 @@ cnpm i tools-min-ns --save
 ```
 
 # updates
+## v1.14.0
+> ArrayUtil 新增三个分组方法
 ## v1.13.0
 > RequestUtil
 - handleRequests 中onUploadProgress新增两个参数nowResponse: T; endResponses: T[]

package/esm/array/ArrayUtil.d.ts

@@ -135,5 +135,43 @@ console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim',
 console.log(universalSort([5, 3, 8, 1, 2], null, 'desc')); // [8, 5, 3, 2, 1]
      */
     function universalSort<T>(array: T[], key?: keyof T | ((item: T) => any), order?: 'asc' | 'desc'): T[];
+    /**
+     * 根据对象的属性值进行分组
+     * @param array 对象数组
+     * @param key 对象的key
+     * @example
+const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+];
+
+const groupedByAge = groupBy(data, 'age');
+console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+     */
+    function groupBy<T>(array: T[], key: keyof T): Record<keyof T, T[]>;
+    /**
+     * 按条件分组
+     * @param array 对象数组
+     * @param condition filter
+     * @example
+const numbers: number[] = [1, 2, 3, 4, 5, 6];
+
+const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+     */
+    function groupByCondition<T>(array: T[], condition: (value: T) => boolean): Record<'true' | 'false', T[]>;
+    /**
+     * 按固定大小分组
+     * @param array 对象数组
+     * @param size 数量
+     * @example
+const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+
+const chunkedArray = chunkArray(data, 3);
+console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+     */
+    function chunkArray<T>(array: T[], size: number): T[][];
 }
 export default ArrayUtil;

package/esm/array/ArrayUtil.js

@@ -309,5 +309,67 @@ var ArrayUtil;
     return array.sort(compareFunction);
   }
   ArrayUtil.universalSort = universalSort;
+  /**
+   * 根据对象的属性值进行分组
+   * @param array 对象数组
+   * @param key 对象的key
+   * @example
+  const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+  ];
+  const groupedByAge = groupBy(data, 'age');
+  console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+   */
+  function groupBy(array, key) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = currentValue[key];
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupBy = groupBy;
+  /**
+   * 按条件分组
+   * @param array 对象数组
+   * @param condition filter
+   * @example
+  const numbers: number[] = [1, 2, 3, 4, 5, 6];
+  const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+  console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+   */
+  function groupByCondition(array, condition) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = condition(currentValue) ? 'true' : 'false';
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupByCondition = groupByCondition;
+  /**
+   * 按固定大小分组
+   * @param array 对象数组
+   * @param size 数量
+   * @example
+  const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+  const chunkedArray = chunkArray(data, 3);
+  console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+   */
+  function chunkArray(array, size) {
+    var result = [];
+    for (var i = 0; i < array.length; i += size) {
+      result.push(array.slice(i, i + size));
+    }
+    return result;
+  }
+  ArrayUtil.chunkArray = chunkArray;
 })(ArrayUtil || (ArrayUtil = {}));
 export default ArrayUtil;

package/lib/array/ArrayUtil.d.ts

@@ -135,5 +135,43 @@ console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim',
 console.log(universalSort([5, 3, 8, 1, 2], null, 'desc')); // [8, 5, 3, 2, 1]
      */
     function universalSort<T>(array: T[], key?: keyof T | ((item: T) => any), order?: 'asc' | 'desc'): T[];
+    /**
+     * 根据对象的属性值进行分组
+     * @param array 对象数组
+     * @param key 对象的key
+     * @example
+const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+];
+
+const groupedByAge = groupBy(data, 'age');
+console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+     */
+    function groupBy<T>(array: T[], key: keyof T): Record<keyof T, T[]>;
+    /**
+     * 按条件分组
+     * @param array 对象数组
+     * @param condition filter
+     * @example
+const numbers: number[] = [1, 2, 3, 4, 5, 6];
+
+const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+     */
+    function groupByCondition<T>(array: T[], condition: (value: T) => boolean): Record<'true' | 'false', T[]>;
+    /**
+     * 按固定大小分组
+     * @param array 对象数组
+     * @param size 数量
+     * @example
+const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+
+const chunkedArray = chunkArray(data, 3);
+console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+     */
+    function chunkArray<T>(array: T[], size: number): T[][];
 }
 export default ArrayUtil;

package/lib/array/ArrayUtil.js

@@ -319,5 +319,67 @@ var ArrayUtil;
     return array.sort(compareFunction);
   }
   ArrayUtil.universalSort = universalSort;
+  /**
+   * 根据对象的属性值进行分组
+   * @param array 对象数组
+   * @param key 对象的key
+   * @example
+  const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+  ];
+  const groupedByAge = groupBy(data, 'age');
+  console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+   */
+  function groupBy(array, key) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = currentValue[key];
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupBy = groupBy;
+  /**
+   * 按条件分组
+   * @param array 对象数组
+   * @param condition filter
+   * @example
+  const numbers: number[] = [1, 2, 3, 4, 5, 6];
+  const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+  console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+   */
+  function groupByCondition(array, condition) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = condition(currentValue) ? 'true' : 'false';
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupByCondition = groupByCondition;
+  /**
+   * 按固定大小分组
+   * @param array 对象数组
+   * @param size 数量
+   * @example
+  const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+  const chunkedArray = chunkArray(data, 3);
+  console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+   */
+  function chunkArray(array, size) {
+    var result = [];
+    for (var i = 0; i < array.length; i += size) {
+      result.push(array.slice(i, i + size));
+    }
+    return result;
+  }
+  ArrayUtil.chunkArray = chunkArray;
 })(ArrayUtil || (ArrayUtil = {}));
 exports.default = ArrayUtil;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tools-min-ns",
   "description": "工具包适用于前端以及node",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "main": "lib/index.js",
   "license": "MIT",
   "author": "nanshen",