NodeJs各版本新特性（持续更新）

更新时间：2025-06-19

v22（使用22.16.0测试）

概览

实验性功能变为稳定的功能：

• 监视模式（--watch）稳定化
• 权限模型（v23.5.0、v22.13.0）
• WebSocket客户端（v22.4.0）

新功能：

• 支持通过 require() 引入ESM
• 运行 package.json 中的脚本
• 增加流的默认高水位线

实验性功能：

• 文件模式匹配功能
• ts运行支持

开发者相对无感的底层更新：

• V8 引擎升级至 12.4 版本
• Maglev编译器默认启用
• 改进AbortSignal的创建性能

监视模式（--watch）稳定化

新增于：（v18.11.0, v16.19.0），用于监视文件系统的变动，并自动重启。
v22.0.0 版本开始，这个指令成为稳定功能了。

要启用监视模式，只需要在启动 Node 应用时加上 --watch ****参数。例如：

node --watch index.js

关于watch mode详情请查看：（v18.11.0, v16.19.0）测试监听模式、（v18.11.0, v16.19.0）#监听模式

权限模型

从v23.5.0、v22.13.0 开始， 此功能不再处于实验阶段。开启命令从--experimental-permission修改为--permission。

node --permission --allow-fs-read=./ index.js

关于权限模型详情请看：（v20.0.0介绍）新的权限模型

WebSocket客户端

从v22.4.0开始WebSocket属于稳定功能，不再需要 --experimental-websocket 来启用了。

如果需要关闭使用--no-experimental-websocket来禁用。

关于WebSocket客户端请查看（v21.0.0, v20.10.0）：内置 WebSocket 客户端

支持通过 require() 引入ESM

// CommonJS

// constant.mjs
export const str = 'hello world'

// test.mjs
import { str } from './constant.mjs'

export function output() {
  console.log(str)
}

// index.js
const { output } = require('./test.mjs')

output() // hello world

注意项：

1. 最新版本已默认开启，若未开启可使用 -experimental-require-module 参数，如：node --experimental-require-module index.js
2. 模块标记：确保 ESM 模块通过 package.json 中的 "type": "module" 或文件扩展名是 .mjs。
3. 完全同步：只有完全同步的ESM才能被 require() 导入，任何含有顶级 await 的ESM都不能使用这种方式加载。

运行 package.json 中的脚本

假设package.json有以下脚本：

{
  "scripts": {
    "dev": "node index.js"
  }
}

以前我们都是通过npm来运行npm run dev，或者通过第三个包管理工具：pnpm dev、yarn dev等。

现在可以直接通过node运行，省略中间步骤，做到统一运行环境和提升性能。

➜ npm run dev  

> node@1.0.0 dev
> node index.js

hello world

➜  node --run dev
hello world

增加流的默认高水位线

虽然 highWaterMark 是可配置的，但通常情况下，我们是使用默认值。在以前的版本里，highWaterMark 的默认值是 16k，Node 22 版本开始，默认值被提升到 64k 了。

const fs = require('fs')

// 读取一个文件大小为：19433
const readStream = fs.createReadStream('test.md', {
  highWaterMark: 64 * 1024
})

readStream.on('data', (chunk) => {
  // 当highWaterMark：16 * 1024时，输出：Received chunk of size: 16384、Received chunk of size: 3049
  // 当highWaterMark：16 * 1024时，输出：Received chunk of size: 19433
  console.log(`Received chunk of size: ${chunk.length}`)
})

readStream.on('end', () => {
  console.log('End of file has been reached.')
})

highWaterMark 越大，缓冲区越大，占用内存越多，I/O 操作就减少，highWaterMark 越小，其他信息也对应相反。

文件模式匹配功能

fs.glob 和 fs.globSync

const fs = require('fs')

fs.glob('./*.md', (err, files) => {
  if (err) {
    throw err
  }
  console.log(files) // ['./test.md']
})
const files = fs.globSync('./*.js')
console.log(files) // ['constant.js', 'index.js', 'test.js']

使用场景

