Node.js v13.2.0 开始支持ES modules了

本文首发于公众号：符合预期的CoyPan

写在前面

Node.js 前不久发布了v13.2.0，宣布开始支持ES modules。在此以前，想要在node中使用ES modules，须要添加--experimental-module。v13.2.0版本后，能够直接使用ES modules了。

在node中使用ES modules

想要在项目中使用ES modules，有如下两种方法：

一、文件后缀名使用.mjs

举个例子，假设项目目录以下：

.
|____component
| |____a.mjs
|____index.mjs
复制代码

文件内容以下：

// component/a.mjs
let a = 'This is component a';
export default a;

// index.mjs
import a from './component/a.mjs';
console.log(a);
复制代码

执行node index.mjs，代码能够正确执行，输出以下：

(node:77465) ExperimentalWarning: The ESM module loader is experimental.
This is component a
复制代码

二、文件依然使用.js的后缀名，在项目的package.json中设置：type:module

项目目录以下：

.
|____component
| |____a.js
|____package.json
|____index.js
复制代码

各个文件内容以下：

// component/a.js
let a = 'This is component a';
export default a;

// index.js
import a from './component/a.mjs';
console.log(a);

// package.json
{
  ...
  "type": "module", // 必需要有这一行
  ...
}
复制代码

执行node index.js，代码能够正确执行，输出以下：

(node:78977) ExperimentalWarning: The ESM module loader is experimental.
This is component a
复制代码

若是在命令行使用ES module，须要加上--input-type=module。举个例子：

node --input-type=module --eval "import { sep } from 'path'; console.log(sep);"
复制代码

须要注意的是，目前，ES module的实现仍是实验性质的，后续有随时调整的可能。

Import

import引入ES module时，支持如下几种方式：

1. 相对路径 (./file.mjs)
2. 绝对路径 (file:///opt/app/file.mjs)
3. 模块名 (es-module-package’)
4. 模块内路径 (es-module-package/lib/file.mjs)

另外，使用import引用ES module时，能够像这样使用：

1. import _ from ‘es-module-package’
2. import { shuffle } from ‘es-module-package
3. import * as fs from ‘fs

全部的Node内置模块，例如fs和path，均支持上述三种方式来引用。

import 与 Commonjs

import也能够引入Commonjs的模块，包含如下两种状况：

• 模块使用Commonjs规范编写，而且后缀名为：.cjs

例如代码目录以下：

.
|____component
| |____a.cjs
|____package.json
|____index.js
复制代码

文件内容以下：

// component/a.cjs
let a = 'This is component a';
console.log('aaaa');
module.exports = a;

// index.js
import a from './component/a.cjs'; 
console.log(a);

// package.json
{
  ...
  "type": "module",
  ...
}
复制代码

执行node index.js，代码能够正确执行，输入以下：

(node:81677) ExperimentalWarning: The ESM module loader is experimental.
aaaa
This is component a
复制代码

• 模块拥有自身的package.json，没有设置"type": "module"或设置"type": "commonjs"。 例如代码目录以下：

.
|____component
| |____a.js
| |____package.json
|____package.json
|____index.js
复制代码

文件内容以下：

// component/a.js
let a = 'This is component a';
console.log('aaaa');
module.exports = a;

// component/package.json
{
  "type": "commonjs" // 也能够不设置type字段
}

// index.js
import a from './component/a.js';
console.log(a);

// package.json
{
  ...
  "type": "module",
  ...
}
复制代码

执行node index.js，代码能够正确执行，输入以下：

(node:81677) ExperimentalWarning: The ESM module loader is experimental.
aaaa
This is component a
复制代码

写在后面

本文经过示例，简单介绍了Node.js中ES Module的相关使用方法，更多详细介绍请参考官方文档：

nodejs.org/api/esm.htm…

---