用途:用于编写与审查 JavaScript 代码,核心纪律是让失败尽早、尽响地暴露,因为 JavaScript 的典型故障是“继续运行”——类型不匹配被强制转换、缺失属性变成 undefined、无人处理的 rejected promise 只留一条警告。
主要能力与规则要点:
- 取向:优先选择拒绝式构造而非转换式构造,如 === 优于 ==、?? 优于 ||;以项目声明的引擎基线(engines、browserslist、tsconfig 的 target/lib、.nvmrc、CI 矩阵)决定可写语法,而非按 ECMAScript 版号;优先使用内建全局对象,如 Intl、URL、structuredClone、AbortController 及迭代器辅助方法。
- 语法基线:资料按 ES2020 至 ES2026 列出各版本新增特性,并指出版号不等于可用性,需按特性核对;Stage 4 未批准特性(using/await using、Temporal、Iterator.zip)在 Safari 26.x 不可用;装饰器为 Stage 2.7,无引擎实现。
- 命名与声明:一个概念一个词;禁止 var;const 只冻结绑定不冻结值;一条语句一个声明。
- 相等与转换:始终 ===/!==,仅 == null 例外;用 Number.isNaN;整串转换用 Number;金额不用双精度浮点;Object.is 仅用于 NaN 和 -0。
- 函数与对象:回调用箭头函数,对象方法不用;展开优于 Object.assign;深拷贝用 structuredClone;用 Object.hasOwn。
- 数组与迭代:副作用用 for...of,转换用数组方法;排序必须传比较器;Map 用于非字符串键等;用户可见文本用 Intl.Collator,字符计数用 Intl.Segmenter。
- 类:私有字段用 #,不从构造函数调用可覆写方法,组合优于继承。
- 异步:每个 promise 都被 await 或有处理器;独立工作用 Promise.all 并发;按失败模式选组合器;用 AbortController 做取消;仅在包装回调 API 时用 new Promise。
- 模块:import 是只读活绑定;优先具名导出;相对路径带扩展名;避免桶文件;JSON 导入需 import attributes。
- 错误:只处理一次;用 cause 附加上下文;按错误类而非消息文本匹配;可用的引擎基线用 Error.isError。
- 正则:不要跨调用共享 g 或 y 正则,因 lastIndex 会保留。
使用方式:作为技能规则集用于编码与评审,并在书写接近引擎基线的特性或提升基线时,读取对应版本参考文件与约定文件(coercion、iteration、classes、async、modules 等)。
限制:资料为规则与约定描述,未提供安装命令、代码示例细节、价格或平台支持信息;具体项目的可用特性仍须按其引擎基线与运行环境核对。