@zwa73/utils 1.0.84 → 1.0.86

package/dist/UtilFunctions.d.ts

@@ -104,6 +104,10 @@ export declare class UtilFunc {
      * @returns 处理结果
      */
     static queueProc<T>(flag: Keyable, task: (() => Promise<T>) | Promise<T>): Promise<T>;
+    /**队列获取目标的代办事件数
+     * @param flag - 队列标签
+     */
+    static queueLength(flag: Keyable): number;
     /**创建一个Outcome */
     static outcome<K extends Keyable, V>(key: K, value: V): Outcome<K, V>;
     /**处理联合值
@@ -128,6 +132,11 @@ export declare class UtilFunc {
     static isFailed<T>(tg: T): T extends Matchable<FailedLike> ? true : MatchableFlag<T> extends Exclude<MatchableFlag<T>, FailedLike> ? false : boolean;
     /**是成功的 */
     static isSuccess<T>(tg: T): T extends Matchable<SuccessLike> ? true : MatchableFlag<T> extends Exclude<MatchableFlag<T>, SuccessLike> ? false : boolean;
+    /**类似空值  undefined null None
+     * @param t          - 检测目标
+     * @param strictLog  - 应该严格等于None 否则将输出警告 但任然返回true
+     */
+    static likeNone(t: unknown, strictLog?: boolean): t is None;
     /**验证一个变量的类型是否为 T
      * @template T - 验证类型
      * @param t    - 验证目标

package/dist/UtilFunctions.js

@@ -326,6 +326,13 @@ class UtilFunc {
             tryRes();
         }
     }
+    /**队列获取目标的代办事件数
+     * @param flag - 队列标签
+     */
+    static queueLength(flag) {
+        const pd = this.pendingMap[flag];
+        return pd != null ? pd.length : 0;
+    }
     /**创建一个Outcome */
     static outcome(key, value) {
         return {
@@ -385,6 +392,21 @@ class UtilFunc {
             return test(tg.status);
         return test(tg);
     }
+    /**类似空值  undefined null None
+     * @param t          - 检测目标
+     * @param strictLog  - 应该严格等于None 否则将输出警告 但任然返回true
+     */
+    static likeNone(t, strictLog = true) {
+        if (t === UtilSymbol_1.None)
+            return true;
+        if (t === "null" || t === "undefined" || t === String(UtilSymbol_1.None)) {
+            UtilLogger_1.SLogger.warn(`输入值为字符串类型的空值, 已作为 None 处理`, `具体值: ${t}`);
+            return true;
+        }
+        if (strictLog && t == null)
+            UtilLogger_1.SLogger.warn(`输入值不严格等于 None , 已作为 None 处理`, `具体类型: ${t}`);
+        return t == null;
+    }
     /**验证一个变量的类型是否为 T
      * @template T - 验证类型
      * @param t    - 验证目标

package/dist/UtilInterfaces.d.ts

@@ -19,6 +19,12 @@ export interface IJData {
 export type AnyFunc = (...args: any) => any;
 /**任意可作为键值的类型 */
 export type Keyable = string | number | symbol;
+/**排除可选项目
+ * 将基础类型中与默认选项重合的部分变为可选
+ * @template B - 基础类型
+ * @template D - 默认选项
+ */
+export type PartialOption<B, D> = keyof D extends keyof B ? Omit<B, keyof D> & Partial<Pick<B, keyof D>> : never;
 /**真子集 */
 export type ProperSubset<B, T = B> = T extends B ? B extends T ? never : T : never;
 /**字面量检测 */

package/dist/UtilSymbol.d.ts

@@ -8,6 +8,9 @@ export type Failed = typeof Failed;
 /**不存在 无 */
 export declare const None: unique symbol;
 export type None = typeof None;
+/**未初始化的 用于静态构造函数标记*/
+export declare const Uninited: unique symbol;
+export type Uninited = typeof Uninited;
 /**完成 未经验证/未超时的结果
  * Success扩展
  * 仅在Success同时出现时使用
@@ -31,7 +34,7 @@ export type FailedLike = Failed | Timeout | Terminated;
 /**成功及其拓展 */
 export type SuccessLike = Success | Completed;
 /**任意状态标识符 */
-export type StatusSymbol = FailedLike | SuccessLike | None;
+export type StatusSymbol = FailedLike | SuccessLike | None | Uninited;
 /**结果为 None 的 Outcome */
 export type NoneOut = Outcome<None, None>;
 export declare const NoneOut: NoneOut;

package/dist/UtilSymbol.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NoneOut = exports.Timeout = exports.Terminated = exports.Completed = exports.None = exports.Failed = exports.Success = void 0;
+exports.NoneOut = exports.Timeout = exports.Terminated = exports.Completed = exports.Uninited = exports.None = exports.Failed = exports.Success = void 0;
 /**成功 经过验证的结果 */
 exports.Success = Symbol("Success");
 /**失败 可重试的 */
 exports.Failed = Symbol("Failed");
 /**不存在 无 */
 exports.None = Symbol("None");
+/**未初始化的 用于静态构造函数标记*/
+exports.Uninited = Symbol("Uninited");
 /**完成 未经验证/未超时的结果
  * Success扩展
  * 仅在Success同时出现时使用

package/package.json

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

package/src/UtilFunctions.ts

@@ -384,6 +384,13 @@ static async queueProc<T>(flag:Keyable,task:(()=>Promise<T>)|Promise<T>):Promise
         tryRes();
     }
 }
+/**队列获取目标的代办事件数  
+ * @param flag - 队列标签
+ */
+static queueLength(flag:Keyable){
+    const pd = this.pendingMap[flag]
+    return pd!=null ? pd.length : 0;
+}
 
 
 
@@ -468,6 +475,21 @@ static isSuccess<T>
     return test(tg) as any
 }
 
+/**类似空值  undefined null None
+ * @param t          - 检测目标
+ * @param strictLog  - 应该严格等于None 否则将输出警告 但任然返回true
+ */
+static likeNone(t:unknown,strictLog=true):t is None{
+    if(t===None) return true;
+    if(t==="null" || t === "undefined" || t === String(None)){
+        SLogger.warn(`输入值为字符串类型的空值, 已作为 None 处理`,`具体值: ${t}`);
+        return true;
+    }
+    if(strictLog && t == null)
+        SLogger.warn(`输入值不严格等于 None , 已作为 None 处理`,`具体类型: ${t}`);
+    return t == null;
+}
+
 /**验证一个变量的类型是否为 T
  * @template T - 验证类型
  * @param t    - 验证目标

package/src/UtilInterfaces.ts

@@ -23,6 +23,15 @@ export type AnyFunc = (...args:any)=>any;
 /**任意可作为键值的类型 */
 export type Keyable = string | number | symbol;
 
+/**排除可选项目  
+ * 将基础类型中与默认选项重合的部分变为可选  
+ * @template B - 基础类型
+ * @template D - 默认选项
+ */
+export type PartialOption<B,D> = keyof D extends keyof B
+    ? Omit<B,keyof D> & Partial<Pick<B,keyof D>>
+    : never;
+
 /**真子集 */
 export type ProperSubset<B, T = B> = T extends B ? B extends T ? never : T : never;
 

package/src/UtilSymbol.ts

@@ -10,6 +10,9 @@ export type Failed = typeof Failed;
 /**不存在 无 */
 export const None = Symbol("None");
 export type None = typeof None;
+/**未初始化的 用于静态构造函数标记*/
+export const Uninited = Symbol("Uninited");
+export type Uninited = typeof Uninited;
 /**完成 未经验证/未超时的结果  
  * Success扩展  
  * 仅在Success同时出现时使用
@@ -33,7 +36,7 @@ export type FailedLike = Failed|Timeout|Terminated;
 /**成功及其拓展 */
 export type SuccessLike = Success|Completed;
 /**任意状态标识符 */
-export type StatusSymbol = FailedLike|SuccessLike|None;
+export type StatusSymbol = FailedLike|SuccessLike|None|Uninited;
 /**结果为 None 的 Outcome */
 export type NoneOut = Outcome<None,None>;
 export const NoneOut = {