Node.js v10.12.0 文档


关于本文档#

查看英文版参与翻译

本文档的目的是为了全面地讲解 Node.js 的 API,包括使用方法与相关概念。 每个章节分别介绍一个内置模块或高级概念。

每个主题的标题下会列出属性的类型、方法的参数、以及事件处理回调函数的参数等。

参与翻译#

查看英文版参与翻译

如果在文档中发现错误,欢迎提交问题

稳定性指数#

查看英文版参与翻译

文档中每个章节都有稳定性标志。 Node.js 的 API 仍会有少量变化,但随着发展,API 会越来越稳定可靠。 有些 API 久经验证、且被大量依赖,它们几乎不会再变化。 也有些 API 是新增的、或试验的、或被认定为有风险且正在被重新设计中的。

稳定性指数如下:

稳定性: 0 - 废弃的 该特性被认定为存在问题,且可能会计划修改。 不要依赖该特性。 使用该特性可能会产生警告信息。 该特性不会做向后兼容。

稳定性: 1 - 试验的 该特性仍处于开发中,且未来改变时不做向后兼容,甚至可能被移除。 不建议在生产环境中使用该特性。 试验的特性不受制于 Node.js 的语义版本模型。

稳定性: 2 - 稳定的 该特性已被证明是符合要求的。 与 npm 生态系统的兼容性是最高优先级,除非有必要否则不会变化。

JSON 输出#

查看英文版参与翻译

稳定性: 1 - 试验的

该特性是试验的,用于 IDE 或其他希望利用本文档做程序化工作的工具。

系统调用与帮助文档#

查看英文版参与翻译

系统调用(例如 open(2)read(2))定义了用户程序和底层操作系统之间的接口。 Node.js 函数只是简单地封装了系统调用,例如 fs.open()。 相应的帮助文档会描述系统调用是如何工作的。

有些系统调用(例如 lchown(2))是 BSD 系统特有的。 这意味着 [fs.lchown()] 只适用于 macOS 和其他 BSD 衍生系统,在 Linux 上不可用。

大部分 Unix 系统调用都有对应的 Windows 版本,但 Windows 版本运行起来可能与 Linux 和 macOS 的有些差异。 有些 Unix 系统调用无法在 Windows 中找到对应的操作语义,详见问题4760