@zwa73/utils 1.0.163 → 1.0.164

package/dist/UtilFunctions.d.ts

@@ -32,6 +32,12 @@ export type RepeatPromiseOpt = Partial<{
 }>;
 type SuccessOut<T> = Outcome<Success, T>;
 type TimeoutOut<T> = Outcome<Timeout, Promise<T>>;
+/**遍历对象的回调函数
+ * @param key       - 字段名
+ * @param value     - 字段值
+ * @param parent    - 父对象
+ */
+type EachFieldCallback = (key: string, value: JToken, parent: JObject) => void;
 /**常用函数 */
 export declare class UtilFunc {
     /**获取当前时间戳
@@ -133,6 +139,11 @@ export declare class UtilFunc {
      * @returns         - 一个新的对象，它的属性是原对象的属性经过映射函数处理后的结果
      */
     static mapEntries<T extends AnyRecord>(obj: T, mapper: (key: keyof T, value: T[keyof T]) => T[keyof T]): T;
+    /** 遍历对象的所有字段
+     * @param obj       - 对象
+     * @param callback  - 回调函数
+     */
+    static eachField(obj: JToken, callback: EachFieldCallback): void;
     /**将JToken转换为字符串
      * @param token - 待转换的Token
      * @param opt   - 可选参数

package/dist/UtilFunctions.js

@@ -378,6 +378,29 @@ class UtilFunc {
             return result;
         }, {});
     }
+    /** 遍历对象的所有字段
+     * @param obj       - 对象
+     * @param callback  - 回调函数
+     */
+    static eachField(obj, callback) {
+        if (obj == null)
+            return;
+        if (typeof obj === 'object' && 'toJSON' in obj && typeof obj.toJSON == 'function') {
+            UtilLogger_1.SLogger.warn('UtilFunc.eachField 错误 无法遍历IJData 已跳过');
+            return;
+        }
+        if (Array.isArray(obj)) {
+            for (const item of obj)
+                UtilFunc.eachField(item, callback);
+            return;
+        }
+        if (typeof obj === 'object') {
+            for (const [k, v] of Object.entries(obj)) {
+                UtilFunc.eachField(v, callback);
+                callback(k, v, obj);
+            }
+        }
+    }
     /**将JToken转换为字符串
      * @param token - 待转换的Token
      * @param opt   - 可选参数

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zwa73/utils",
-	"version": "1.0.163",
+	"version": "1.0.164",
 	"description": "my utils",
 	"main": "index.js",
 	"scripts": {

package/src/UtilFunctions.ts

@@ -55,6 +55,14 @@ type PromiseResult<T> = {
     /**请求下标/序号 */
     index:number;
 };
+
+/**遍历对象的回调函数
+ * @param key       - 字段名
+ * @param value     - 字段值
+ * @param parent    - 父对象
+ */
+type EachFieldCallback = (key: string, value: JToken,parent: JObject) => void;
+
 /**常用函数 */
 export class UtilFunc{
 /**获取当前时间戳  
@@ -446,6 +454,29 @@ static mapEntries<T extends AnyRecord>
     }, {} as T);
 }
 
+/** 遍历对象的所有字段
+ * @param obj       - 对象
+ * @param callback  - 回调函数
+ */
+static eachField(obj: JToken, callback: EachFieldCallback): void {
+    if(obj==null) return;
+    if(typeof obj === 'object' && 'toJSON' in obj && typeof obj.toJSON == 'function'){
+        SLogger.warn('UtilFunc.eachField 错误 无法遍历IJData 已跳过');
+        return;
+    }
+    if(Array.isArray(obj)){
+        for (const item of obj)
+            UtilFunc.eachField(item, callback);
+        return;
+    }
+    if (typeof obj === 'object') {
+        for (const [k, v] of Object.entries(obj)) {
+            UtilFunc.eachField(v, callback);
+            callback(k, v, obj as JObject);
+        }
+    }
+}
+
 /**将JToken转换为字符串
  * @param token - 待转换的Token
  * @param opt   - 可选参数