详解Node.js如何处理ES6模块

 更新时间:2021年05月15日 15:37:10   作者:阮一峰  
学习JavaScript语言,你会发现它有两种格式的模块。一种是ES6模块,简称ESM;另一种是Node.js专用的CommonJS模块,简称 CJS。这两种模块不兼容。很多人使用Node.js,只会用require()加载模块,遇到ES6模块就不知道该怎么办。本文就来谈谈ES6模块在Node.js里面怎么使用。

一、两种模块的差异

ES6 模块和 CommonJS 模块有很大的差异。

语法上面,CommonJS 模块使用require()加载和module.exports输出,ES6 模块使用import和export。

用法上面,require()是同步加载,后面的代码必须等待这个命令执行完,才会执行。import命令则是异步加载,或者更准确地说,ES6 模块有一个独立的静态解析阶段,依赖关系的分析是在那个阶段完成的,最底层的模块第一个执行。

二、Node.js 的区分

Node.js 要求 ES6 模块采用.mjs后缀文件名。也就是说,只要脚本文件里面使用import或者export命令,那么就必须采用.mjs后缀名。Node.js 遇到.mjs文件,就认为它是 ES6 模块,默认启用严格模式,不必在每个模块文件顶部指定"use strict"。

如果不希望将后缀名改成.mjs,可以在项目的package.json文件中,指定type字段为module。

{
   "type": "module"
}

一旦设置了以后,该目录里面的 JS 脚本,就被解释用 ES6 模块。

# 解释成 ES6 模块

$ node my-app.js

如果这时还要使用 CommonJS 模块,那么需要将 CommonJS 脚本的后缀名都改成.cjs。如果没有type字段,或者type字段为commonjs,则.js脚本会被解释成 CommonJS 模块。

总结为一句话:.mjs文件总是以 ES6 模块加载,.cjs文件总是以 CommonJS 模块加载,.js文件的加载取决于package.json里面type字段的设置。

注意,ES6 模块与 CommonJS 模块尽量不要混用。require命令不能加载.mjs文件,会报错,只有import命令才可以加载.mjs文件。反过来,.mjs文件里面也不能使用require命令,必须使用import。

三、CommonJS 模块加载 ES6 模块

CommonJS 的require()命令不能加载 ES6 模块,会报错,只能使用import()这个方法加载。

(async () => {
  await import('./my-app.mjs');
})();

上面代码可以在 CommonJS 模块中运行。

require()不支持 ES6 模块的一个原因是,它是同步加载,而 ES6 模块内部可以使用顶层await命令,导致无法被同步加载。

四、ES6 模块加载 CommonJS 模块

ES6 模块的import命令可以加载 CommonJS 模块,但是只能整体加载,不能只加载单一的输出项。

// 正确
import packageMain from 'commonjs-package';

// 报错
import { method } from 'commonjs-package';

这是因为 ES6 模块需要支持静态代码分析,而 CommonJS 模块的输出接口是module.exports,是一个对象,无法被静态分析,所以只能整体加载。

加载单一的输出项,可以写成下面这样。

import packageMain from 'commonjs-package';
const { method } = packageMain;

五、同时支持两种格式的模块

一个模块同时要支持 CommonJS 和 ES6 两种格式,也很容易。

如果原始模块是 ES6 格式,那么需要给出一个整体输出接口,比如export default obj,使得 CommonJS 可以用import()进行加载。

如果原始模块是 CommonJS 格式,那么可以加一个包装层。

import cjsModule from '../index.js';
export const foo = cjsModule.foo; 

上面代码先整体输入 CommonJS 模块,然后再根据需要输出具名接口。

你可以把这个文件的后缀名改为.mjs,或者将它放在一个子目录,再在这个子目录里面放一个单独的package.json文件,指明{ type: "module" }。

另一种做法是在package.json文件的exports字段,指明两种格式模块各自的加载入口。

"exports":{ 
    "require": "./index.js",
    "import": "./esm/wrapper.js" 
}

上面代码指定require()和import,加载该模块会自动切换到不一样的入口文件。

以上就是详解Node.js如何处理ES6模块的详细内容,更多关于Node.js如何处理 ES6 模块的资料请关注脚本之家其它相关文章!

相关文章

  • 如何在 Node.js 中使用 axios 配置代理并实现图片并发下载

    如何在 Node.js 中使用 axios 配置代理并实现图片并发下载

    这篇文章主要介绍了如何在Node.js中使用axios配置代理并实现图片并发下载,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
    2024-07-07
  • 深入理解Node module模块

    深入理解Node module模块

    这篇文章主要介绍了深入理解Node module模块,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03
  • 学习node.js 断言的使用详解

    学习node.js 断言的使用详解

    这篇文章主要介绍了学习node.js 断言的使用详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • Node.js的中间件及使用方法详解

    Node.js的中间件及使用方法详解

    在Node.js的生态中,中间件(Middleware)是一个不可或缺的概念,它为构建灵活而高效的应用程序提供了强大的支持,下面给大家介绍Node.js的中间件及使用方法,感兴趣的朋友跟随小编一起看看吧
    2024-12-12
  • Windows下nodejs安装及环境配置的实战步骤

    Windows下nodejs安装及环境配置的实战步骤

    最近换了一个电脑,因为要使用到NodeJS,我将我自己的安装步骤分享给大家,下面这篇文章主要给大家介绍了关于Windows下nodejs安装及环境配置的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2023-02-02
  • node.js入门实例helloworld详解

    node.js入门实例helloworld详解

    这篇文章主要介绍了node.js入门实例helloworld,较为详细的讲述了node.js简单输出示例helloworld的实现代码与运行方法,需要的朋友可以参考下
    2015-12-12
  • npm安装的全局包/工具不能使用,不是内部/外部命令的解决方法

    npm安装的全局包/工具不能使用,不是内部/外部命令的解决方法

    这篇文章主要给大家介绍了关于npm安装的全局包/工具不能使用,不是内部/外部命令的解决方法,文中通过图文将解决的方法介绍的非常详细,需要的朋友可以参考下
    2023-03-03
  • cnpm安装详细步骤(附图文!)

    cnpm安装详细步骤(附图文!)

    由于npm软件包管理器有时可能不太稳定,安装依赖包容易报错,所以就有了cnpm,这篇文章主要给大家介绍了关于cnpm安装的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2023-02-02
  • Nodejs中crypto模块的安全知识讲解

    Nodejs中crypto模块的安全知识讲解

    本篇文章给大家详细介绍了Nodejs中crypto模块的安全知识的相关内容,需要的朋友跟着小编一下学习参考下吧。
    2018-01-01
  • 使用 Node.js 实现图片的动态裁切及算法实例代码详解

    使用 Node.js 实现图片的动态裁切及算法实例代码详解

    这篇文章主要介绍了使用 Node.js 实现图片的动态裁切功能,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-09-09

最新评论