@bettergi/utils 0.1.7 → 0.1.8

package/README.md

@@ -174,6 +174,20 @@ const d1 = getNextDay4AM();
 const d2 = getNextMonday4AM();
 ```
 
+### 异常
+
+```ts
+// 重复执行某个可能失败的异步操作，但是发生主机异常（如任务取消）时停止
+for (let i = 0; i < 1000; i++) {
+  try {
+    await sleep(i);
+  } catch (err: any) {
+    if (isHostException(err)) throw err;
+    log.info(`第 ${i} 次运行失败，错误信息：${err.message}`);
+  }
+}
+```
+
 ### 杂项
 
 ```ts

package/dist/exception.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 判断是否为主机异常
+ * @param err 异常对象
+ */
+export declare const isHostException: (err: any) => boolean;
+/**
+ * 判断是否为任务取消异常
+ * @param err 异常对象
+ */
+export declare const isTaskCanceledException: (err: any) => any;

package/dist/exception.js

@@ -0,0 +1,16 @@
+/**
+ * 判断是否为主机异常
+ * @param err 异常对象
+ */
+export const isHostException = (err) => {
+    return typeof err === "object" && Object.prototype.hasOwnProperty.call(err, "hostException");
+};
+/**
+ * 判断是否为任务取消异常
+ * @param err 异常对象
+ */
+export const isTaskCanceledException = (err) => {
+    return (isHostException(err) &&
+        typeof err?.message === "string" &&
+        err.message.includes("task was canceled"));
+};

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 /** 断言 */
 export * from "./asserts";
+/** 异常 */
+export * from "./exception";
 /** 文件操作 */
 export * from "./file";
 /** 游戏操作 */

package/dist/index.js

@@ -1,5 +1,7 @@
 /** 断言 */
 export * from "./asserts";
+/** 异常 */
+export * from "./exception";
 /** 文件操作 */
 export * from "./file";
 /** 游戏操作 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/utils",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "开发 BetterGI 脚本常用工具集",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",