1. 自动化构建过程，如自动寻找和处理项目中的 JavaScript 文件。(比如vue路由放在指定目录，使用此方式自动导入。)
2. 开发工具和脚本，需要对项目目录中的文件进行批量操作。
3. 任何需要从大量文件中快速筛选出符合特定模式的文件集的应用。

ts运行支持

Node.js v22.6.0 版本通过 --experimental-strip-types 标志，实现了对 TypeScript 的实验性支持。

这意味着开发者们现在可以在 Node.js 环境中直接执行 .ts 文件，而无需进行额外的编译步骤。

// index.ts
console.log('hello world');

node --experimental-strip-types index.ts // hello world!

V8 引擎升级至 12.4 版本

• WebAssembly 垃圾回收：这一特性将改善 WebAssembly 在内存管理方面的能力。
• Array.fromAsync：这个新方法允许从异步迭代器创建数组。
• Set 方法和迭代器帮助程序：提供了更多内建的Set操作和迭代器操作的方法，增强了数据结构的操作性和灵活性。

Maglev编译器默认启用

Maglev 是 V8 的新编译器，现在在支持的架构上默认启用。它主要针对短生命周期的命令行程序（CLI程序）性能进行优化，通过改进JIT（即时编译）的效率来提升性能。这对开发者编写的工具和脚本将带来明显的速度提升。

改进AbortSignal的创建性能

在这次更新中，Node 提高了 AbortSignal 实例的创建效率。AbortSignal 是用于中断正在进行的操作（如网络请求或任何长时间运行的异步任务）的一种机制。通过提升这一过程的效率，可以加快任何依赖这一功能的应用，如使用 fetch 进行HTTP请求或在测试运行器中处理中断的场景。

AbortSignal 的工作方式是通过 AbortController 实例来管理。AbortController 提供一个 signal 属性和一个 abort() 方法。signal 属性返回一个 AbortSignal 对象，可以传递给任何接受 AbortSignal 的API（如fetch）来监听取消事件。当调用abort()方法时，与该控制器关联的所有操作将被取消。

const controller = new AbortController();
const signal = controller.signal;
 
fetch(url, { signal })
  .then(response => response.json())
  .catch(err => {
    if (err.name === 'AbortError') {
      console.log('请求取消');
    } else {
      console.error('请求错误:', err);
    }
  });
 
// 取消请求
controller.abort();

参考：

https://blog.csdn.net/jjc4261/article/details/139440329

https://nodejs.org/zh-cn/blog/release/v22.0.0

v20

概览

稳定的实验性功能：

• 新的权限模型
• 内置 WebSocket 客户端
• 测试模式稳定
• ESM Loader
• import.meta.resolve
• url.parse()
• test_runner
• V8引擎更新到 11.3 版本
  自定义 ESM loader hooks 接近稳定版。
  同步化 import.meta.resolve()
  V8 引擎升级到 11.3
  稳定版 Test Runner
  最新版本的 URL 解析器 Ada 2.0
  通过注入 Blob 来准备单个可执行文件
  Web Crypto API 的优化
  官方支持 ARM64 Windows
  在 Node.js V20 中，必须指定 WASI 的版本

新增的实验性功能：

• 单执行应用程序

新的权限模型

权限模型是一种在执行期间对特定资源限制访问的机制。要启用改机制，需要在node运行脚本时，添加--experimental-permission参数，启用该机制后，将限制对所有可用权限的访问。

node --permission index.js

此时执行脚本将会报以下错误：Error: Access to this API has been restricted

可以通过以下参数给指定文件或文件间授权：

--allow-fs-read=*  # 允许读取的文件
--allow-fs-write=* # 允许写入的文件

其中*可以是文件目录，文件路径或者是路径通配符,如以下：

# 仅允许入口脚本文件可读
node --experimental-permission --allow-fs-read=index.js index.js
# 当前目录下所有文件可读
node --experimental-permission --allow-fs-read=./ index.js
# 当前目录下，所有js文件可读
node --experimental-permission --allow-fs-read="./*.js" index.js
# 当前目录及同级test目录可读，多次使用--allow-fs-read参数
node --experimental-permission --allow-fs-read=./ --allow-fs-read=../test index.js

