tools-min-ns 1.10.3 → 1.11.1

package/README.md

@@ -5,6 +5,14 @@ cnpm i tools-min-ns --save
 ```
 
 # updates
+## v1.11.1
+> BrowserUtil
+修复window暴露问题。
+
+## 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/esm/browser/BrowserUtil.d.ts

@@ -26,7 +26,7 @@ declare namespace BrowserUtil {
      * 判断是否微信内置浏览器
      * @returns boolean
      */
-    const isWeixinBrowser: () => any;
+    const isWeixinBrowser: () => boolean;
     /**
      * 判断是否微信小程序WebView
      * @returns boolean
@@ -36,17 +36,17 @@ declare namespace BrowserUtil {
      * 判断是否是支付宝浏览器
      * @returns boolean
      */
-    const isAlipayBrowser: () => any;
+    const isAlipayBrowser: () => boolean;
     /**
      * 判断是否是支付宝小程序webview
      * @returns boolean
      */
-    const isAlipayMiniWebView: () => any;
+    const isAlipayMiniWebView: () => boolean;
     /**
      * 判断是否是浙里办
      * @returns boolean
      */
-    const isMgopBrowser: () => any;
+    const isMgopBrowser: () => boolean;
     /** 全屏 */
     function fullScreen(root: string | HTMLElement, callback?: (isFull: boolean) => void): void;
     /** 是否全屏 */

package/esm/browser/BrowserUtil.js

@@ -116,10 +116,10 @@ var __generator = this && this.__generator || function (thisArg, body) {
 import BaseUtil from '../base/BaseUtil';
 import env from '../env/env';
 import fingerprint from './fingerprint';
-var userAgent = env.getGlobal().navigator.userAgent;
-var isInUserAgent = function isInUserAgent(v) {
-  return userAgent === null || userAgent === void 0 ? void 0 : userAgent.toLowerCase().includes(v);
-};
+function isInUserAgent(v) {
+  var _a, _b;
+  return !!((_b = (_a = env.getGlobal()) === null || _a === void 0 ? void 0 : _a.navigator.userAgent) === null || _b === void 0 ? void 0 : _b.toLowerCase().includes(v));
+}
 var BrowserUtil;
 (function (BrowserUtil) {
   var _this = this;
@@ -168,6 +168,8 @@ var BrowserUtil;
    * @returns Opera | IE | Edge | Firefox | Safari | Chrome | OverIE10 | ""
    */
   BrowserUtil.browserGetType = function () {
+    var _a;
+    var userAgent = ((_a = env.getGlobal()) === null || _a === void 0 ? void 0 : _a.navigator.userAgent) || '';
     if (userAgent.indexOf('Opera') > -1 || userAgent.indexOf('OPR') > -1) {
       return 'Opera';
     } else if (userAgent.indexOf('compatible') > -1 && userAgent.indexOf('MSIE') > -1) {
@@ -190,6 +192,8 @@ var BrowserUtil;
    * @returns boolean
    */
   BrowserUtil.isMobileBrowser = function () {
+    var _a;
+    var userAgent = ((_a = env.getGlobal()) === null || _a === void 0 ? void 0 : _a.navigator.userAgent) || '';
     return !!userAgent.toLowerCase().match(/(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|SymbianOS|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone)/i);
   };
   /**

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/lib/browser/BrowserUtil.d.ts

@@ -26,7 +26,7 @@ declare namespace BrowserUtil {
      * 判断是否微信内置浏览器
      * @returns boolean
      */
-    const isWeixinBrowser: () => any;
+    const isWeixinBrowser: () => boolean;
     /**
      * 判断是否微信小程序WebView
      * @returns boolean
@@ -36,17 +36,17 @@ declare namespace BrowserUtil {
      * 判断是否是支付宝浏览器
      * @returns boolean
      */
-    const isAlipayBrowser: () => any;
+    const isAlipayBrowser: () => boolean;
     /**
      * 判断是否是支付宝小程序webview
      * @returns boolean
      */
-    const isAlipayMiniWebView: () => any;
+    const isAlipayMiniWebView: () => boolean;
     /**
      * 判断是否是浙里办
      * @returns boolean
      */
-    const isMgopBrowser: () => any;
+    const isMgopBrowser: () => boolean;
     /** 全屏 */
     function fullScreen(root: string | HTMLElement, callback?: (isFull: boolean) => void): void;
     /** 是否全屏 */

package/lib/browser/BrowserUtil.js

@@ -126,10 +126,10 @@ Object.defineProperty(exports, "__esModule", {
 var BaseUtil_1 = __importDefault(require("../base/BaseUtil"));
 var env_1 = __importDefault(require("../env/env"));
 var fingerprint_1 = __importDefault(require("./fingerprint"));
-var userAgent = env_1.default.getGlobal().navigator.userAgent;
-var isInUserAgent = function isInUserAgent(v) {
-  return userAgent === null || userAgent === void 0 ? void 0 : userAgent.toLowerCase().includes(v);
-};
+function isInUserAgent(v) {
+  var _a, _b;
+  return !!((_b = (_a = env_1.default.getGlobal()) === null || _a === void 0 ? void 0 : _a.navigator.userAgent) === null || _b === void 0 ? void 0 : _b.toLowerCase().includes(v));
+}
 var BrowserUtil;
 (function (BrowserUtil) {
   var _this = this;
@@ -178,6 +178,8 @@ var BrowserUtil;
    * @returns Opera | IE | Edge | Firefox | Safari | Chrome | OverIE10 | ""
    */
   BrowserUtil.browserGetType = function () {
+    var _a;
+    var userAgent = ((_a = env_1.default.getGlobal()) === null || _a === void 0 ? void 0 : _a.navigator.userAgent) || '';
     if (userAgent.indexOf('Opera') > -1 || userAgent.indexOf('OPR') > -1) {
       return 'Opera';
     } else if (userAgent.indexOf('compatible') > -1 && userAgent.indexOf('MSIE') > -1) {
@@ -200,6 +202,8 @@ var BrowserUtil;
    * @returns boolean
    */
   BrowserUtil.isMobileBrowser = function () {
+    var _a;
+    var userAgent = ((_a = env_1.default.getGlobal()) === null || _a === void 0 ? void 0 : _a.navigator.userAgent) || '';
     return !!userAgent.toLowerCase().match(/(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|SymbianOS|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone)/i);
   };
   /**

package/package.json

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