@zwa73/utils 1.0.162 → 1.0.164

package/dist/UtilFileTools.d.ts

@@ -36,6 +36,8 @@ type LoadJsonFileOpt<T> = Partial<{
 type WriteJsonFileOpt = Partial<{
     /**使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误 */
     compress: boolean;
+    /**紧凑风格 压缩阈值 默认100 */
+    compressThreshold: number;
     /**不自动修改扩展名为json */
     forceExt: boolean;
 }>;
@@ -118,8 +120,9 @@ export declare namespace UtilFT {
      * @param filePath - 文件路径
      * @param token    - 所要写入的JToken
      * @param opt      - 可选参数
-     * @param opt.compress - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
-     * @param opt.forceExt - 不自动修改扩展名为json
+     * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+     * @param opt.forceExt          - 不自动修改扩展名为json
+     * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
      */
     function writeJSONFile(filePath: string, token: JToken, opt?: WriteJsonFileOpt): Promise<void>;
     /**保证路径为某个风格

package/dist/UtilFileTools.js

@@ -181,8 +181,9 @@ var UtilFT;
      * @param filePath - 文件路径
      * @param token    - 所要写入的JToken
      * @param opt      - 可选参数
-     * @param opt.compress - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
-     * @param opt.forceExt - 不自动修改扩展名为json
+     * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+     * @param opt.forceExt          - 不自动修改扩展名为json
+     * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
      */
     async function writeJSONFile(filePath, token, opt) {
         const str = UtilFunctions_1.UtilFunc.stringifyJToken(token, opt);

package/dist/UtilFunctions.d.ts

@@ -14,6 +14,8 @@ type ExecOpt = Partial<{
 type StringifyOpt = Partial<{
     /**使用紧凑风格 将会用/@@@.+@@@/作为特殊标记, 原始文本内若出现相同格式将会产生错误 */
     compress: boolean;
+    /**紧凑风格 压缩阈值 默认100 */
+    compressThreshold: number;
     /**插入的空格 数字为空格数量 默认为制表符\t */
     space: string | number | null | undefined;
 }>;
@@ -30,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 {
     /**获取当前时间戳
@@ -131,11 +139,17 @@ 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   - 可选参数
-     * @param opt.space     - 插入的空格 数字为空格数量 默认为制表符\t
-     * @param opt.compress  - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+     * @param opt.space             - 插入的空格 数字为空格数量 默认为制表符\t
+     * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+     * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
      * @returns 转换完成的字符串
      */
     static stringifyJToken(token: JToken | IJData, opt?: StringifyOpt): string;

package/dist/UtilFunctions.js

@@ -378,18 +378,43 @@ 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   - 可选参数
-     * @param opt.space     - 插入的空格 数字为空格数量 默认为制表符\t
-     * @param opt.compress  - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+     * @param opt.space             - 插入的空格 数字为空格数量 默认为制表符\t
+     * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+     * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
      * @returns 转换完成的字符串
      */
     static stringifyJToken(token, opt) {
         opt ??= {};
-        let { compress, space } = opt;
+        let { compress, space, compressThreshold } = opt;
         space ??= "\t";
         space = space === null ? undefined : space;
+        compressThreshold ??= 100;
         if (!compress)
             return JSON.stringify(token, null, space);
         const ec = '\uF121\uF122\uF123';
@@ -400,7 +425,7 @@ class UtilFunc {
             const str = JSON.stringify(value);
             if (typeof str != 'string')
                 return value;
-            if (str.length <= 100)
+            if (str.length <= compressThreshold)
                 return `${ec}${str}${ec}`;
             return value;
         };

package/package.json

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

package/src/UtilFileTools.ts

@@ -48,6 +48,8 @@ type LoadJsonFileOpt<T> = Partial<{
 type WriteJsonFileOpt = Partial<{
     /**使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误 */
     compress:boolean;
+    /**紧凑风格 压缩阈值 默认100 */
+    compressThreshold:number;
     /**不自动修改扩展名为json */
     forceExt:boolean;
 }>
@@ -234,8 +236,9 @@ export async function loadJSONFile<T extends JToken>(filePath: string,opt?:LoadJ
  * @param filePath - 文件路径
  * @param token    - 所要写入的JToken
  * @param opt      - 可选参数
- * @param opt.compress - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
- * @param opt.forceExt - 不自动修改扩展名为json
+ * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+ * @param opt.forceExt          - 不自动修改扩展名为json
+ * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
  */
 export async function writeJSONFile(
     filePath: string,

package/src/UtilFunctions.ts

@@ -24,6 +24,8 @@ type ExecOpt = Partial<{
 type StringifyOpt = Partial<{
     /**使用紧凑风格 将会用/@@@.+@@@/作为特殊标记, 原始文本内若出现相同格式将会产生错误 */
     compress:boolean;
+    /**紧凑风格 压缩阈值 默认100 */
+    compressThreshold:number;
     /**插入的空格 数字为空格数量 默认为制表符\t */
     space:string|number|null|undefined;
 }>
@@ -53,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{
 /**获取当前时间戳  
@@ -444,18 +454,43 @@ 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   - 可选参数
- * @param opt.space     - 插入的空格 数字为空格数量 默认为制表符\t
- * @param opt.compress  - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+ * @param opt.space             - 插入的空格 数字为空格数量 默认为制表符\t
+ * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
+ * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
  * @returns 转换完成的字符串
  */
 static stringifyJToken(token:JToken|IJData,opt?:StringifyOpt){
     opt ??= {};
-    let {compress,space} = opt;
+    let {compress,space,compressThreshold} = opt;
     space ??="\t";
     space = space===null ? undefined : space;
+    compressThreshold ??= 100;
 
     if(!compress) return JSON.stringify(token,null,space);
 
@@ -468,7 +503,7 @@ static stringifyJToken(token:JToken|IJData,opt?:StringifyOpt){
             return `${ec}${JSON.stringify(value)}${ec}`;
         const str = JSON.stringify(value);
         if(typeof str!='string') return value;
-        if(str.length<=100) return `${ec}${str}${ec}`;
+        if(str.length<=compressThreshold) return `${ec}${str}${ec}`;
         return value;
     }