资讯专栏INFORMATION COLUMN

【译文】Node.js官方文档(Part 1 关于文档)

svtter / 832人阅读

摘要:关于本文档本文档的目的,是全面地解释的,即可作为参考文档,同时也包含了概念的讲解。但有的全新的实验性的,或者存在危险性的部分则会被重新设计。稳定级别锁定只会有安全性能或相关的修复。不接受对此做修改的建议。

关于本文档

本文档的目的,是全面地解释Node.js的API,即可作为参考文档,同时也包含了概念的讲解。每个章节都描述了一个内置模块或一个高阶概念(high-level concept)。

属性类型、函数参数、事件句柄的传参等,都在相应主题的标题下方详细列出。

稳定性标签

贯穿整个文档,你会看到很多“稳定性标签”标注了章节所描述内容的稳定性。Node.js API还处于不断成熟的阶段,有的模块可靠性会高于其他模块。有的经过实践证明,并且被广泛使用的特性会很少变更。但有的全新的、实验性的,或者存在危险性的部分则会被重新设计。

所有的“稳定性标签”如下所示:

稳定级别: 0 - 已废弃

本特性存在问题并将会被修改。请不要使用。使用此特性可能会导致错误告警。不会存在后向兼容。

稳定级别: 1 - 实验性

本特性将会被修改,使用时会在命令行出现提示。在未来版本中可能会被修改或废弃。

稳定级别: 2 - 稳定

此API已被证明符合预期。除非绝对必要的话,将会持续兼容npm生态。

稳定级别: 3 - 锁定

只会有安全、性能或bug相关的修复。不接受对此API做修改的建议。

系统调用&MAN页面

系统调用,比如open和read,定义了用户程序和底层操作系统的交互方式。有的Node函数就是对系统调用的简单封装,如fs.open(),会有一个链接指向相应的man页面(是manual pages的缩写),详细描述此系统调用的原理。

附注:有的系统调用,如lchown,是BSD专用的。比如fs.lchown(),意味着他们只能在Mac OS X和其他基于BSD的系统里才有效。

大部分Unix系统调用都在Windows上有等价,但实现可能有不同。

全文目录

请查看:全文目录

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/86559.html

相关文章

  • 译文Node.js官方文档Part 2 用法与示例)

    摘要:用法具体的参数及脚本运行方式,请参考命令行工具章节。示例用写的一个返回的服务器示例要运行此服务器,将上面所示代码放入文件,并用执行它本文档中所有的示例均可以类似方式运行。全文目录请查看全文目录 用法 node [options] [v8 options] [script.js | -e script] [arguments] 具体的option参数及脚本运行方式,请参考命令行工具章节。...

    tianyu 评论0 收藏0
  • 译文Nodejs官方文档Part 3 断言测试)

    摘要:断言稳定级别锁定断言模块提供了一个简单断言集,用于测试不变量。但是要注意,断言模块并不是一个测试框架,也不是一个通用的断言库。断言模块的已经锁定。版本加入测试深且强不等,与对立。版本加入测试是否为真。 断言 稳定级别:3 - 锁定 断言模块提供了一个简单断言集,用于测试不变量。本模块原本是Node.js的内部使用,但也可以通过require(assert)在应用中使用。但是要注意,断言...

    XFLY 评论0 收藏0
  • 译文Node.js官方文档(前言&目录)

    摘要:毕竟官方文档才是未经提炼的纯技术点,读书不能只读二手书。目前网上能找到的中文文档基本都是基于的,但截至此文发布,最新的稳定版都已经是了。翻译过程中主要参考官方英文文档,以及极客学院的官方文档中文翻译。 前言 相信很多开发者和我一样,在学习一门技术的时候,通过网上的各种教程和视频入门之后会发现自己遇到一个上升瓶颈。造成这个瓶颈的很大一部分原因,我认为是进阶教程的知识点过于分散,同时高质量...

    tinna 评论0 收藏0
  • 2017-07-14 前端日报

    摘要:前端日报精选技术周刊译文四种使用提升应用的方式当我们谈论前端架构时,我们到底在谈论什么是的,来了与之争发布中文译是的,来了掘金第期实践总结个必备的装逼技巧掘金年学习最好的书籍圆形随机分布种事件驱动的架构试用知识总结个人文章 2017-07-14 前端日报 精选 SegmentFault 技术周刊【译文】四种使用webpack提升Vue应用的方式当我们谈论前端架构时,我们到底在谈论什么?...

    lewinlee 评论0 收藏0
  • Angular学习资料

    摘要:目前稳定在,进入了版本状态,谷歌表示会长期进行支持。版本是谷歌开发的一款类型的框架,具有优越的性能和绝佳的跨平台性。于年月正式发布,目前已发布到版本。中文翻译与主站同步的非常及时。 Angular是一款面向企业级应用开发的前端框架,掌握好Angular相关技术,有助于我们提升开发效率,编写高质量的前端代码。 Angular 1.x版本 AngularJS 诞生于2009年,由Misko H...

    james 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<