feat: manually mirror opencoze's code from bytedance

Change-Id: I09a73aadda978ad9511264a756b2ce51f5761adf
This commit is contained in:
fanlv
2025-07-20 17:36:12 +08:00
commit 890153324f
14811 changed files with 1923430 additions and 0 deletions

View File

@@ -0,0 +1,37 @@
# @coze-arch/bot-error 使用文档
## 安装
```
cd ${path/to/project}
rush add @coze-arch/bot-error
```
## 使用
提供了一些用于错误处理的工具。
### CustomError
CustomError 是一个自定义错误类用来代替原生的Error使用 throw new CustomerError抛出的错误会上报到slardar的自定义事件中使用方可以根据需要进行监控处理不会统计到jsError
```
import { CustomError } from '@coze-arch/bot-error';
throw new CustomError('parmasValidation', 'empty copy');
```
### isCustomError
isCustomError 是一个函数,它可以检查一个错误是否是 CustomError
```
import { isCustomError, CustomError } from '@coze-arch/bot-error';
const myError = new CustomError('parmasValidation', 'empty copy');
console.log(isCustomError(error)); // 输出true
```
### useErrorCatch
useErrorCatch 是一个 React Hook它可以帮助你在组件中捕获和处理错误。
1. 监听全局 unhandledrejection、error 事件,上报相关内容由业务侧自行补充
2. 对于已知错误,上报自定义事件进行监控