es6 import 与 export

1、export 命令

export 命令用于规定模块的对外接口。

一个模块就是一个独立的文件。该文件内部所有的变量，外部无法获取。要想外部能够读取模块内部的某个变量，就必须使用 export 关键字输出该变量。

语法：

 1 export { name1, name2, …, nameN };
 2 export { variable1 as name1, variable2 as name2, …, nameN };
 3 export let name1, name2, …, nameN; // also var
 4 export let name1 = …, name2 = …, …, nameN; // also var, const
 5 
 6 export default expression;
 7 export default function (…) { … } // also class, function*
 8 export default function name1(…) { … } // also class, function*
 9 export { name1 as default, … };
10 
11 export * from …;
12 export { name1, name2, …, nameN } from …;
13 export { import1 as name1, import2 as name2, …, nameN } from …;

nameN ---> 导出的标识符（用来被其它脚本的 import 导入）

//aa.js

export var firstName = "Muhan"
export var lastName = "Wu"
export var year = 2017

在 aa.js 文件中，保存了用户信息，es6 将其视为一个模块，用 export 命令对外输出 3 个变量。我们还可以用另外一种写法来实现

//aa.js

var firstName = "Muhan"
var lastName = "Wu"
var year = 2017

export {firstName, lastName, year}

这种写法在 export 命令后面使用大括号指定所要输出的一组变量，应该被优先考虑，因为这样就可以在脚本尾部，一眼看清楚输出了哪些变量

export 命令除了输出变量，还可以输出函数或类（Class）

在 my-module.js 模块里，我们可以这样导出

// my-module.js

export function cube(x) {
  return x*x*x
}

const foo = Math.PI + Math.SQRT2
export {foo}

在其它脚本，我们可以这样导入：

import {cube, foo} from './my-module.js'

console.log( cube(3) ) // 27
console.log( foo )  // 4.555806215962888

通常情况下，export 输出的变量就是本来的名字，但是可以使用 as 关键字来重命名

// my-module.js

function aa () {
  console.log('My name is Kobe Bryant')
}

function bb () {
  console.log('I am one of the best players in NBA history')
}

export {
  aa as personName,
  bb as selfIntro,
  bb as selfEvaluation

上面代码使用 as 关键字，重命名了函数 aa 和 bb 的对外接口。重命名后，bb 可以用不同的名字输出两次

import {personName, selfIntro, selfEvaluation} from './my-module'

personName()  // My name is Kobe Bryant
selfIntro()   // I am one of the best players in NBA history
selfEvaluation()   // I am one of the best players in NBA history

注意：

（1）、export 命令规定的对外接口，必须与模块内部的变量建立一一对应的关系

// 报错，SyntaxError
export 1

// 报错，SyntaxError
var m = 1
export m

/* ================================= */

// 正确写法一
export var m = 1


// 正确写法二
var m = 1
export {m}


// 正确写法三
var m = 1
export {m as num}

// 报错
function myFun () {
  // ...
}

export myFun


// 正确写法一
export function myFun () {
  // ...
}


// 正确写法二
function myFun () {
  // ...
}

export {myFun}

（2）、export 命令可以出现在模块的任何位置，只要处于模块顶层就可以。如果处于块级作用域内，就会报错（同样适用于 import 命令）

function foo() {
  export default 'bar' // SyntaxError
}
foo()

// Module build failed: SyntaxError: 'import' and 'export' may only appear at the top level 

2、import 命令

import 用于从一个已经导出的外部模块或另一个脚本中导入函数，对象或原始类型

使用 export 命令定义了模块的对外接口以后，其它 js 文件就可以通过 import 命令加载这个模块

语法：

1 import defaultMember from "module-name"; 
2 import * as name from "module-name"; 
3 import { member } from "module-name"; 
4 import { member as alias } from "module-name"; 
5 import { member1 , member2 } from "module-name"; 
6 import { member1 , member2 as alias2 , [...] } from "module-name"; 
7 import defaultMember, { member [ , [...] ] } from "module-name"; 
8 import defaultMember, * as name from "module-name"; 
9 import "module-name";

defaultMember

将引用从模块默认导出的名称

module-name

要导入的模块的名称

name

是将引用导出成员的名称，指向导入模块的对象的名称

member，memberN

指定独立成员，将要导入的导出成员的名称

alias，aliasN

将引用命名导入的名称

// my-module.js

var firstName = "Muhan",
    lastName = "Wu",
    year = 2017;

export {firstName, lastName, year}


// 引用模块
import {firstName, lastName, year} from './my-module'

console.log('My name is '+firstName+lastName+ ', I am '+year+' years old!')   // My name is MuhanWu, I am 2017 years old!

同 export 命令一样，如果想为输入的变量重新取一个名字，import 命令要使用 as 关键字，将输入的变量重命名

// my-module.js

var aa = "Kobe Bryant"

export {aa}

---------------------------------------------------------------

import {aa as name} from './my-module'

console.log('My name is '+ name)   // My name is Kobe Bryant

注意：

（1）、import 命令具有提升效果，会提升到整个模块的头部，首先执行

// my-module.js

var aa = "Kobe Bryant"

export {aa}

------------------------------------------------------

console.log('My name is '+ aa)   // My name is Kobe Bryant

import {aa } from './my-module'

上面的代码没有报错，因为 import 的执行早于 aa的调用

（2）、由于 import 是静态执行，所以不能使用表达式和变量，这些只有在运行时才能得到结果的语法结构

// 报错
import { 'f' + 'oo' } from 'my_module';

// 报错
let module = 'my_module';
import { foo } from module;

// 报错
if (x === 1) {
  import { foo } from 'module1';
} else {
  import { foo } from 'module2';
}

（3）、如果多次重复执行同一句 import 语句，那么只会执行一次，不会执行多次

import { foo } from 'my_module';
import { bar } from 'my_module';

// 等同于
import { foo, bar } from 'my_module';

3、export default 命令

从前面的例子可以看出，使用import命令的时候，用户需要知道所要加载的变量名或函数名，否则无法加载。但是，用户肯定希望快速上手，未必愿意阅读文档，去了解模块有哪些属性和方法。

为了给用户提供方便，让他们不用阅读文档就能加载模块，就要用到export default命令，为模块指定默认输出

// my-module.js    默认输出是一个函数

export default function () {
  console.log('export default')
}

------------------------------------------------------------

// 其他模块加载该模块时，import命令可以为该匿名函数指定任意名字

import aaa from './my-module'

aaa()   // export default

上面的 import 命令，可以用任意名称指向 my-module.js 输出的方法，这时就不需要知道原模块输出的函数名。需要注意的是，这时 import 命令后面，不适用大括号

export default 命令用在非匿名函数前，也是可以的

// my-module.js    默认输出是一个函数

export default function myFun () {
  console.log('Hello World!')
}

// 或者写成
function myFun () {
  console.log('Hello World!')
}

export default myFun

----------------------------------------------------------------

import myFun from './my-module'

myFun()   // Hello World!

上面代码中，foo函数的函数名foo，在模块外部是无效的。加载的时候，视同匿名函数加载。

下面比较一下默认输出和正常输出

// 第一组
export default function crc32() { // 输出
  // ...
}

import crc32 from 'crc32'; // 输入

// 第二组
export function crc32() { // 输出
  // ...
};

import {crc32} from 'crc32'; // 输入

上面代码的两组写法，第一组是使用export default时，对应的import语句不需要使用大括号；第二组是不使用export default时，对应的import语句需要使用大括号

一个模块只能有一个默认输出，所以 export default 命令只能使用一次，正因为如此，import 命令后面才可以不用加大括号。本质上，export default就是输出一个叫做default的变量或方法，然后系统允许你为它取任意名字。所以，下面的写法是有效的。

// 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';

下面代码中，export default a的含义是将变量a的值赋给变量default。所以，最后一种写法会报错。

// 正确
export var a = 1;

// 正确
var a = 1;
export default a;

// 错误
export default var a = 1;

同样地，因为export default本质是将该命令后面的值，赋给default变量以后再默认，所以直接将一个值写在export default之后

// 正确
export default 42;  // 指定对外接口为 default

// 报错
export 42;  // 没有指定对外的接口

注意：import 和 export 目前无法直接在浏览器中实现，而是需要通过转换器，如：Traceur Compiler、Babel、RollUp或 Webpack