应用内检查是否有权限：permission.has(scope[, reference])

其中：scope可选值有：fs.write、fs.read，reference参数可选，不传则为当前目录，可以传递目录、文件地址、路径通配符。

process.permission.has('fs.write'); // 获取当前目录是否有写的权限
process.permission.has('fs.write', '../test'); // 获取指定目录是否有写的权限
process.permission.has('fs.write', './*.js'); // 获取指定路径通配符是否有写的权限

process.permission.has('fs.read'); // 获取当前目录是否有读的权限
process.permission.has('fs.read', '/home/rafaelgss/protected-folder'); // 获取指定目录是否有读的权限 

其他权限扩展

• 子进程权限：--allow-child-process
• 多线程权限：--allow-worker
• 原生插件权限：--allow-addons
• WASI权限：--allow-wasi

当使用权限控制的同时，也是有了上方的功能，就需要添加上方的参数以授权，若上方的功能内使用到了文件的读取或写入操作，也需要使用--allow-fs-read或--allow-fs-write配置文件授权。

# 允许子进程权限
node --experimental-permission --allow-child-process --allow-fs-read=* process.js
# 其他相同
# ...

内置 WebSocket 客户端

在（v21.0.0, v20.10.0）版本添加，需要 --experimental-websocket 来启用。

除此之外，WebScoket 的实现还遵循了浏览器中 WebSocket API 的标准，这意味着在 Node 中使用 WebSocket 的方式将与在 JavaScript 中使用 WebSocket 的方式非常相似，有助于减少学习成本并提高代码的一致性。

注意：
这个是用于客户端的，如果创建服务端，还是推荐使用上面的三方库：ws、socket.io

// 无需导入，直接使用
const socket = new WebSocket('ws://localhost:8800')

socket.addEventListener('open', (event) => {
  socket.send('Hello Server!')
})
socket.addEventListener('error', (event) => {
  console.log('WebSocket error:', event)
})

测试模式稳定

从v20.0.0开始，Test Running标记为稳定。可以通过--watch **启动。

node --watch index.js

使用内置的 node:test 和 node:assert 模块，支持基本的测试用例编写、断言和报告生成。

const { test } = require('node:test')
const assert = require('node:assert')
test('加法测试', () => {
  assert.strictEqual(1 + 1, 2)
})

关于Test Running详情请查看：（v18.11.0, v16.19.0）测试监听模式、（v18.1.0, v16.17.0）#测试模式

注意：不能和--watch-path, --check, --eval, --interactive同时使用

v18

实验性功能：

• 测试监听模式同时使用

测试监听模式

新增于：（v19.2.0, v18.13.0），在测试模式下，也可以使用监听模式了。

之前版本同时使用是会报错：

# node: either --test or --watch can be used, not both
node --test --watch index.js

之后版本就可以同时使用了。

关于watch mode详情请查看：（v18.11.0, v16.19.0）#监听模式
关于test running详情请查看：（v18.1.0, v16.17.0）#测试模式

单执行应用程序

允许将 Node.js 应用打包为单个可执行文件，无需单独安装 Node.js 运行时。

v16

实验性功能：

• Watch Mode
• Test Running

监听模式

新增于：（v18.11.0, v16.19.0），用于监视文件系统的变动，并自动重启。

要启用监视模式，只需要在启动 Node 应用时加上 --watch ****参数。例如：

node --watch index.js

这样不管是index.js发生改变，还是index.js依赖的文件发生改变，都会重新运行了。如果只需要监听文件改变重新运行，可以替代了nodemon包了。

注意：不能和--test同时使用

测试模式

新增于：（v18.1.0, v16.17.0），用于监视文件系统的变动，并自动重启。

要启用测试模式，只需要在启动 Node 应用时加上 --test ****参数。例如：

使用内置的 node:test 和 node:assert 模块，支持基本的测试用例编写、断言和报告生成。

const { test } = require('node:test')
const assert = require('node:assert')
test('加法测试', () => {
  assert.strictEqual(1 + 1, 2)
})

node --test index.js

v14