资讯专栏INFORMATION COLUMN

Node.js API参考文档(目录)

stormzhang / 2129人阅读

摘要:参考文档是基于的引擎构建的运行时。关于文档用法和示例断言测试稳定性稳定模块提供了一组简单的断言测试,可用于测试不变量。存在和模式,但建议仅使用模式。类在全局作用域内,因此不太可能需要使用。以下所有示例均可供下载,可用作扩展库的起点。

Node.js v11.5.0 API参考文档

Node.js®是基于Chrome的V8 JavaScript引擎构建的JavaScript运行时。

关于文档

用法和示例

断言测试
稳定性:2 - 稳定

assert模块提供了一组简单的断言测试,可用于测试不变量。

存在strictlegacy模式,但建议仅使用strict模式。

有关使用的相等比较的更多信息,请参阅MDN关于相等比较和相同性的指南。

assert.AssertionError类

strict模式

legacy模式

assert(value[, message])

assert.deepEqual(actual, expected[, message])

assert.deepStrictEqual(actual, expected[, message])

assert.doesNotReject(asyncFn, error)

assert.doesNotThrow(fn, error)

assert.equal(actual, expected[, message])

assert.fail([message])

assert.fail(actual, expected[, message[, operator[, stackStartFn]]]) 弃用

assert.ifError(value)

assert.notDeepEqual(actual, expected[, message])

assert.notDeepStrictEqual(actual, expected[, message])

assert.notEqual(actual, expected[, message])

assert.notStrictEqual(actual, expected[, message])

assert.ok(value[, message])

assert.rejects(asyncFn, error)

assert.strictEqual(actual, expected[, message])

assert.throws(fn, error)

异步钩子
稳定性:1 - 实验

async_hooks模块提供了一个API来注册回调,跟踪Node.js应用程序内部创建的异步资源的生命周期,它可以使用以下方式访问:

const async_hooks = require("async_hooks");

异步资源表示具有关联回调的对象,可以多次调用此回调,例如,net.createServer()中的"connection"事件,或者只是fs.open()中的一次。在调用回调之前,也可以关闭资源,AsyncHook没有明确区分这些不同的情况,但会将它们表示为资源的抽象概念。

如果使用Worker,则每个线程都有一个独立的async_hooks接口,每个线程将使用一组新的异步ID。

Public API

Promise执行跟踪

JavaScript Embedder API

Buffer
稳定性:2 - 稳定

在引入TypedArray之前,JavaScript语言没有用于读取或操作二进制数据流的机制,Buffer类是作为Node.js API的一部分引入的,用于在TCP流、文件系统操作和其他上下文中与八位字节流进行交互。

Buffer类的实例类似于整数数组,但对应于V8堆外部的固定大小的原始内存分配,Buffer的大小在创建时建立,无法更改。

Buffer类在全局作用域内,因此不太可能需要使用require("buffer").Buffer

// Creates a zero-filled Buffer of length 10.
const buf1 = Buffer.alloc(10);

// Creates a Buffer of length 10, filled with 0x1.
const buf2 = Buffer.alloc(10, 1);

// Creates an uninitialized buffer of length 10.
// This is faster than calling Buffer.alloc() but the returned
// Buffer instance might contain old data that needs to be
// overwritten using either fill() or write().
const buf3 = Buffer.allocUnsafe(10);

// Creates a Buffer containing [0x1, 0x2, 0x3].
const buf4 = Buffer.from([1, 2, 3]);

// Creates a Buffer containing UTF-8 bytes [0x74, 0xc3, 0xa9, 0x73, 0x74].
const buf5 = Buffer.from("tést");

// Creates a Buffer containing Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
const buf6 = Buffer.from("tést", "latin1");

Buffer.from(),Buffer.alloc()和Buffer.allocUnsafe()

缓冲区和字符编码

缓冲区和TypedArray

缓冲区和迭代

Buffer类

buffer.INSPECT_MAX_BYTES

buffer.kMaxLength

buffer.transcode(source, fromEnc, toEnc)

SlowBuffer类 弃用

Buffer常量

C++扩展库

Node.js扩展库是动态链接的共享对象,用C++ 编写,可以使用require()函数加载到Node.js中,就像它们是普通的Node.js模块一样使用,它们主要用于提供Node.js中运行的JavaScript与C/C++库之间的接口。

目前,实现扩展库的方法相当复杂,涉及多个组件和API的知识:

V8:Node.js目前用来提供JavaScript实现的C++库,V8提供了创建对象、调用函数等的机制,V8的API大多记录在v8.h头文件(Node.js源代码树中的deps/v8/include/v8.h)中,该文件也可在线获取。

