在 Node.js 中使用原生 ES 模塊

原文:Using ES modules natively in Node.js

作者:Axel Rauschmayer

從版本 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í)符是非法的。

與 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_PATHrequire.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)前正在考慮的功能)潮剪。

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 模塊的更多信息:

即將到來(lái)的 ECMAScript 提案:

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末两芳,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子是复,更是在濱河造成了極大的恐慌,老刑警劉巖淑廊,帶你破解...
    沈念sama閱讀 206,126評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件季惩,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡画拾,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)脂凶,“玉大人愁茁,你說(shuō)我怎么就攤上這事《旌埽” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 152,445評(píng)論 0 341
  • 文/不壞的土叔 我叫張陵邮屁,是天一觀的道長(zhǎng)菠齿。 經(jīng)常有香客問(wèn)我,道長(zhǎng)芋忿,這世上最難降的妖魔是什么疾棵? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,185評(píng)論 1 278
  • 正文 為了忘掉前任,我火速辦了婚禮殉了,結(jié)果婚禮上拟枚,老公的妹妹穿的比我還像新娘抖所。我一直安慰自己痕囱,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,178評(píng)論 5 371
  • 文/花漫 我一把揭開(kāi)白布傻粘。 她就那樣靜靜地躺著帮掉,像睡著了一般。 火紅的嫁衣襯著肌膚如雪蟆炊。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 48,970評(píng)論 1 284
  • 那天污秆,我揣著相機(jī)與錄音昧甘,去河邊找鬼。 笑死庸推,一個(gè)胖子當(dāng)著我的面吹牛浇冰,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播肘习,決...
    沈念sama閱讀 38,276評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼蚓庭!你這毒婦竟也來(lái)了仅仆?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 36,927評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤港柜,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后夏醉,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,400評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡氯夷,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,883評(píng)論 2 323
  • 正文 我和宋清朗相戀三年腮考,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了玄捕。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 37,997評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡馅闽,死狀恐怖馍迄,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情柬姚,我是刑警寧澤庄涡,帶...
    沈念sama閱讀 33,646評(píng)論 4 322
  • 正文 年R本政府宣布,位于F島的核電站撕捍,受9級(jí)特大地震影響泣洞,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜球凰,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,213評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望缘厢。 院中可真熱鬧甩挫,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,204評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至税灌,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間苞也,已是汗流浹背粘秆。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,423評(píng)論 1 260
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留殷勘,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,423評(píng)論 2 352
  • 正文 我出身青樓玲销,卻偏偏與公主長(zhǎng)得像摘符,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子瘩绒,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,722評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容