Node.js 20 发行注记

此发行版本包括将 V8 JavaScript 引擎升级到 v11.3，它是 Chromium 113 的一部分。

升级的 V8 JavaScript 引擎包括以下新功能和增强：

有关 V8 JavaScript 引擎中可用更改的更多信息，请参阅 V8 博客。

红帽构建的 Node.js 20 将测试运行程序模块作为可在生产环境中使用的稳定功能提供。在早期版本中，test runner 模块仅作为实验性功能提供。

test runner 模块不旨在替换 Jest 或 Mocha 等全功能测试框架。test runner 模块提供了一种快速、简单的方法来编写和运行测试套件，而无需安装其他依赖项。

在红帽构建的 Node.js 20 中，测试运行程序模块包括以下类型的增强功能：

如需更多信息，请参阅 Node.js Test Runner 文档。

在红帽构建的 Node.js 20 中，您通过加载程序提供的 ECMAScipt 模块(ESM) hook （例如，--experimental-loader=myhook.mjs）在专用线程上运行，它与主应用程序线程分开。通过为加载程序提供单独的范围，这个增强可保护应用程序代码免受潜在的影响。

在红帽构建的 Node.js 20 中，import.meta.resolve （） 函数会以同步方式返回值。但是，根据您的偏好，您仍然可以定义自定义加载程序 解析 hook 作为同步或同chronous 功能。即使加载了异步 解析 hook，import.meta.resolve （） 函数也会为应用程序代码同步返回值。

在红帽构建的 Node.js 20 中，Web Crypto API coerces 并根据其 WebIDL 定义验证功能参数，类似于 Web Crypto API 的其他实现。此功能增强有助于提高 Node.js 和 Web Crypto API 的浏览器实现之间的互操作性。

从红帽构建的 Node.js 20 开始，import.meta.resolve (specifier) 属性不再依赖于 --experimental-import-meta-resolve 命令行界面(CLI)标记。现在，您可以使用 import.meta.resolve (specifier) 属性获取指定符字符串解析到的绝对字符串，这与 CommonJS 模块中的 require.resolve 功能类似。此功能增强有助于将 Node.js 与浏览器和其他服务器端运行时保持一致。

如需更多信息，请参阅 Node.js import.meta.resolve 文档。

红帽构建的 Node.js 20 提供了属于 node:module API 的新 module.register (specifier[, parentURL][, options]) 方法。您可以使用这个新方法指定导出模块自定义 hook 的文件，将数据传递给 hook，并使用这些 hook 建立通信频道。此增强会取代之前版本中的行为，这需要使用 --experimental-loader 标志来指定导出 hook 的文件。

为确保自定义 hook 在任何应用程序代码运行前注册，请考虑在运行使用寄存器功能的应用程序时使用 --import 标志。

例如：

node --import ./file-that-calls-register.js ./app.js

node --import ./file-that-calls-register.js ./app.js

如需更多信息，请参阅 Node.js module.register 文档。

红帽构建的 Node.js 20 可让模块自定义 hook 作者 处理负载 hook 中的 ESM 和 CommonJS 源。当应用程序的主入口点由 ESM loader 处理时，这个增强适用于使用 导入 或 require 语句引用的 CommonJS 模块。例如，当入口点是 ESM 文件或使用 --import 标志时，这个增强是相关的。这有助于简化 Node.js 加载过程的自定义，因为软件包作者可以执行额外的 Node.js 自定义，而无需依赖已弃用的 API，如 require.extensions。

如需更多信息，请参阅 Node.js Hook：加载文档。

红帽构建的 Node.js 20 提高了可读和可写入流的性能。此功能增强包括改进，如减少内存开销，改进了对可读流的 async iterator 消耗，并改进了可读流的 pipeTo 消耗。

此发行版本包括包含无效端口的 url.parse （） 方法调用的运行时弃用。在以前的版本中，url.parse （） 方法接受包含非数字端口值的 URL，这可能会导致带有意外输入的主机名欺骗。在本发行版本中，如果 URL 包含非数字端口值，则 url.parse （） 方法会发出警告。

如需更多信息，请参阅 Node.js url.parse 文档。

实验性 WebAsembly 系统接口(WASI)功能在此发行版本中包括以下改进：

如需更多信息，请参阅 Node.js WebAssembly System Interface (WASI)文档。

红帽构建的 Node.js 20 引入了实验性权限模型功能。此功能使开发人员能够限制在程序执行过程中对特定资源的访问，如文件系统操作、子进程生成和 worker 线程创建。这意味着，您可以防止应用程序访问或修改敏感数据，或者运行潜在的代码。

您可以使用 --experimental-permission CLI 标志启用 Permission Model 功能。通过启用此功能，您可以自动限制对所有可用权限的访问。

要管理权限，您可以使用以下 CLI 标志：

如需更多信息，请参阅 Node.js 权限模型文档。

红帽构建的 Node.js 20 引入了 TracingChannel 类，作为 Diagnostics Channel 功能的实验性扩展。追踪频道有助于对诊断频道进行分组，这些频道代表单个可追踪操作执行生命周期的不同点，用于生成和使用 trace 数据。因此，追踪频道有助于规范化和简化为追踪应用程序流生成事件的过程。

如需更多信息，请参阅 Node.js TracingChannel 文档。

红帽构建的 Node.js 20 引入了一个实验性的 Mock Timers 功能，可让开发人员为依赖计时器的功能编写更可预测且可靠的测试。计时器模拟是一种常用的技术，可用于模拟和测试计时器行为，而无需等待指定的时间间隔。Mock Timers 功能包含一个 MockTimers 类，可让您从全局对象和 node:timers /promises API 中模拟对 setTimeout （） 和 setInterval （） 方法的调用。

Mock Timers 功能提供了一个简单的 API，用于提前时间，启用特定的计时器，并释放所有计时器。

例如：

import assert from 'node:assert';
import { test } from 'node:test';

test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
  const fn = context.mock.fn();
  // Optionally choose what to mock
  context.mock.timers.enable(['setTimeout']);
  const nineSecs = 9000;
  setTimeout(fn, nineSecs);

  const threeSeconds = 3000;
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);

  assert.strictEqual(fn.mock.callCount(), 1);

import assert from 'node:assert';
import { test } from 'node:test';

test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
  const fn = context.mock.fn();
  // Optionally choose what to mock
  context.mock.timers.enable(['setTimeout']);
  const nineSecs = 9000;
  setTimeout(fn, nineSecs);

  const threeSeconds = 3000;
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);

  assert.strictEqual(fn.mock.callCount(), 1);

如需更多信息，请参阅 Node.js Mocking: Timers 文档。

红帽构建的 Node.js 20 引入了一个实验性功能，用于在 .env 文件中配置环境变量，该文件在启动时传递给 Node.js 应用程序。与 .ini 文件格式类似，.env 配置文件中的每一行包含特定环境变量的键值对。例如：

PASSWORD=nodejs

PASSWORD=nodejs

您可以使用 --env-file 标志，使用预定义的环境变量初始化并运行 Node.js 应用程序。例如：

node --env-file=myconfig.env myapp.js

node --env-file=myconfig.env myapp.js

按照上例所示初始化应用程序时，您可以使用 process.env 属性访问相关的环境变量。例如，若要访问 PASSWORD=node.js 环境变量，您可以使用 process.env.PASSWORD 属性。

此功能增强还允许您在 .env 配置文件中定义 NODE_OPTIONS 环境变量，无需在 package.json 文件中包含 NODE_OPTIONS。