@ceale/util 1.17.0 → 1.18.1

package/README.md

@@ -48,6 +48,7 @@
     - Enum()
     - EnumKeys<>
     - `type` anyobject
+    - `type` AnyClass
 - Object.prototype
     - hasKeys()
     - inKeys()

package/dist/cjs/index.js

@@ -414,19 +414,21 @@ var CubicBezier = class {
 };
 
 // src/error.ts
-var tryCatch = (parameter) => {
-  if (typeof parameter === "object") {
-    return parameter.then((data) => Object.assign([data, null], { data, error: null })).catch((error) => Object.assign([null, error], { data: null, error }));
-  }
-  if (typeof parameter === "function") {
+var tryCatch = (func, catchClass) => {
+  if (typeof func === "function") {
     try {
-      const data = parameter();
+      const data = func();
       return Object.assign([data, null], { data, error: null });
     } catch (error) {
-      return Object.assign([null, error], { data: null, error });
+      if (!catchClass || error instanceof catchClass) return Object.assign([null, error], { data: null, error });
+      throw error;
     }
+  } else {
+    return func.then((data) => Object.assign([data, null], { data, error: null })).catch((error) => {
+      if (!catchClass || error instanceof catchClass) return Object.assign([null, error], { data: null, error });
+      throw error;
+    });
   }
-  throw new TypeError("\u53C2\u6570\u7C7B\u578B\u9519\u8BEF\uFF0C\u5E94\u4E3A Promise \u6216\u51FD\u6570");
 };
 
 // src/type.ts

package/dist/esm/index.js

@@ -372,19 +372,21 @@ var CubicBezier = class {
 };
 
 // src/error.ts
-var tryCatch = (parameter) => {
-  if (typeof parameter === "object") {
-    return parameter.then((data) => Object.assign([data, null], { data, error: null })).catch((error) => Object.assign([null, error], { data: null, error }));
-  }
-  if (typeof parameter === "function") {
+var tryCatch = (func, catchClass) => {
+  if (typeof func === "function") {
     try {
-      const data = parameter();
+      const data = func();
       return Object.assign([data, null], { data, error: null });
     } catch (error) {
-      return Object.assign([null, error], { data: null, error });
+      if (!catchClass || error instanceof catchClass) return Object.assign([null, error], { data: null, error });
+      throw error;
     }
+  } else {
+    return func.then((data) => Object.assign([data, null], { data, error: null })).catch((error) => {
+      if (!catchClass || error instanceof catchClass) return Object.assign([null, error], { data: null, error });
+      throw error;
+    });
   }
-  throw new TypeError("\u53C2\u6570\u7C7B\u578B\u9519\u8BEF\uFF0C\u5E94\u4E3A Promise \u6216\u51FD\u6570");
 };
 
 // src/type.ts

package/dist/types/class.d.ts

@@ -1,4 +1,4 @@
-type AnyClass = new (...args: any[]) => any;
+import type { AnyClass } from "./type";
 declare global {
     interface Function {
         /**

package/dist/types/error.d.ts

@@ -1,3 +1,4 @@
+import type { AnyClass } from "./type";
 type Success<T> = {
     data: T;
     error: null;
@@ -12,28 +13,39 @@ type Failure<E> = {
     data: null,
     error: E
 ];
-type Result<T, E extends unknown = Error> = Success<T> | Failure<E>;
+type Result<T, E = any> = Success<T> | Failure<E>;
 interface tryCatch {
-    <T>(arg: Promise<T>): Promise<Result<T>>;
-    <V>(arg: (() => V)): Result<V>;
+    /** 捕获所有 */
+    <T>(func: (() => T)): Result<T>;
+    <T>(asyncFunc: Promise<T>): Promise<Result<T>>;
+    /** 捕获指定 */
+    <T, E extends AnyClass>(func: (() => T), catchClass: E): Result<T, InstanceType<E>>;
+    <T, E extends AnyClass>(func: Promise<T>, catchClass: E): Promise<Result<T, InstanceType<E>>>;
 }
 /**
- * 尝试执行一个函数或Promise，返回一个包含执行结果或错误信息的复合对象
+ * 尝试执行一个函数或Promise，返回一个对象，其中包含执行结果或被捕获的错误
  *
  * 该对象同时支持对象属性访问(.data/.error)和数组索引访问([0]/[1])两种方式
  *
- * @param parameter 一个函数或者Promise对象
- * @returns 返回参数中，data和[0]是函数的返回值或是Promise的解析结果，error和[1]是错误对象。两者将有一为`null`
+ * @param func 一个函数或者Promise对象
+ * @param catchClass 要捕获的错误类型（含子类），如果不指定，则捕获所有错误；如指定，则为被捕获的错误将继续上抛
+ * @returns 返回一个如后方例的对象`{ data, error } & [ data, error ]`
  *
  * @example
  * tryCatch(() => func(...))
  * // => [data, error] & {data, error}
  * // data: func的返回值，error：函数执行过程中发生的错误
  *
+ *
+ * @example
+ * tryCatch(() => func(...), TypeError)
+ * // => [data, error] & {data, error}
+ * // data: func的返回值，error：函数执行过程中，发生的TypeError或其子类错误
+ *
  * @example
  * await tryCatch(asyncFunc(...))
  * // => [data, error] & {data, error}
- * // data: asyncFunc的返回值，error：asyncFunc执行过程中发生的错误
+ * // data: 异步函数asyncFunc的返回值，error：asyncFunc执行过程中发生的错误
  */
 export declare const tryCatch: tryCatch;
 export {};

package/dist/types/type.d.ts

@@ -1,3 +1,13 @@
+/**
+ * 一种介于 `any` 与 `object` 之间的类型
+ * - 与 `any` 类似，可以任意访问属性
+ * - 与 `object` 类似，排除了原始类型
+ */
+export type anyobject = Record<any, any>;
+/**
+ * 表示任意的类或构造函数
+ */
+export type AnyClass = new (...args: any[]) => any;
 /**
  * 就地断言一个变量为指定类型
  * @template Type 断言的类型，默认为`any`
@@ -12,12 +22,6 @@ export declare const assert: <Type = any>(variable: any) => asserts variable is
  * @returns 传入的变量，且类型被拓展为指定类型
  */
 export declare const expand: <Type>(variable: any) => asserts variable is (typeof variable & Type);
-/**
- * 一种介于 `any` 与 `object` 之间的类型
- * - 与 `any` 类似，可以任意访问属性
- * - 与 `object` 类似，排除了原始类型
- */
-export type anyobject = Record<any, any>;
 /**
  * 定义一个枚举类型。
  * 返回一个枚举对象，其中每个键名与值相同。

package/dist/types/uri.d.ts

@@ -10,15 +10,16 @@ export declare namespace uri {
      *
      * @example
      * // 基础拼接
-     * uri.join('/a/', 'b', '/c') // -> "/a/b/c"
+     * uri.join('/a/', 'b', '/c')
+     * // "/a/b/c"
      *
-     * @example
      * // 路径解析
-     * uri.join('/a/b/../c') // -> "/a/c"
+     * uri.join('/a/b/../c')
+     * // "/a/c"
      *
-     * @example
      * // 保留协议头
-     * uri.join("http://example.com", "a") // -> "http://example.com/a"
+     * uri.join("http://example.com", "a")
+     * // "http://example.com/a"
      */
     const join: (...path: string[]) => string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ceale/util",
-  "version": "1.17.0",
+  "version": "1.18.1",
   "author": "Ceale",
   "description": "小工具集",
   "repository": {