SuperAPI AI 工具集

1k-error-handling

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:为 OneKey 代码库提供错误处理规范,指导在实现 try/catch、处理异步错误、展示错误消息或管理错误状态时使用。

主要能力与原则:对可能失败的异步操作使用 try/catch;提供合适的错误消息与回退值;需要 loading/error 状态的操作使用 useAsyncCall hook;绝不静默吞掉错误。

用法要点:基础 try/catch 中捕获后记录并可按需重新抛出;需要回退时返回默认值而非抛出;组件中可从 @onekeyhq/kit/src/hooks/useAsyncCall 引入 useAsyncCall,获取 run、isLoading、error、result,并通过 onError 回调弹出 Toast 提示。面向用户的错误应展示友好消息,同时用 console.error 记录详细错误便于调试。

反模式:禁止空 catch 静默忽略错误;UI 中必须处理 loading 与 error 状态,不能只渲染 data。

检查清单:所有异步操作包裹 try/catch;错误被记录;向用户展示友好消息;UI 处理加载与错误状态;无静默吞错;必要时捕获特定错误类型。

相关技能:/1k-coding-patterns、/1k-sentry-analysis。详细模式与示例见 error-handling.md。