首页
/ Node.js v20.19.0版本发布:ES模块支持迎来重大更新

Node.js v20.19.0版本发布:ES模块支持迎来重大更新

2025-05-31 16:01:39作者:曹令琨Iris

Node.js作为当今最流行的JavaScript运行时环境之一,其最新长期支持版本v20.19.0带来了多项重要特性更新,特别是在ES模块(ESM)支持方面取得了显著进展。本文将深入解析这些新特性及其对开发者的影响。

核心特性解析

默认启用的require(ESM)功能

v20.19.0版本最引人注目的变化是移除了--experimental-require-module标志,默认支持通过require()加载原生ES模块。这一特性曾在v20.x版本中作为实验性功能存在,在v22.x和v23.x中已默认启用,现在终于正式成为v20.x的稳定功能。

开发者现在可以:

  • 直接使用require()加载ES模块而不会抛出ERR_REQUIRE_ESM错误
  • 当加载的ES模块或其依赖包含顶层await时,会抛出ERR_REQUIRE_ASYNC_MODULE错误
  • 成功加载ES模块后,返回的对象可能是ES模块命名空间对象或模块中作为"module.exports"导出的内容

新增的process.features.require_module属性可用来检测当前Node.js实例是否启用了此功能。对于包开发者,可以使用"module-sync"导出条件来检测require(esm)支持,实现同一原生ES模块同时支持require()import加载。

模块语法检测默认启用

另一个重要更新是默认启用了模块语法检测功能(原--experimental-detect-module标志)。这一特性使得Node.js能够智能识别文件模块类型:

  1. 对于扩展名为.js或无扩展名的文件
  2. 当最近的父级package.json没有"type"字段时
  3. Node.js会先尝试作为CommonJS解析,如果因ES模块语法失败则重新作为ES模块处理

这一特性特别适合无扩展名的脚本文件使用ES模块语法且附近没有package.json的场景。需要注意的是,虽然对CommonJS模块性能无影响,但对ES模块会有轻微性能开销,可通过在最近的package.json中添加"type": "module"来消除。

其他重要更新

  • 加密模块:根证书更新至NSS 3.107版本
  • Worker线程:新增postMessageToThread API
  • 进程管理:新增process.features.require_module属性
  • 模块系统:实现"module-sync"导出条件
  • 兼容性:为require()加载的ES模块添加__esModule属性

开发者影响与建议

对于正在使用或计划迁移到ES模块的开发者,v20.19.0提供了更平滑的过渡路径。建议:

  1. 测试现有代码库中require()加载ES模块的场景
  2. 对于性能敏感的应用,考虑为ES模块明确添加"type": "module"
  3. 关注顶层await在require(ESM)中的限制
  4. 利用新的模块语法检测功能简化项目结构

Node.js团队表示这些特性已在v23.x和v22.x中经过充分测试,现在期待v20.x用户的反馈以进行最终调整。如遇到回归问题,开发者可以通过--no-experimental-require-module临时禁用相关功能。

随着ES模块生态的日益成熟,Node.js v20.19.0的这些改进标志着JavaScript模块系统统一的重要一步,为开发者提供了更大的灵活性和更简单的迁移路径。

登录后查看全文
热门项目推荐