@whitesev/utils 2.3.5 → 2.3.7

package/dist/types/src/Utils.d.ts

@@ -434,7 +434,9 @@ declare class Utils {
     getMaxValue(val: UtilsOwnObject<number>, handler: (key: any, value: any) => number): number;
     /**
      * 获取页面中最大的z-index的元素信息
-     * @param deviation 获取最大的z-index值的偏移，默认是+1
+     * @param deviation 获取最大的z-index值的偏移，默认是1
+     * @param node 进行判断的元素，默认是document
+     * @param ignoreCallBack 执行元素处理时调用的函数，返回false可忽略不想要处理的元素
      * @example
      * Utils.getMaxZIndexNodeInfo();
      * > {
@@ -442,18 +444,20 @@ declare class Utils {
      *   zIndex: 1001
      * }
      **/
-    getMaxZIndexNodeInfo(deviation?: number): {
+    getMaxZIndexNodeInfo(deviation?: number, target?: Element | ShadowRoot | Document, ignoreCallBack?: ($ele: Element | HTMLElement | ShadowRoot) => boolean | void): {
         node: Element;
         zIndex: number;
     };
     /**
      * 获取页面中最大的z-index
-     * @param deviation 获取最大的z-index值的偏移，默认是+1
+     * @param deviation 获取最大的z-index值的偏移，默认是1
+     * @param node 进行判断的元素，默认是document
+     * @param ignoreCallBack 执行元素处理时调用的函数，返回false可忽略不想要处理的元素
      * @example
      * Utils.getMaxZIndex();
      * > 1001
      **/
-    getMaxZIndex(deviation?: number): number;
+    getMaxZIndex(deviation?: number, target?: Element | DocumentOrShadowRoot | Document, ignoreCallBack?: ($ele: Element | HTMLElement | ShadowRoot) => boolean | void): number;
     /**
      * 获取最小值
      * @example
@@ -959,7 +963,7 @@ declare class Utils {
      * Utils.parseObjectToArray({"工具类":"jsonToArray","return","Array"});
      * > ['jsonToArray', 'Array']
      **/
-    parseObjectToArray(target: any): any;
+    parseObjectToArray<T extends any>(target: T): T[keyof T][];
     /**
      * 自动锁对象，用于循环判断运行的函数，在循环外new后使用，注意，如果函数内部存在异步操作，需要使用await
      * @example
@@ -1010,7 +1014,7 @@ declare class Utils {
      * Utils.mergeArrayToString([{"name":"数组内数据部分字段合并成字符串->"},{"name":"mergeToString"}],(item)=>{return item["name"]});
      * > '数组内数据部分字段合并成字符串->mergeToString'
      **/
-    mergeArrayToString(data: any[], handleFunc?: (val: any) => any): string;
+    mergeArrayToString<T extends any>(data: T[], handleFunc?: ((val: T) => T) | keyof T): string;
     /**
      * 监听页面元素改变并处理
      * @param target 需要监听的元素，如果不存在，可以等待它出现
@@ -1138,7 +1142,7 @@ declare class Utils {
      * Utils.parseInt(["aaaaaaa"],"aa");
      * > NaN
      **/
-    parseInt(matchList?: any[], defaultValue?: number): number;
+    parseInt(matchList?: any[] | null | undefined | RegExpMatchArray, defaultValue?: number): number;
     /**
      * blob转File对象
      * @param blobUrl 需要转换的blob的链接

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/utils",
-  "version": "2.3.5",
+  "version": "2.3.7",
   "description": "一个常用的工具库",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/src/Utils.ts

@@ -53,7 +53,7 @@ class Utils {
 		this.windowApi = new WindowApi(option);
 	}
 	/** 版本号 */
-	version = "2024.9.28";
+	version = "2024.10.19";
 
 	/**
 	 * 在页面中增加style元素，如果html节点存在子节点，添加子节点第一个，反之，添加到html节点的子节点最后一个
@@ -1228,7 +1228,9 @@ class Utils {
 	}
 	/**
 	 * 获取页面中最大的z-index的元素信息
-	 * @param deviation 获取最大的z-index值的偏移，默认是+1
+	 * @param deviation 获取最大的z-index值的偏移，默认是1
+	 * @param node 进行判断的元素，默认是document
+	 * @param ignoreCallBack 执行元素处理时调用的函数，返回false可忽略不想要处理的元素
 	 * @example
 	 * Utils.getMaxZIndexNodeInfo();
 	 * > {
@@ -1236,11 +1238,23 @@ class Utils {
 	 *   zIndex: 1001
 	 * }
 	 **/
-	getMaxZIndexNodeInfo(deviation?: number): {
+	getMaxZIndexNodeInfo(
+		deviation?: number,
+		target?: Element | ShadowRoot | Document,
+		ignoreCallBack?: (
+			$ele: Element | HTMLElement | ShadowRoot
+		) => boolean | void
+	): {
 		node: Element;
 		zIndex: number;
 	};
-	getMaxZIndexNodeInfo(deviation = 1): {
+	getMaxZIndexNodeInfo(
+		deviation = 1,
+		target: Element | ShadowRoot | Document = this.windowApi.document,
+		ignoreCallBack?: (
+			$ele: Element | HTMLElement | ShadowRoot
+		) => boolean | void
+	): {
 		node: Element;
 		zIndex: number;
 	} {
@@ -1268,6 +1282,12 @@ class Utils {
 		 * @param $ele
 		 */
 		function queryMaxZIndex($ele: Element) {
+			if (typeof ignoreCallBack === "function") {
+				let ignoreResult = ignoreCallBack($ele);
+				if (typeof ignoreResult === "boolean" && !ignoreResult) {
+					return;
+				}
+			}
 			/** 元素的样式 */
 			const nodeStyle = UtilsContext.windowApi.window.getComputedStyle($ele);
 			/* 不对position为static和display为none的元素进行获取它们的z-index */
@@ -1288,7 +1308,7 @@ class Utils {
 				}
 			}
 		}
-		this.windowApi.document.querySelectorAll("*").forEach(($ele, index) => {
+		target.querySelectorAll("*").forEach(($ele, index) => {
 			queryMaxZIndex($ele);
 		});
 		zIndex += deviation;
@@ -1303,14 +1323,28 @@ class Utils {
 	}
 	/**
 	 * 获取页面中最大的z-index
-	 * @param deviation 获取最大的z-index值的偏移，默认是+1
+	 * @param deviation 获取最大的z-index值的偏移，默认是1
+	 * @param node 进行判断的元素，默认是document
+	 * @param ignoreCallBack 执行元素处理时调用的函数，返回false可忽略不想要处理的元素
 	 * @example
 	 * Utils.getMaxZIndex();
 	 * > 1001
 	 **/
-	getMaxZIndex(deviation?: number): number;
-	getMaxZIndex(deviation = 1): number {
-		return this.getMaxZIndexNodeInfo(deviation).zIndex;
+	getMaxZIndex(
+		deviation?: number,
+		target?: Element | DocumentOrShadowRoot | Document,
+		ignoreCallBack?: (
+			$ele: Element | HTMLElement | ShadowRoot
+		) => boolean | void
+	): number;
+	getMaxZIndex(
+		deviation = 1,
+		target: Element | ShadowRoot | Document = this.windowApi.document,
+		ignoreCallBack?: (
+			$ele: Element | HTMLElement | ShadowRoot
+		) => boolean | void
+	): number {
+		return this.getMaxZIndexNodeInfo(deviation, target, ignoreCallBack).zIndex;
 	}
 	/**
 	 * 获取最小值
@@ -2344,16 +2378,16 @@ class Utils {
 	 * Utils.parseObjectToArray({"工具类":"jsonToArray","return","Array"});
 	 * > ['jsonToArray', 'Array']
 	 **/
-	parseObjectToArray(target: any): any;
-	parseObjectToArray(target: any): any {
+	parseObjectToArray<T extends any>(target: T): T[keyof T][];
+	parseObjectToArray<T extends any>(target: T) {
 		if (typeof target !== "object") {
 			throw new Error(
 				"Utils.parseObjectToArray 参数 target 必须为 object 类型"
 			);
 		}
-		let result: any[] = [];
-		Object.keys(target).forEach(function (keyName) {
-			result = result.concat(target[keyName]);
+		let result: T[keyof T][] = [];
+		Object.keys(target!).forEach(function (keyName) {
+			result = result.concat(target![keyName as any as keyof T]);
 		});
 		return result;
 	}
@@ -2407,8 +2441,14 @@ class Utils {
 	 * Utils.mergeArrayToString([{"name":"数组内数据部分字段合并成字符串->"},{"name":"mergeToString"}],(item)=>{return item["name"]});
 	 * > '数组内数据部分字段合并成字符串->mergeToString'
 	 **/
-	mergeArrayToString(data: any[], handleFunc?: (val: any) => any): string;
-	mergeArrayToString(data: any[], handleFunc?: (val: any) => any): string {
+	mergeArrayToString<T extends any>(
+		data: T[],
+		handleFunc?: ((val: T) => T) | keyof T
+	): string;
+	mergeArrayToString<T extends any>(
+		data: T[],
+		handleFunc?: ((val: T) => T) | keyof T
+	): string {
 		if (!(data instanceof Array)) {
 			throw new Error("Utils.mergeArrayToString 参数 data 必须为 Array 类型");
 		}
@@ -2423,7 +2463,7 @@ class Utils {
 			});
 		} else {
 			data.forEach((item) => {
-				Object.values(item)
+				Object.values(item as any)
 					.filter((item2) => typeof item2 === "string")
 					.forEach((item3) => {
 						content += item3;
@@ -2880,7 +2920,10 @@ class Utils {
 	 * Utils.parseInt(["aaaaaaa"],"aa");
 	 * > NaN
 	 **/
-	parseInt(matchList?: any[], defaultValue?: number): number;
+	parseInt(
+		matchList?: any[] | null | undefined | RegExpMatchArray,
+		defaultValue?: number
+	): number;
 	parseInt(matchList: any[] = [], defaultValue = 0): number {
 		if (matchList == null) {
 			return parseInt(defaultValue.toString());