SuperAPI AI 工具集

1k-error-handling

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:这是 OneKey 代码库的错误处理最佳实践指南,用于规范异步操作、UI 状态与用户提示中的错误处理方式。

主要能力:核心原则包括对可能失败的异步操作使用 try/catch、提供合适的错误信息与回退值、对需要 loading/error 状态的操作使用 useAsyncCall 钩子、绝不静默吞掉错误。文档给出基础 try/catch、带回退值、useAsyncCall 钩子、面向用户的 Toast 错误提示等快速参考示例,并列出反模式:静默吞错、UI 缺少错误状态。

使用方式:异步函数中用 try/catch 包裹,捕获后记录日志并按需重新抛出或返回默认值;组件中可从 @onekeyhq/kit/src/hooks/useAsyncCall 导入 useAsyncCall,解构 run、isLoading、error、result,并通过 onError 回调弹出 Toast.error;表单提交等场景用 Toast.success/Toast.error 展示用户友好信息,同时用 console.error 记录详细错误。

适用场景:OneKey 前端与 React 组件中的网络请求、表单提交、数据加载等异步流程。

限制:资料仅提供模式与示例,未说明具体版本、依赖要求或完整 API 参数;更全面的模式见 error-handling.md,相关技能包括 /1k-coding-patterns 与 /1k-sentry-analysis。