tools-min-ns 1.10.3 → 1.11.0

package/README.md

@@ -5,6 +5,10 @@ cnpm i tools-min-ns --save
 ```
 
 # updates
+## v1.10.3
+> ArrayUtil
+新增universalSort
+
 ## v1.10.3
 > TransferUtil
 getFileSizeByBytes修复参数n

package/esm/array/ArrayUtil.d.ts

@@ -105,5 +105,35 @@ declare namespace ArrayUtil {
      * randomSortArr([{a:1},{a:2},{a:3}]) => [{a:3},{a:1},{a:2}]
      */
     function randomSortArr<T>(arr: T[]): T[];
+    /**
+     * 通用排序函数
+     * @param array 要排序的数组
+     * @param key 排序依据的键（如果数组元素是对象）或自定义排序函数
+     * @param order 排序顺序（'asc' 表示升序，'desc' 表示降序）
+     * @returns 排序后的数组
+     * @example
+     *
+
+// 排序数字数组
+console.log(universalSort([5, 3, 8, 1, 2])); // [1, 2, 3, 5, 8]
+
+// 排序字符串数组
+console.log(universalSort(['banana', 'apple', 'cherry'])); // ['apple', 'banana', 'cherry']
+
+// 排序对象数组（按对象属性）
+const objArray = [
+    { name: 'John', age: 30 },
+    { name: 'Jane', age: 25 },
+    { name: 'Jim', age: 35 }
+];
+console.log(universalSort(objArray, 'age')); // [{ name: 'Jane', age: 25 }, { name: 'John', age: 30 }, { name: 'Jim', age: 35 }]
+
+// 按自定义函数排序
+console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim', age: 35 }, { name: 'John', age: 30 }, { name: 'Jane', age: 25 }]
+
+// 按降序排序
+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[];
 }
 export default ArrayUtil;

package/esm/array/ArrayUtil.js

@@ -243,5 +243,71 @@ var ArrayUtil;
     });
   }
   ArrayUtil.randomSortArr = randomSortArr;
+  /**
+   * 通用排序函数
+   * @param array 要排序的数组
+   * @param key 排序依据的键（如果数组元素是对象）或自定义排序函数
+   * @param order 排序顺序（'asc' 表示升序，'desc' 表示降序）
+   * @returns 排序后的数组
+   * @example
+   *
+  // 排序数字数组
+  console.log(universalSort([5, 3, 8, 1, 2])); // [1, 2, 3, 5, 8]
+  // 排序字符串数组
+  console.log(universalSort(['banana', 'apple', 'cherry'])); // ['apple', 'banana', 'cherry']
+  // 排序对象数组（按对象属性）
+  const objArray = [
+  { name: 'John', age: 30 },
+  { name: 'Jane', age: 25 },
+  { name: 'Jim', age: 35 }
+  ];
+  console.log(universalSort(objArray, 'age')); // [{ name: 'Jane', age: 25 }, { name: 'John', age: 30 }, { name: 'Jim', age: 35 }]
+  // 按自定义函数排序
+  console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim', age: 35 }, { name: 'John', age: 30 }, { name: 'Jane', age: 25 }]
+  // 按降序排序
+  console.log(universalSort([5, 3, 8, 1, 2], null, 'desc')); // [8, 5, 3, 2, 1]
+   */
+  function universalSort(array, key, order) {
+    if (order === void 0) {
+      order = 'asc';
+    }
+    // 检查排序顺序是否合法
+    if (order !== 'asc' && order !== 'desc') {
+      throw new Error("排序顺序必须是 'asc' 或 'desc'");
+    }
+    // 比较函数生成器
+    var compareFunction = function compareFunction(a, b) {
+      var valA, valB;
+      // 如果 key 是函数，调用它来获取比较值
+      if (typeof key === 'function') {
+        valA = key(a);
+        valB = key(b);
+      } else if (key) {
+        // 如果 key 是字符串，获取对象属性的值
+        valA = a[key];
+        valB = b[key];
+      } else {
+        // 如果没有 key，直接比较值
+        valA = a;
+        valB = b;
+      }
+      // 转换为小写字符串比较（针对字符串情况）
+      if (typeof valA === 'string' && typeof valB === 'string') {
+        valA = valA.toLowerCase();
+        valB = valB.toLowerCase();
+      }
+      // 比较逻辑
+      if (valA < valB) {
+        return order === 'asc' ? -1 : 1;
+      }
+      if (valA > valB) {
+        return order === 'asc' ? 1 : -1;
+      }
+      return 0;
+    };
+    // 使用比较函数对数组进行排序
+    return array.sort(compareFunction);
+  }
+  ArrayUtil.universalSort = universalSort;
 })(ArrayUtil || (ArrayUtil = {}));
 export default ArrayUtil;

package/lib/array/ArrayUtil.d.ts

@@ -105,5 +105,35 @@ declare namespace ArrayUtil {
      * randomSortArr([{a:1},{a:2},{a:3}]) => [{a:3},{a:1},{a:2}]
      */
     function randomSortArr<T>(arr: T[]): T[];
+    /**
+     * 通用排序函数
+     * @param array 要排序的数组
+     * @param key 排序依据的键（如果数组元素是对象）或自定义排序函数
+     * @param order 排序顺序（'asc' 表示升序，'desc' 表示降序）
+     * @returns 排序后的数组
+     * @example
+     *
+
+// 排序数字数组
+console.log(universalSort([5, 3, 8, 1, 2])); // [1, 2, 3, 5, 8]
+
+// 排序字符串数组
+console.log(universalSort(['banana', 'apple', 'cherry'])); // ['apple', 'banana', 'cherry']
+
+// 排序对象数组（按对象属性）
+const objArray = [
+    { name: 'John', age: 30 },
+    { name: 'Jane', age: 25 },
+    { name: 'Jim', age: 35 }
+];
+console.log(universalSort(objArray, 'age')); // [{ name: 'Jane', age: 25 }, { name: 'John', age: 30 }, { name: 'Jim', age: 35 }]
+
+// 按自定义函数排序
+console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim', age: 35 }, { name: 'John', age: 30 }, { name: 'Jane', age: 25 }]
+
+// 按降序排序
+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[];
 }
 export default ArrayUtil;

package/lib/array/ArrayUtil.js

@@ -253,5 +253,71 @@ var ArrayUtil;
     });
   }
   ArrayUtil.randomSortArr = randomSortArr;
+  /**
+   * 通用排序函数
+   * @param array 要排序的数组
+   * @param key 排序依据的键（如果数组元素是对象）或自定义排序函数
+   * @param order 排序顺序（'asc' 表示升序，'desc' 表示降序）
+   * @returns 排序后的数组
+   * @example
+   *
+  // 排序数字数组
+  console.log(universalSort([5, 3, 8, 1, 2])); // [1, 2, 3, 5, 8]
+  // 排序字符串数组
+  console.log(universalSort(['banana', 'apple', 'cherry'])); // ['apple', 'banana', 'cherry']
+  // 排序对象数组（按对象属性）
+  const objArray = [
+  { name: 'John', age: 30 },
+  { name: 'Jane', age: 25 },
+  { name: 'Jim', age: 35 }
+  ];
+  console.log(universalSort(objArray, 'age')); // [{ name: 'Jane', age: 25 }, { name: 'John', age: 30 }, { name: 'Jim', age: 35 }]
+  // 按自定义函数排序
+  console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim', age: 35 }, { name: 'John', age: 30 }, { name: 'Jane', age: 25 }]
+  // 按降序排序
+  console.log(universalSort([5, 3, 8, 1, 2], null, 'desc')); // [8, 5, 3, 2, 1]
+   */
+  function universalSort(array, key, order) {
+    if (order === void 0) {
+      order = 'asc';
+    }
+    // 检查排序顺序是否合法
+    if (order !== 'asc' && order !== 'desc') {
+      throw new Error("排序顺序必须是 'asc' 或 'desc'");
+    }
+    // 比较函数生成器
+    var compareFunction = function compareFunction(a, b) {
+      var valA, valB;
+      // 如果 key 是函数，调用它来获取比较值
+      if (typeof key === 'function') {
+        valA = key(a);
+        valB = key(b);
+      } else if (key) {
+        // 如果 key 是字符串，获取对象属性的值
+        valA = a[key];
+        valB = b[key];
+      } else {
+        // 如果没有 key，直接比较值
+        valA = a;
+        valB = b;
+      }
+      // 转换为小写字符串比较（针对字符串情况）
+      if (typeof valA === 'string' && typeof valB === 'string') {
+        valA = valA.toLowerCase();
+        valB = valB.toLowerCase();
+      }
+      // 比较逻辑
+      if (valA < valB) {
+        return order === 'asc' ? -1 : 1;
+      }
+      if (valA > valB) {
+        return order === 'asc' ? 1 : -1;
+      }
+      return 0;
+    };
+    // 使用比较函数对数组进行排序
+    return array.sort(compareFunction);
+  }
+  ArrayUtil.universalSort = universalSort;
 })(ArrayUtil || (ArrayUtil = {}));
 exports.default = ArrayUtil;

package/package.json

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