libuv:实现Node.js事件循环的C库,它工作线程和平台的所有异步行为,它还可以作为跨平台的抽象库,为所有主要操作系统提供简单的类似POSIX访问,以及许多常见的系统任务,例如与文件系统、sockets、定时器和系统事件的交互。libuv还提供类似并行线程的线程抽象,可用于驱动需要超越标准事件循环的更复杂的异步扩展库。鼓励扩展库作者考虑如何通过libuv将工作卸载到非阻塞系统操作,工作线程或libuv线程的自定义使用来避免使用I/O或其他时间密集型任务阻止事件循环。

内部Node.js库,Node.js本身导出了扩展库可以使用的许多C++ API - 其中最重要的是node::ObjectWrap类。

Node.js包括许多其他静态链接库,包括OpenSSL,这些其他库位于Node.js源代码树的deps/目录中,Node.js只故意重新导出libuv、OpenSSL、V8和zlib symbols,并且可以通过扩展库在不同的范围内使用,有关其他信息,请参阅链接到Node.js自己的依赖项。

以下所有示例均可供下载,可用作扩展库的起点。

Hello world

Node.js原生抽象

N-API

扩展库示例

C/C++插件 - N-API
稳定性:2 - 稳定

N-API(在字母中发音为N,后跟API)是用于构建原生扩展库的API,它独立于底层JavaScript运行时(前V8),并作为Node.js本身的一部分进行维护,此API将是跨Node.js版本的应用程序二进制接口(ABI)稳定版,它旨在将扩展库与底层JavaScript引擎中的更改隔离开来,并允许为一个主要版本编译的模块在Node.js的后续主要版本上运行而无需重新编译,ABI稳定性指南提供了更深入的解释。

使用与C++扩展库一节中概述的相同方法/工具构建/打包扩展库,唯一的区别是原生代码使用的API集,不使用V8或Node.js原生抽象API,而是使用N-API中可用的功能。

N-API公开的API通常用于创建和操作JavaScript值,概念和操作通常映射到ECMA262语言规范中指定的想法,API具有以下属性:

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

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

相关文章

  • Node.js 文档目录

    摘要:文档是基于的引擎构建的运行时。本文档描述了提供的内置模块,它不记录社区提供的模块。指南指南部分包含有关技术功能和性能的长篇深入文章。 Node.js 文档 Node.js®是基于Chrome的V8 JavaScript引擎构建的JavaScript运行时。 提供以下几种类型的文档: API参考文档 ES6功能 指南 API参考文档 API参考文档提供了有关Node.js中的函数或对...

    Kosmos 评论0 收藏0
  • Node.js API参考文档(关于文档

    摘要:关于文档本文档的目的是从参考和概念的角度全面解释,每个部分都描述了内置模块或高级概念。文档链接到相应的手册页手册页的简称,描述了系统调用的工作方式。上一篇参考文档目录下一篇用法和示例 关于文档 本文档的目的是从参考和概念的角度全面解释Node.js API,每个部分都描述了内置模块或高级概念。 在适当的情况下,属性类型、方法参数和提供给事件处理程序的参数将在主题标题下方的列表中详细说明...

    xorpay 评论0 收藏0
  • SpringBoot非官方教程 | 第十二篇:springboot集成apidoc

    摘要:首先声明下,是基于注释来生成文档的,它不基于任何框架,而且支持大多数编程语言,为了系列的完整性,所以标了个题。二准备工作安装完安装它的项目源码。输命令输入目录输出目录是我的工程名。 首先声明下,apidoc是基于注释来生成文档的,它不基于任何框架,而且支持大多数编程语言,为了springboot系列的完整性,所以标了个题。 一、apidoc简介 apidoc通过在你代码的注释来生成ap...

    xiaoxiaozi 评论0 收藏0
  • 【译文】Node.js官方文档(Part 1 关于文档

    摘要:关于本文档本文档的目的,是全面地解释的,即可作为参考文档,同时也包含了概念的讲解。但有的全新的实验性的,或者存在危险性的部分则会被重新设计。稳定级别锁定只会有安全性能或相关的修复。不接受对此做修改的建议。 关于本文档 本文档的目的,是全面地解释Node.js的API,即可作为参考文档,同时也包含了概念的讲解。每个章节都描述了一个内置模块或一个高阶概念(high-level concep...

    svtter 评论0 收藏0
  • 尝试造了个工具类库,名为 Diana

    摘要:的另一种形式测试踩坑之路代码覆盖率单元测试的代码覆盖率统计,是衡量测试用例好坏的一个的方法。 showImg(https://segmentfault.com/img/remote/1460000012564211?w=640&h=280); 项目地址: diana文档地址: http://muyunyun.cn/diana/ 造轮子的意义 为啥已经有如此多的前端工具类库还要自己造轮...

    zhichangterry 评论0 收藏0

发表评论

0条评论

stormzhang

|高级讲师

TA的文章

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