概述
歷史上铃诬,JavaScript 一直沒有模塊(module)體系贿肩,無法將一個(gè)大程序拆分成互相依賴的小文件,再用簡單的方法拼裝起來聂使。其他語言都有這項(xiàng)功能壁拉,比如 Ruby 的require
、Python 的import
柏靶,甚至就連 CSS 都有@import
弃理,但是 JavaScript 任何這方面的支持都沒有,這對(duì)開發(fā)大型的屎蜓、復(fù)雜的項(xiàng)目形成了巨大障礙痘昌。
在 ES6 之前,社區(qū)制定了一些模塊加載方案,最主要的有 CommonJS 和 AMD 兩種辆苔。前者用于服務(wù)器笔诵,后者用于瀏覽器。ES6 在語言標(biāo)準(zhǔn)的層面上姑子,實(shí)現(xiàn)了模塊功能乎婿,而且實(shí)現(xiàn)得相當(dāng)簡單,完全可以取代 CommonJS 和 AMD 規(guī)范街佑,成為瀏覽器和服務(wù)器通用的模塊解決方案谢翎。
ES6 模塊的設(shè)計(jì)思想,是盡量的靜態(tài)化沐旨,使得編譯時(shí)就能確定模塊的依賴關(guān)系森逮,以及輸入和輸出的變量。CommonJS 和 AMD 模塊磁携,都只能在運(yùn)行時(shí)確定這些東西褒侧。比如,CommonJS 模塊就是對(duì)象谊迄,輸入時(shí)必須查找對(duì)象屬性闷供。
// CommonJS模塊
let { stat, exists, readFile } = require('fs');
// 等同于
let _fs = require('fs');
let stat = _fs.stat;
let exists = _fs.exists;
let readfile = _fs.readfile;
上面代碼的實(shí)質(zhì)是整體加載fs
模塊(即加載fs
的所有方法),生成一個(gè)對(duì)象(_fs
)统诺,然后再從這個(gè)對(duì)象上面讀取3個(gè)方法歪脏。這種加載稱為“運(yùn)行時(shí)加載”,因?yàn)橹挥羞\(yùn)行時(shí)才能得到這個(gè)對(duì)象粮呢,導(dǎo)致完全沒辦法在編譯時(shí)做“靜態(tài)優(yōu)化”婿失。
ES6 模塊不是對(duì)象,而是通過export
命令顯式指定輸出的代碼啄寡,再通過import
命令輸入豪硅。
// ES6模塊
import { stat, exists, readFile } from 'fs';
上面代碼的實(shí)質(zhì)是從fs
模塊加載3個(gè)方法,其他方法不加載挺物。這種加載稱為“編譯時(shí)加載”或者靜態(tài)加載懒浮,即 ES6 可以在編譯時(shí)就完成模塊加載,效率要比 CommonJS 模塊的加載方式高姻乓。當(dāng)然嵌溢,這也導(dǎo)致了沒法引用 ES6 模塊本身,因?yàn)樗皇菍?duì)象赖草。
由于 ES6 模塊是編譯時(shí)加載,使得靜態(tài)分析成為可能秧骑。有了它,就能進(jìn)一步拓寬 JavaScript 的語法绒疗,比如引入宏(macro)和類型檢驗(yàn)(type system)這些只能靠靜態(tài)分析實(shí)現(xiàn)的功能。
除了靜態(tài)加載帶來的各種好處吓蘑,ES6 模塊還有以下好處。
- 不再需要
UMD
模塊格式了坟冲,將來服務(wù)器和瀏覽器都會(huì)支持 ES6 模塊格式磨镶。目前,通過各種工具庫健提,其實(shí)已經(jīng)做到了這一點(diǎn)琳猫。 - 將來瀏覽器的新 API 就能用模塊格式提供,不再必須做成全局變量或者
navigator
對(duì)象的屬性私痹。 - 不再需要對(duì)象作為命名空間(比如
Math
對(duì)象)脐嫂,未來這些功能可以通過模塊提供。
本章介紹 ES6 模塊的語法紊遵,下一章介紹如何在瀏覽器和 Node 之中账千,加載 ES6 模塊。
嚴(yán)格模式
ES6 的模塊自動(dòng)采用嚴(yán)格模式癞蚕,不管你有沒有在模塊頭部加上"use strict";
蕊爵。
嚴(yán)格模式主要有以下限制。
- 變量必須聲明后再使用
- 函數(shù)的參數(shù)不能有同名屬性桦山,否則報(bào)錯(cuò)
- 不能使用
with
語句 - 不能對(duì)只讀屬性賦值,否則報(bào)錯(cuò)
- 不能使用前綴0表示八進(jìn)制數(shù)醋旦,否則報(bào)錯(cuò)
- 不能刪除不可刪除的屬性恒水,否則報(bào)錯(cuò)
- 不能刪除變量
delete prop
,會(huì)報(bào)錯(cuò)饲齐,只能刪除屬性delete global[prop]
-
eval
不會(huì)在它的外層作用域引入變量 -
eval
和arguments
不能被重新賦值 -
arguments
不會(huì)自動(dòng)反映函數(shù)參數(shù)的變化 - 不能使用
arguments.callee
- 不能使用
arguments.caller
- 禁止
this
指向全局對(duì)象 - 不能使用
fn.caller
和fn.arguments
獲取函數(shù)調(diào)用的堆棧 - 增加了保留字(比如
protected
钉凌、static
和interface
)
上面這些限制,模塊都必須遵守捂人。由于嚴(yán)格模式是 ES5 引入的御雕,不屬于 ES6,所以請(qǐng)參閱相關(guān) ES5 書籍滥搭,本書不再詳細(xì)介紹了瑟匆。
其中疾嗅,尤其需要注意this
的限制代承。ES6 模塊之中论悴,頂層的this
指向undefined
啊片,即不應(yīng)該在頂層代碼使用this
紫谷。
export 命令
模塊功能主要由兩個(gè)命令構(gòu)成:export
和import
笤昨。export
命令用于規(guī)定模塊的對(duì)外接口瞒窒,import
命令用于輸入其他模塊提供的功能崇裁。
一個(gè)模塊就是一個(gè)獨(dú)立的文件拔稳。該文件內(nèi)部的所有變量,外部無法獲取礁遵。如果你希望外部能夠讀取模塊內(nèi)部的某個(gè)變量佣耐,就必須使用export
關(guān)鍵字輸出該變量稼病。下面是一個(gè) JS 文件,里面使用export
命令輸出變量援制。
// profile.js
export var firstName = 'Michael';
export var lastName = 'Jackson';
export var year = 1958;
上面代碼是profile.js
文件晨仑,保存了用戶信息。ES6 將其視為一個(gè)模塊竟贯,里面用export
命令對(duì)外部輸出了三個(gè)變量拱镐。
export
的寫法沃琅,除了像上面這樣益眉,還有另外一種郭脂。
// profile.js
var firstName = 'Michael';
var lastName = 'Jackson';
var year = 1958;
export {firstName, lastName, year};
上面代碼在export
命令后面朱庆,使用大括號(hào)指定所要輸出的一組變量傲诵。它與前一種寫法(直接放置在var
語句前)是等價(jià)的拴竹,但是應(yīng)該優(yōu)先考慮使用這種寫法座泳。因?yàn)檫@樣就可以在腳本尾部,一眼看清楚輸出了哪些變量镇防。
export
命令除了輸出變量来氧,還可以輸出函數(shù)或類(class)啦扬。
export function multiply(x, y) {
return x * y;
};
上面代碼對(duì)外輸出一個(gè)函數(shù)multiply
。
通常情況下盛险,export
輸出的變量就是本來的名字泉褐,但是可以使用as
關(guān)鍵字重命名膜赃。
function v1() { ... }
function v2() { ... }
export {
v1 as streamV1,
v2 as streamV2,
v2 as streamLatestVersion
};
上面代碼使用as
關(guān)鍵字跳座,重命名了函數(shù)v1
和v2
的對(duì)外接口疲眷。重命名后狂丝,v2
可以用不同的名字輸出兩次。
需要特別注意的是讯屈,export
命令規(guī)定的是對(duì)外的接口谆趾,必須與模塊內(nèi)部的變量建立一一對(duì)應(yīng)關(guān)系。
// 報(bào)錯(cuò)
export 1;
// 報(bào)錯(cuò)
var m = 1;
export m;
上面兩種寫法都會(huì)報(bào)錯(cuò)彤钟,因?yàn)闆]有提供對(duì)外的接口。第一種寫法直接輸出1性芬,第二種寫法通過變量m
辫樱,還是直接輸出1狮暑。1
只是一個(gè)值搬男,不是接口缔逛。正確的寫法是下面這樣褐奴。
// 寫法一
export var m = 1;
// 寫法二
var m = 1;
export {m};
// 寫法三
var n = 1;
export {n as m};
上面三種寫法都是正確的敦冬,規(guī)定了對(duì)外的接口m
。其他腳本可以通過這個(gè)接口介蛉,取到值1
。它們的實(shí)質(zhì)是佳恬,在接口名與模塊內(nèi)部變量之間,建立了一一對(duì)應(yīng)的關(guān)系垫言。
同樣的筷频,function
和class
的輸出蜓谋,也必須遵守這樣的寫法坯癣。
// 報(bào)錯(cuò)
function f() {}
export f;
// 正確
export function f() {};
// 正確
function f() {}
export {f};
另外示罗,export
語句輸出的接口,與其對(duì)應(yīng)的值是動(dòng)態(tài)綁定關(guān)系拌阴,即通過該接口脯倒,可以取到模塊內(nèi)部實(shí)時(shí)的值藻丢。
export var foo = 'bar';
setTimeout(() => foo = 'baz', 500);
上面代碼輸出變量foo
悠反,值為bar
斋否,500毫秒之后變成baz
茵臭。
這一點(diǎn)與 CommonJS 規(guī)范完全不同奇徒。CommonJS 模塊輸出的是值的緩存摩钙,不存在動(dòng)態(tài)更新胖笛,詳見下文《Module 的加載實(shí)現(xiàn)》一節(jié)长踊。
最后之斯,export
命令可以出現(xiàn)在模塊的任何位置佑刷,只要處于模塊頂層就可以。如果處于塊級(jí)作用域內(nèi)填硕,就會(huì)報(bào)錯(cuò)壮莹,下一節(jié)的import
命令也是如此命满。這是因?yàn)樘幱跅l件代碼塊之中胶台,就沒法做靜態(tài)優(yōu)化了诈唬,違背了ES6模塊的設(shè)計(jì)初衷铸磅。
function foo() {
export default 'bar' // SyntaxError
}
foo()
上面代碼中济竹,export
語句放在函數(shù)之中,結(jié)果報(bào)錯(cuò)丘跌。
import 命令
使用export
命令定義了模塊的對(duì)外接口以后,其他 JS 文件就可以通過import
命令加載這個(gè)模塊荒澡。
// main.js
import {firstName, lastName, year} from './profile';
function setName(element) {
element.textContent = firstName + ' ' + lastName;
}
上面代碼的import
命令碍现,用于加載profile.js
文件昼接,并從中輸入變量慢睡。import
命令接受一對(duì)大括號(hào)漂辐,里面指定要從其他模塊導(dǎo)入的變量名髓涯。大括號(hào)里面的變量名复凳,必須與被導(dǎo)入模塊(profile.js
)對(duì)外接口的名稱相同育八。
如果想為輸入的變量重新取一個(gè)名字髓棋,import
命令要使用as
關(guān)鍵字膳犹,將輸入的變量重命名须床。
import { lastName as surname } from './profile';
import
后面的from
指定模塊文件的位置豺旬,可以是相對(duì)路徑族阅,也可以是絕對(duì)路徑坦刀,.js
后綴可以省略鲤遥。如果只是模塊名,不帶有路徑,那么必須有配置文件场钉,告訴 JavaScript 引擎該模塊的位置逛万。
import {myMethod} from 'util';
上面代碼中宇植,util
是模塊文件名,由于不帶有路徑拷呆,必須通過配置,告訴引擎怎么取到這個(gè)模塊梗逮。
注意慷彤,import
命令具有提升效果瞬欧,會(huì)提升到整個(gè)模塊的頭部,首先執(zhí)行唉侄。
foo();
import { foo } from 'my_module';
上面的代碼不會(huì)報(bào)錯(cuò)恬叹,因?yàn)?code>import的執(zhí)行早于foo
的調(diào)用绽昼。這種行為的本質(zhì)是,import
命令是編譯階段執(zhí)行的明肮,在代碼運(yùn)行之前循未。
由于import
是靜態(tài)執(zhí)行的妖,所以不能使用表達(dá)式和變量嫂粟,這些只有在運(yùn)行時(shí)才能得到結(jié)果的語法結(jié)構(gòu)。
// 報(bào)錯(cuò)
import { 'f' + 'oo' } from 'my_module';
// 報(bào)錯(cuò)
let module = 'my_module';
import { foo } from module;
// 報(bào)錯(cuò)
if (x === 1) {
import { foo } from 'module1';
} else {
import { foo } from 'module2';
}
上面三種寫法都會(huì)報(bào)錯(cuò),因?yàn)樗鼈冇玫搅吮磉_(dá)式媚值、變量和if
結(jié)構(gòu)。在靜態(tài)分析階段锰扶,這些語法都是沒法得到值的坷牛。
最后京闰,import
語句會(huì)執(zhí)行所加載的模塊蹂楣,因此可以有下面的寫法痊土。
import 'lodash';
上面代碼僅僅執(zhí)行lodash
模塊,但是不輸入任何值赞哗。
如果多次重復(fù)執(zhí)行同一句import
語句,那么只會(huì)執(zhí)行一次藤乙,而不會(huì)執(zhí)行多次坛梁。
import 'lodash';
import 'lodash';
上面代碼加載了兩次lodash
拴念,但是只會(huì)執(zhí)行一次。
import { foo } from 'my_module';
import { bar } from 'my_module';
// 等同于
import { foo, bar } from 'my_module';
上面代碼中队魏,雖然foo
和bar
在兩個(gè)語句中加載官帘,但是它們對(duì)應(yīng)的是同一個(gè)my_module
實(shí)例刽虹。也就是說,import
語句是 Singleton 模式馅巷。
目前階段,通過 Babel 轉(zhuǎn)碼草姻,CommonJS 模塊的require
命令和 ES6 模塊的import
命令钓猬,可以寫在同一個(gè)模塊里面,但是最好不要這樣做撩独。因?yàn)?code>import在靜態(tài)解析階段執(zhí)行敞曹,所以它是一個(gè)模塊之中最早執(zhí)行的。下面的代碼可能不會(huì)得到預(yù)期結(jié)果综膀。
require('core-js/modules/es6.symbol');
require('core-js/modules/es6.promise');
import React from 'React';
模塊的整體加載
除了指定加載某個(gè)輸出值澳迫,還可以使用整體加載,即用星號(hào)(*
)指定一個(gè)對(duì)象,所有輸出值都加載在這個(gè)對(duì)象上面。
下面是一個(gè)circle.js
文件减江,它輸出兩個(gè)方法area
和circumference
。
// circle.js
export function area(radius) {
return Math.PI * radius * radius;
}
export function circumference(radius) {
return 2 * Math.PI * radius;
}
現(xiàn)在,加載這個(gè)模塊。
// main.js
import { area, circumference } from './circle';
console.log('圓面積:' + area(4));
console.log('圓周長:' + circumference(14));
上面寫法是逐一指定要加載的方法,整體加載的寫法如下揣云。
import * as circle from './circle';
console.log('圓面積:' + circle.area(4));
console.log('圓周長:' + circle.circumference(14));
注意焚刚,模塊整體加載所在的那個(gè)對(duì)象(上例是circle
)雌团,應(yīng)該是可以靜態(tài)分析的灵寺,所以不允許運(yùn)行時(shí)改變叮称。下面的寫法都是不允許的。
import * as circle from './circle';
// 下面兩行都是不允許的
circle.foo = 'hello';
circle.area = function () {};
export default 命令
從前面的例子可以看出谴古,使用import
命令的時(shí)候瞬测,用戶需要知道所要加載的變量名或函數(shù)名穷躁,否則無法加載梳虽。但是禀挫,用戶肯定希望快速上手匿醒,未必愿意閱讀文檔,去了解模塊有哪些屬性和方法此迅。
為了給用戶提供方便坎怪,讓他們不用閱讀文檔就能加載模塊男应,就要用到export default
命令,為模塊指定默認(rèn)輸出滨达。
// export-default.js
export default function () {
console.log('foo');
}
上面代碼是一個(gè)模塊文件export-default.js
,它的默認(rèn)輸出是一個(gè)函數(shù)诗祸。
其他模塊加載該模塊時(shí)罪塔,import
命令可以為該匿名函數(shù)指定任意名字熟尉。
// import-default.js
import customName from './export-default';
customName(); // 'foo'
上面代碼的import
命令堕油,可以用任意名稱指向export-default.js
輸出的方法,這時(shí)就不需要知道原模塊輸出的函數(shù)名。需要注意的是轿偎,這時(shí)import
命令后面睁冬,不使用大括號(hào)丰涉。
export default
命令用在非匿名函數(shù)前加袋,也是可以的肚邢。
// export-default.js
export default function foo() {
console.log('foo');
}
// 或者寫成
function foo() {
console.log('foo');
}
export default foo;
上面代碼中,foo
函數(shù)的函數(shù)名foo
,在模塊外部是無效的。加載的時(shí)候纪隙,視同匿名函數(shù)加載舆声。
下面比較一下默認(rèn)輸出和正常輸出俩功。
// 第一組
export default function crc32() { // 輸出
// ...
}
import crc32 from 'crc32'; // 輸入
// 第二組
export function crc32() { // 輸出
// ...
};
import {crc32} from 'crc32'; // 輸入
上面代碼的兩組寫法核无,第一組是使用export default
時(shí)冗疮,對(duì)應(yīng)的import
語句不需要使用大括號(hào)诅挑;第二組是不使用export default
時(shí),對(duì)應(yīng)的import
語句需要使用大括號(hào)兜畸。
export default
命令用于指定模塊的默認(rèn)輸出恩沛。顯然穆桂,一個(gè)模塊只能有一個(gè)默認(rèn)輸出,因此export default
命令只能使用一次有额。所以般又,import
命令后面才不用加大括號(hào)彼绷,因?yàn)橹豢赡軐?duì)應(yīng)一個(gè)方法。
本質(zhì)上茴迁,export default
就是輸出一個(gè)叫做default
的變量或方法寄悯,然后系統(tǒng)允許你為它取任意名字。所以堕义,下面的寫法是有效的猜旬。
// modules.js
function add(x, y) {
return x * y;
}
export {add as default};
// 等同于
// export default add;
// app.js
import { default as xxx } from 'modules';
// 等同于
// import xxx from 'modules';
正是因?yàn)?code>export default命令其實(shí)只是輸出一個(gè)叫做default
的變量,所以它后面不能跟變量聲明語句倦卖。
// 正確
export var a = 1;
// 正確
var a = 1;
export default a;
// 錯(cuò)誤
export default var a = 1;
上面代碼中洒擦,export default a
的含義是將變量a
的值賦給變量default
。所以怕膛,最后一種寫法會(huì)報(bào)錯(cuò)熟嫩。
同樣地,因?yàn)?code>export default本質(zhì)是將該命令后面的值褐捻,賦給default
變量以后再默認(rèn)掸茅,所以直接將一個(gè)值寫在export default
之后。
// 正確
export default 42;
// 報(bào)錯(cuò)
export 42;
上面代碼中柠逞,后一句報(bào)錯(cuò)是因?yàn)闆]有指定對(duì)外的接口昧狮,而前一句指定外對(duì)接口為default
。
有了export default
命令板壮,輸入模塊時(shí)就非常直觀了陵且,以輸入 lodash 模塊為例。
import _ from 'lodash';
如果想在一條import
語句中个束,同時(shí)輸入默認(rèn)方法和其他接口慕购,可以寫成下面這樣。
import _, { each, each as forEach } from 'lodash';
對(duì)應(yīng)上面代碼的export
語句如下茬底。
export default function (obj) {
// ···
}
export function each(obj, iterator, context) {
// ···
}
export { each as forEach };
上面代碼的最后一行的意思是沪悲,暴露出forEach
接口,默認(rèn)指向each
接口阱表,即forEach
和each
指向同一個(gè)方法殿如。
export default
也可以用來輸出類。
// MyClass.js
export default class { ... }
// main.js
import MyClass from 'MyClass';
let o = new MyClass();
export 與 import 的復(fù)合寫法
如果在一個(gè)模塊之中最爬,先輸入后輸出同一個(gè)模塊涉馁,import
語句可以與export
語句寫在一起。
export { foo, bar } from 'my_module';
// 等同于
import { foo, bar } from 'my_module';
export { foo, bar };
上面代碼中爱致,export
和import
語句可以結(jié)合在一起烤送,寫成一行。
模塊的接口改名和整體輸出糠悯,也可以采用這種寫法帮坚。
// 接口改名
export { foo as myFoo } from 'my_module';
// 整體輸出
export * from 'my_module';
默認(rèn)接口的寫法如下妻往。
export { default } from 'foo';
具名接口改為默認(rèn)接口的寫法如下。
export { es6 as default } from './someModule';
// 等同于
import { es6 } from './someModule';
export default es6;
同樣地试和,默認(rèn)接口也可以改名為具名接口讯泣。
export { default as es6 } from './someModule';
下面三種import
語句,沒有對(duì)應(yīng)的復(fù)合寫法阅悍。
import * as someIdentifier from "someModule";
import someIdentifier from "someModule";
import someIdentifier, { namedIdentifier } from "someModule";
為了做到形式的對(duì)稱好渠,現(xiàn)在有提案,提出補(bǔ)上這三種復(fù)合寫法节视。
export * as someIdentifier from "someModule";
export someIdentifier from "someModule";
export someIdentifier, { namedIdentifier } from "someModule";
模塊的繼承
模塊之間也可以繼承拳锚。
假設(shè)有一個(gè)circleplus
模塊,繼承了circle
模塊肴茄。
// circleplus.js
export * from 'circle';
export var e = 2.71828182846;
export default function(x) {
return Math.exp(x);
}
上面代碼中的export *
,表示再輸出circle
模塊的所有屬性和方法但指。注意寡痰,export *
命令會(huì)忽略circle
模塊的default
方法。然后棋凳,上面代碼又輸出了自定義的e
變量和默認(rèn)方法拦坠。
這時(shí),也可以將circle
的屬性或方法剩岳,改名后再輸出贞滨。
// circleplus.js
export { area as circleArea } from 'circle';
上面代碼表示,只輸出circle
模塊的area
方法拍棕,且將其改名為circleArea
晓铆。
加載上面模塊的寫法如下。
// main.js
import * as math from 'circleplus';
import exp from 'circleplus';
console.log(exp(math.e));
上面代碼中的import exp
表示绰播,將circleplus
模塊的默認(rèn)方法加載為exp
方法骄噪。
跨模塊常量
本書介紹const
命令的時(shí)候說過,const
聲明的常量只在當(dāng)前代碼塊有效蠢箩。如果想設(shè)置跨模塊的常量(即跨多個(gè)文件)链蕊,或者說一個(gè)值要被多個(gè)模塊共享,可以采用下面的寫法谬泌。
// constants.js 模塊
export const A = 1;
export const B = 3;
export const C = 4;
// test1.js 模塊
import * as constants from './constants';
console.log(constants.A); // 1
console.log(constants.B); // 3
// test2.js 模塊
import {A, B} from './constants';
console.log(A); // 1
console.log(B); // 3
如果要使用的常量非常多滔韵,可以建一個(gè)專門的constants
目錄,將各種常量寫在不同的文件里面掌实,保存在該目錄下陪蜻。
// constants/db.js
export const db = {
url: 'http://my.couchdbserver.local:5984',
admin_username: 'admin',
admin_password: 'admin password'
};
// constants/user.js
export const users = ['root', 'admin', 'staff', 'ceo', 'chief', 'moderator'];
然后,將這些文件輸出的常量贱鼻,合并在index.js
里面囱皿。
// constants/index.js
export {db} from './db';
export {users} from './users';
使用的時(shí)候勇婴,直接加載index.js
就可以了。
// script.js
import {db, users} from './index';
import()
簡介
前面介紹過嘱腥,import
命令會(huì)被 JavaScript 引擎靜態(tài)分析耕渴,先于模塊內(nèi)的其他模塊執(zhí)行(叫做”連接“更合適)。所以齿兔,下面的代碼會(huì)報(bào)錯(cuò)橱脸。
// 報(bào)錯(cuò)
if (x === 2) {
import MyModual from './myModual';
}
上面代碼中,引擎處理import
語句是在編譯時(shí)分苇,這時(shí)不會(huì)去分析或執(zhí)行if
語句添诉,所以import
語句放在if
代碼塊之中毫無意義,因此會(huì)報(bào)句法錯(cuò)誤医寿,而不是執(zhí)行時(shí)錯(cuò)誤栏赴。也就是說,import
和export
命令只能在模塊的頂層靖秩,不能在代碼塊之中(比如须眷,在if
代碼塊之中,或在函數(shù)之中)沟突。
這樣的設(shè)計(jì)花颗,固然有利于編譯器提高效率,但也導(dǎo)致無法在運(yùn)行時(shí)加載模塊惠拭。在語法上扩劝,條件加載就不可能實(shí)現(xiàn)。如果import
命令要取代 Node 的require
方法职辅,這就形成了一個(gè)障礙棒呛。因?yàn)?code>require是運(yùn)行時(shí)加載模塊,import
命令無法取代require
的動(dòng)態(tài)加載功能域携。
const path = './' + fileName;
const myModual = require(path);
上面的語句就是動(dòng)態(tài)加載条霜,require
到底加載哪一個(gè)模塊,只有運(yùn)行時(shí)才知道涵亏。import
語句做不到這一點(diǎn)宰睡。
因此,有一個(gè)提案气筋,建議引入import()
函數(shù)拆内,完成動(dòng)態(tài)加載。
import(specifier)
上面代碼中宠默,import
函數(shù)的參數(shù)specifier
麸恍,指定所要加載的模塊的位置。import
命令能夠接受什么參數(shù),import()
函數(shù)就能接受什么參數(shù)抹沪,兩者區(qū)別主要是后者為動(dòng)態(tài)加載刻肄。
import()
返回一個(gè) Promise 對(duì)象。下面是一個(gè)例子融欧。
const main = document.querySelector('main');
import(`./section-modules/${someVariable}.js`)
.then(module => {
module.loadPageInto(main);
})
.catch(err => {
main.textContent = err.message;
});
import()
函數(shù)可以用在任何地方敏弃,不僅僅是模塊,非模塊的腳本也可以使用噪馏。它是運(yùn)行時(shí)執(zhí)行麦到,也就是說,什么時(shí)候運(yùn)行到這一句欠肾,也會(huì)加載指定的模塊瓶颠。另外,import()
函數(shù)與所加載的模塊沒有靜態(tài)連接關(guān)系刺桃,這點(diǎn)也是與import
語句不相同粹淋。
import()
類似于 Node 的require
方法,區(qū)別主要是前者是異步加載瑟慈,后者是同步加載桃移。
適用場合
下面是import()
的一些適用場合。
(1)按需加載封豪。
import()
可以在需要的時(shí)候谴轮,再加載某個(gè)模塊炒瘟。
button.addEventListener('click', event => {
import('./dialogBox.js')
.then(dialogBox => {
dialogBox.open();
})
.catch(error => {
/* Error handling */
})
});
上面代碼中吹埠,import()
方法放在click
事件的監(jiān)聽函數(shù)之中,只有用戶點(diǎn)擊了按鈕疮装,才會(huì)加載這個(gè)模塊缘琅。
(2)條件加載
import()
可以放在if
代碼塊,根據(jù)不同的情況廓推,加載不同的模塊刷袍。
if (condition) {
import('moduleA').then(...);
} else {
import('moduleB').then(...);
}
上面代碼中,如果滿足條件樊展,就加載模塊 A呻纹,否則加載模塊 B。
(3)動(dòng)態(tài)的模塊路徑
import()
允許模塊路徑動(dòng)態(tài)生成专缠。
import(f())
.then(...);
上面代碼中雷酪,根據(jù)函數(shù)f
的返回結(jié)果,加載不同的模塊涝婉。
注意點(diǎn)
import()
加載模塊成功以后哥力,這個(gè)模塊會(huì)作為一個(gè)對(duì)象,當(dāng)作then
方法的參數(shù)。因此吩跋,可以使用對(duì)象解構(gòu)賦值的語法寞射,獲取輸出接口。
import('./myModule.js')
.then(({export1, export2}) => {
// ...·
});
上面代碼中锌钮,export1
和export2
都是myModule.js
的輸出接口桥温,可以解構(gòu)獲得。
如果模塊有default
輸出接口轧粟,可以用參數(shù)直接獲得策治。
import('./myModule.js')
.then(myModule => {
console.log(myModule.default);
});
上面的代碼也可以使用具名輸入的形式。
import('./myModule.js')
.then(({default: theDefault}) => {
console.log(theDefault);
});
如果想同時(shí)加載多個(gè)模塊兰吟,可以采用下面的寫法通惫。
Promise.all([
import('./module1.js'),
import('./module2.js'),
import('./module3.js'),
])
.then(([module1, module2, module3]) => {
···
});
import()
也可以用在 async 函數(shù)之中。
async function main() {
const myModule = await import('./myModule.js');
const {export1, export2} = await import('./myModule.js');
const [module1, module2, module3] =
await Promise.all([
import('./module1.js'),
import('./module2.js'),
import('./module3.js'),
]);
}
main();