ECMAScript模块-2022

从Node 14.0开始，ECMAScript模块不再是实验性的，您可以使用它们代替经典Node的CommonJS模块。

ECMAScript模块是打包JavaScript代码以供重用的官方标准格式。模块是使用各种导入和导出语句定义的。

您可以定义导出函数的ES模块：

// my-fun.mjs
function myFun(num) {
  // do something
}

export { myFun };

然后，您可以从my-fun.mjs导入导出的函数：

// app.mjs
import { myFun } from './my-fun.mjs';

myFun();

.mjs是Node.js ECMAScript模块的默认扩展名。但是，在使用package.json“type”字段或CLI中的--input-type标志解析模块时，可以将默认模块扩展配置为查找。

Node.js的最新版本完全支持ECMAScript和CommonJS模块。此外，它还提供了它们之间的互操作性。

模块导出

ECMAScript和CommonJS模块有很多不同之处，但与此问题最相关的区别是，不再需要，不再导出，不再模块。导出

在大多数情况下，ES模块导入可用于加载CommonJS模块。如果需要，可以使用module.createRequire（）在ES模块中构造require函数。

ECMAScript模块发布历史记录

您可以在Node.js存储库中找到所有变更日志

module.exports属性或exports对象允许模块选择应该与应用程序共享的内容

我这里有关于module_export的视频

如果将对新对象的引用分配给exports和/或modules.exports，则必须注意以下几点：

1.以前附加到原始导出或模块的所有财产/方法都会丢失。导出当然会丢失，因为导出的对象现在将引用另一个新的对象

这一点很明显，但如果在现有模块的开头添加导出方法，请确保本机导出对象在末尾没有引用另一个对象

exports.method1 = function () {}; // exposed to the original exported object
exports.method2 = function () {}; // exposed to the original exported object

module.exports.method3 = function () {}; // exposed with method1 & method2

var otherAPI = {
    // some properties and/or methods
}

exports = otherAPI; // replace the original API (works also with module.exports)

2.如果exports或module.exports中的一个引用新值，则它们不再引用同一对象

exports = function AConstructor() {}; // override the original exported object
exports.method2 = function () {}; // exposed to the new exported object

// method added to the original exports object which not exposed any more
module.exports.method3 = function () {}; 

3.狡猾的后果。如果同时更改了对exports和module.exports的引用，很难说哪个API是公开的（看起来module.export获胜）

// override the original exported object
module.exports = function AConstructor() {};

// try to override the original exported object
// but module.exports will be exposed instead
exports = function AnotherConstructor() {}; 

将程序代码划分为多个文件时，module.exports用于向模块的使用者发布变量和函数。源文件中的require（）调用将替换为从模块加载的相应module.exports。

编写模块时记住

模块加载被缓存，只有初始调用评估JavaScript。可以在模块中使用局部变量和函数，而不需要导出所有内容。module.exports对象也可用作导出速记。但当返回一个单独的函数时，请始终使用module.exports。

根据：“模块第2部分-编写模块”。

模块系统的目的是什么？

它完成了以下任务：

使我们的文件从膨胀到真正的大尺寸。在开发过程中，通常很难处理包含5000行代码的文件。强制分离关注点。将代码拆分为多个文件可以让我们为每个文件指定适当的文件名。通过这种方式，我们可以很容易地确定每个模块都做什么以及在哪里找到它（假设我们制作了一个逻辑目录结构，这仍然是您的责任）。

拥有模块可以更容易地找到代码的某些部分，从而使代码更易于维护。

它是如何工作的？

NodejS使用CommomJS模块系统，其工作方式如下：

如果文件想要导出某些内容，则必须使用module.export语法声明它如果文件要导入某个内容，则必须使用require（'file'）语法声明它

例子：

测试1.js

const test2 = require('./test2');    // returns the module.exports object of a file

test2.Func1(); // logs func1
test2.Func2(); // logs func2

测试2.js

module.exports.Func1 = () => {console.log('func1')};

exports.Func2 = () => {console.log('func2')};

其他需要了解的有用信息：

正在缓存模块。当您在两个不同的文件中加载相同的模块时，该模块只需加载一次。第二次对同一模块调用require（）时，将从缓存中取出。模块以同步方式加载。这个行为是必需的，如果它是异步的，我们无法立即访问从require（）中检索的对象。

请注意，NodeJS模块机制基于CommonJS模块，这些模块在许多其他实现中都受支持，如RequireJS，但也包括SproutCore、CouchDB、Wakanda、OrientDB、ArangoDB、RingoJS、TeaJS、SilkJS、curl.js，甚至Adobe Photoshop（通过PSLib）。您可以在这里找到已知实现的完整列表。

除非您的模块使用特定于节点的特性或模块，否则我强烈建议您使用导出，而不是不属于CommonJS标准的module.exports，并且其他实现通常不支持。

另一个特定于NodeJS的特性是，当您将一个引用分配给一个要导出的新对象时，而不是像Jed Watson在这个线程中提供的最后一个示例那样向其添加财产和方法。我个人不赞成这种做法，因为这打破了CommonJS模块机制的循环引用支持。它不是所有实现都支持的，Jed示例应该以这种方式（或类似的方式）编写，以提供更通用的模块：

（sayhello.js）：

exports.run = function() {
    console.log("Hello World!");
}

（app.js）：

var sayHello = require('./sayhello');
sayHello.run(); // "Hello World!"

或使用ES6功能

（sayhello.js）：

Object.assign(exports, {
    // Put all your public API here
    sayhello() {
        console.log("Hello World!");
    }
});

（app.js）：

const { sayHello } = require('./sayhello');
sayHello(); // "Hello World!"

PS：看起来Appcelerator也实现了CommonJS模块，但没有循环引用支持（参见：Appcelerater和CommonJS模块（缓存和循环引用））