export
export
命令用于规定模块的对外接口, import
命令用于输入其他模块提供的功能。
一个模块就是一个独立的文件。该文件内部的所有变量,外部无法获取。如果你希望外部能够读取模块内部的某个变量,就必须使用 export
关键字输出该变量。下面是一个 JS 文件,里面使用 export
命令输出变量:
// profile.js
export var firstName = "Michael";
export var lastName = "Jackson";
export var year = 1958;
ES6将其视为一个模块,里面用 export
命令对外部输出了三个变量。
export
还有另外一种写法:
// profile.js
var firstName = 'Michael';
var lastName = 'Jackson';
var year = 1958;
export {firstName, lastName, year};
export
除了输出变量,还可以输出函数或类:
export function multiply(x, y) {
return x * y;
}
需要特别注意的是, export
命令规定的是对外的接口,必须与模块内部的变量建立一一对应关系。
// 报错
export 1;
// 报错
var m = 1;
export m;
上面两种写法都会报错,因为没有提供对外的接口。第一种写法直接输出 1,第二种写法通过变量m
,还是直接输出 1。 1
只是一个值,不是接口。正确的写法是下面这样。
// 写法一
export var m = 1;
// 写法二
var m = 1;
export {m};
// 写法三
var n = 1;
export {n as m};
上面三种写法都是正确的,规定了对外的接口 m
。其他脚本可以通过这个接口,取到值 1
。它们的实质是,在接口名与模块内部变量之间,建立了一一对应的关系。
同样的, function
和 class
的输出,也必须遵守这样的写法。
// 报错
function f() {}
export f;
// 正确
export function f() {};
// 正确
function f() {}
export {f};
最后, export
命令可以出现在模块的任何位置,只要处于模块顶层就可以。如果处于块级作用域内,就会报错,下一节的 import
命令也是如此。这是因为处于条件代码块之中,就没法做静态优化了,违背了 ES6 模块的设计初衷。
function foo() {
export default 'bar' // SyntaxError
}
foo()
上面代码中,export
语句放在函数之中,结果报错。
import
使用 export
命令定义了模块的对外接口以后,其它js文件就可以通过 import
命令加载这个模块:
// main.js
import {firstName, lastName, year} from "./profile.js";
function setName(element) {
element.textContent = firstName + "" + lastName;
}
上面的 import
命令,用于加载 profile.js
文件,并从中输入变量。 import
命令接受一对大括号,里面指定要从其他模块导入的变量名。大括号里面的变量名,必须与被导入模块( profile.js
)对外接口的名称相同。
如果想为输入的变量重新取一个名字, import
命令要使用 as
关键字,将输入的变量重命名:
import {lastName as surname} from "./profile.js";
import
命令输入的变量都是只读的,因为它的本质是输入接口。也就是说,不允许在加载模块的脚本里,改写接口:
import {a} from "./xxx.js";
a = {}; // Syntax Error : "a" is read-only;
如果 a
是一个对象,改写 a
的属性是允许的:
import {a} from "./xxx.js";
a.foo = "Hello"; // 合法操作
上面代码中, a
的属性可以改写成功,并且其他模块也可以读到改写后的值。不过,这种写法很难查错,建议凡是输入的变量,都当作完全只读,轻易不要改变它的属性。
模块的整体加载
除了指定加载某个输出值,还可以使用整体加载。即用 *
指定一个对象,所有输出值都加载在这个对象上:
// circle.js
export function area(radius) {
return Math.PI * radius * radius;
}
export function circumference(radius) {
return 2 * Math.PI * radius;
}
现在加载这个模块:
// main.js
import {area, circumference} from "./circle";
console.log("area : " + area(4));
console.log("circumference : " + circumference(4));
上面写法是逐一指定要加载的方法,整体加载的写法如下:
import * as circle from "./circle";
console.log("area : " + circle.area(4));
console.log("circumference : " + circle.circumference(4));
export default
// export-default.js
export default function() {
console.log("foo");
}
上面代码是一个模块文件 export-default.js
,它的默认输出是一个函数。
其它模块加载该模块时, import
命令可以为该匿名函数指定任意名字:
// import-default.js
import customName from "./export-default";
customName(); // "foo"
上面代码的 import
命令,可以使用任意名称指向 export-default.js
输出的方法。需要注意的是, 这时 import
命令后面,不适用大括号。
export default
也可以用来输出类:
// MyClass.js
export default class {...}
// main.js
import MyClass from "MyClass";
let o = new MyClass();