SuperAPI AI 工具集

error-handling

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:修复 TypeScript/JavaScript 中不规范的错误处理,重点针对三类问题:浮动 Promise(未 await 或未处理返回的 Promise)、静默 catch 块、抛出非 Error 对象。按优先级:浮动 Promise 为 P0,会在未处理拒绝时使 Node.js 崩溃;静默 catch 与抛出非 Error 均为 P1,前者隐藏缺陷、难以调试,后者丢失堆栈并破坏错误处理。

主要能力:检测并给出修复策略。浮动 Promise 可用 @typescript-eslint/no-floating-promises 检测,修复方式包括顶层 main() 配 .catch 的启动序列,或对有意忽略的调用加 void 与 .catch。静默 catch 应记录上下文后优雅处理,模板会输出错误消息、堆栈与业务上下文。抛出非 Error 应改用 Error 对象或自定义错误类,如 ValidationError、NotFoundError、AuthenticationError,并支持基于 instanceof 的判断。还提供两种模式:Result 类型与错误边界包装函数。

使用方式:按“识别问题类型—判断应大声失败还是优雅失败—套用修复模式—验证错误路径有测试”的流程进行。脚本命令:node scripts/detect-error-issues.js /path/to/src 用于检测;node scripts/fix-floating-promises.js /path/to/file.ts 用于半自动为浮动 Promise 添加 void 前缀与 .catch 处理器。

适用场景:需要保证启动流程可靠、避免未处理拒绝崩溃的 Node.js 服务,以及需要保留堆栈、便于调试与测试错误分支的代码库。

限制:文中未提供该技能的版本、许可证、安装方式、依赖要求、收费与作者支持等信息,暂未提供。