SuperAPI AI 工具集

javascript-pragmatic-rules

编程与开发

查看项目

更新于 10-16 00:21

技能介绍

用途:为生产环境的 JavaScript 代码提供约 30 条经过实践检验的编写原则,覆盖异步操作、V8 优化、内存管理、测试、错误处理与性能;对包括 Web Components 在内的所有 JavaScript 代码均适用。与 web-components-architecture 技能配合时,本技能负责“如何正确写 JavaScript”(异步模式、错误处理、性能优化、测试策略),后者负责“组件用什么模式”(生命周期、Shadow DOM 封装、属性驱动状态、HandleEvent 模式)。例如自定义 <data-table> 组件可用后者确定结构,用本技能规则做清理、内存泄漏预防和异步取数超时。

主要能力(按规则分组):异步操作与 Promise(规则 1-4):显式处理 Promise 拒绝、为异步操作加超时(AbortController)、限制并发(批处理、Promise 池、令牌桶限流)、清理定时器与监听器。对象设计与不可变性(规则 4a-6):预先初始化所有属性以避免 V8 隐藏类形状转换、优先不可变(展开运算、toSorted/toReversed/toSpliced/with、structuredClone)、为取消而设计。错误处理与韧性(规则 7-10):优雅的错误边界、零未捕获异常、全局错误处理器与小型模块接口。性能优化(规则 16-22)、测试策略(规则 12-15)。

使用方式:作为技能加载后按规则指导实际编码;文中给出可复用的代码模式,如 fetchWithTimeout、fetchWithRetry、processInBatches、PromisePool、RateLimiter、CleanupRegistry、Poller、ErrorBoundary 等。

适用场景与限制:适合生产级 JavaScript 与 Web Components 开发;相关技能包括 js-micro-utilities(零依赖工具函数)与 web-components-architecture。资料未提供安装命令、平台要求、收费信息或基准数据。