從版本 8.5.0 開(kāi)始,Node.js 開(kāi)始支持原生 ES 模塊,可以通過(guò)命令行選項(xiàng)打開(kāi)該功能泽篮。新功能很大程度上得歸功于 Bradley Farias柑船。
1.演示
這個(gè)示例的代碼目錄結(jié)構(gòu)如下:
esm-demo/
lib.mjs
main.mjs
lib.mjs:
export function add(x, y) {
return x + y;
}
main.mjs:
import {add} from './lib.mjs';
console.log('Result: '+add(2, 3));
運(yùn)行演示:
$ node --experimental-modules main.mjs
Result: 5
2.清單:需要注意的事情
ES 模塊:
不能動(dòng)態(tài)導(dǎo)入模塊。但是 動(dòng)態(tài) import() 的相關(guān)工作正在進(jìn)行中亏拉,應(yīng)該很快就能提供支持逆巍。
沒(méi)有元變量,如
__dirname
和__filename
锐极。但是,有一個(gè)的類似功能的提案:“import.meta”肋层◆崆ǎ看起來(lái)可能是這樣:
console.log(import.meta.url);
- 現(xiàn)在所有模塊標(biāo)識(shí)符都是 URL(這部分在 Node.js 是新增的):
- 文件 - 帶文件擴(kuò)展名的相對(duì)路徑:
../util/tools.mjs
- 庫(kù) - 沒(méi)有文件擴(kuò)展名,也沒(méi)有路徑
lodash
- 如何更好地使 npm 庫(kù)在瀏覽器中也可用(不使用 bundler)仍有待觀察蒲拉。一種可能性是引入 RequireJS 風(fēng)格的配置數(shù)據(jù)揍异,將路徑映射到實(shí)際路徑。目前衷掷,在瀏覽器中使用 bare path 的模塊標(biāo)識(shí)符是非法的。
- 文件 - 帶文件擴(kuò)展名的相對(duì)路徑:
與 CJS 模塊的互操作性
- 你可以導(dǎo)入 CJS 模塊雨涛,但它們總是只有默認(rèn)的導(dǎo)出 - 即
module.exports
的值。讓 CJS 模塊支持命名導(dǎo)出已經(jīng)在做了替久,但可能需要一段時(shí)間。如果你能幫忙后众,可以來(lái)做颅拦。
import fs1 from 'fs';
console.log(Object.keys(fs1).length); // 86
import * as fs2 from 'fs';
console.log(Object.keys(fs2)); // ['default']
- 不能在 ES 模塊中使用 require()。主要原因是:
- 路徑解析工作稍有不同:ESM 不支持
NODE_PATH
和require.extensions
右锨。而且碌秸,它的標(biāo)識(shí)符始終是 URL 也會(huì)導(dǎo)致一些細(xì)微差異。 - ES 模塊始終以異步方式加載讥电,這確保了與 Web 的最大兼容性。這種加載風(fēng)格并不能通過(guò) require() 混合使用同步加載 CJS 模塊恼策。
- 禁止同步模塊加載也可以為 Top-level await 導(dǎo)入 ES 模塊保留后路(一個(gè)當(dāng)前正在考慮的功能)潮剪。
- 路徑解析工作稍有不同:ESM 不支持
3.早期版本的 Node.js 上的 ES 模塊
如果要在 8.5.0 之前的 Node.js 版本上使用 ES 模塊,請(qǐng)參閱 John-David Dalton 的 @std/esm狮斗。
提示:如果不啟用任何可解鎖的額外功能弧蝇,將在 Node.js 保持 100% 兼容原生 ES 模塊.
FAQ
什么時(shí)候可以不帶命令行選項(xiàng)使用ES 模塊?
目前的計(jì)劃是在 Node.js 10 LTS 中默認(rèn)可使用 ES 模塊看疗。
進(jìn)一步閱讀
有關(guān) Node.js 和瀏覽器中 ES 模塊的更多信息:
- “Making transpiled ES modules more spec-compliant” [using ES modules natively vs. transpiling them via Babel]
- “Module specifiers: what’s new with ES modules?” [Why
.mjs
? How are module specifiers resolved? Etc.] - “Modules” [in-depth chapter on ES modules in “Exploring ES6”]
即將到來(lái)的 ECMAScript 提案: