稳定性指标
【Stability index】
在整个文档中都有关于各部分稳定性的说明。有些 API 已经经过充分验证并被广泛依赖,几乎不可能再发生任何改变。另一些则是全新且实验性的,或者已知存在风险。
【Throughout the documentation are indications of a section's stability. Some APIs are so proven and so relied upon that they are unlikely to ever change at all. Others are brand new and experimental, or known to be hazardous.】
稳定性指数如下:
【The stability indices are as follows:】
如果某些功能的使用没有造成伤害,并且在 npm 生态系统中被广泛依赖,它们会被标记为遗留功能,而不是被弃用。在遗留功能中发现的错误不太可能被修复。
【Features are marked as legacy rather than being deprecated if their use does no harm, and they are widely relied upon within the npm ecosystem. Bugs found in legacy features are unlikely to be fixed.】
在使用实验性功能时请谨慎,尤其是在模块中。用户可能不知道正在使用实验性功能。当实验性 API 发生修改时,错误或行为变化可能会让用户感到意外。为了避免意外,使用实验性功能可能需要命令行标志。实验性功能也可能会发出 警告。
【Use caution when making use of Experimental features, particularly within modules. Users may not be aware that experimental features are being used. Bugs or behavior changes may surprise users when Experimental API modifications occur. To avoid surprises, use of an Experimental feature may need a command-line flag. Experimental features may also emit a warning.】