在整个文档中,你可能会看到某个部分的稳定性提示。Node.js 的 API 仍然会有一些小的变化,随着它的日益成熟,某些部分会比其他部分更可靠。有一部分接受过严格验证,被大量依赖的 API 几乎是不会改变的。也有一些是新增和实验性的,或已知具有危险性并在重新设计过程中的。
稳定性的指标如下:
稳定度:0 - 已废弃
这是一个存在问题的特性,目前正计划修改。请不要使用该特性,使用此功能可能会导致警告,不要指望该特性能够向后兼容。
稳定度:1 - 试验性
此功能可能会更改,我们会在命令行中进行提示。它可能会在将来版本中更改或删除。
稳定度:2 - 稳定
该 API 已被证明是令人满意的。在 npm 中有着很高的使用率,我们在没有绝对的必要下不会对其修改。
稳定度:3 - 已锁定
我们只接受对其进行的安全性、性能或修复 BUG 的建议。请不要在修改 API 方面给出提案,因为我们会拒绝这类建议。