@ceale/util 1.12.0 → 1.12.2

package/dist/cjs/index.js

@@ -32,6 +32,7 @@ __export(exports_src, {
   waitSync: () => waitSync,
   wait: () => wait,
   uri: () => uri,
+  tryCatch: () => tryCatch,
   throttle: () => throttle,
   sleepAsync: () => sleepAsync,
   sleep: () => sleep,
@@ -409,3 +410,18 @@ class CubicBezier {
     }
   }
 }
+// src/error.ts
+var tryCatch = (parameter) => {
+  if (parameter instanceof Promise) {
+    return parameter.then((data) => Object.assign([data, null], { data, error: null })).catch((error) => Object.assign([null, error], { data: null, error }));
+  }
+  if (typeof parameter === "function") {
+    try {
+      const data = parameter();
+      return Object.assign([data, null], { data, error: null });
+    } catch (error) {
+      return Object.assign([null, error], { data: null, error });
+    }
+  }
+  throw new TypeError("参数类型错误，应为 Promise 或函数");
+};

package/dist/esm/index.js

@@ -363,10 +363,26 @@ class CubicBezier {
     }
   }
 }
+// src/error.ts
+var tryCatch = (parameter) => {
+  if (parameter instanceof Promise) {
+    return parameter.then((data) => Object.assign([data, null], { data, error: null })).catch((error) => Object.assign([null, error], { data: null, error }));
+  }
+  if (typeof parameter === "function") {
+    try {
+      const data = parameter();
+      return Object.assign([data, null], { data, error: null });
+    } catch (error) {
+      return Object.assign([null, error], { data: null, error });
+    }
+  }
+  throw new TypeError("参数类型错误，应为 Promise 或函数");
+};
 export {
   waitSync,
   wait,
   uri,
+  tryCatch,
   throttle,
   sleepAsync,
   sleep,

package/dist/types/error.d.ts

@@ -1 +1,39 @@
+type Success<T> = {
+    data: T;
+    error: null;
+} & [
+    data: T,
+    error: null
+];
+type Failure<E> = {
+    data: null;
+    error: E;
+} & [
+    data: null,
+    error: E
+];
+type Result<T, E extends unknown = Error> = Success<T> | Failure<E>;
+interface tryCatch {
+    <T>(arg: Promise<T>): Promise<Result<T>>;
+    <V>(arg: (() => V)): Result<V>;
+}
+/**
+ * 尝试执行一个函数或Promise，返回一个包含执行结果或错误信息的复合对象
+ *
+ * 该对象同时支持对象属性访问(.data/.error)和数组索引访问([0]/[1])两种方式
+ *
+ * @param parameter 一个函数或者Promise对象
+ * @returns 返回参数中，data和[0]是函数的返回值或是Promise的解析结果，error和[1]是错误对象。两者将有一为`null`
+ *
+ * @example
+ * tryCatch(() => func(...))
+ * // => [data, error] & {data, error}
+ * // data: func的返回值，error：函数执行过程中发生的错误
+ *
+ * @example
+ * await tryCatch(asyncFunc(...))
+ * // => [data, error] & {data, error}
+ * // data: asyncFunc的返回值，error：asyncFunc执行过程中发生的错误
+ */
+export declare const tryCatch: tryCatch;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ceale/util",
   "author": "Ceale",
-  "version": "1.12.0",
+  "version": "1.12.2",
   "module": "index.ts",
   "type": "module",
   "main": "dist/esm/index.js",