徹底搞清楚javascript中的require、import和export

http://www.cnblogs.com/libin-1/p/7127481.html

爲什麼有模塊概念

理想情況下,開發者只需要實現核心的業務邏輯,其他都可以加載別人已經寫好的模塊。

但是,Javascript不是一種模塊化編程語言,在es6以前,它是不支持”類”(class),所以也就沒有”模塊”(module)了。

require時代

Javascript社區做了很多努力,在現有的運行環境中,實現”模塊”的效果。

原始寫法

模塊就是實現特定功能的一組方法。
只要把不同的函數(以及記錄狀態的變量)簡單地放在一起,就算是一個模塊。

1
2
3
4
5
6
function m1(){
 //...
}
function m2(){
 //...  
}

上面的函數m1()和m2(),組成一個模塊。使用的時候,直接調用就行了。

這種做法的缺點很明顯:”污染”了全局變量,無法保證不與其他模塊發生變量名衝突,而且模塊成員之間看不出直接關係。

對象寫法

爲了解決上面的缺點,可以把模塊寫成一個對象,所有的模塊成員都放到這個對象裏面

1
2
3
4
5
6
7
8
9
var module1 = new Object({
_count : 0,
 m1 : function (){
  //...
 },
 m2 : function (){
  //...
 }
});

上面的函數m1()和m2(),都封裝在module1對象裏。使用的時候,就是調用這個對象的屬性

1
module1.m1();

這樣的寫法會暴露所有模塊成員,內部狀態可以被外部改寫。比如,外部代碼可以直接改變內部計數器的值。

1
module._count = 1;

立即執行函數寫法

使用”立即執行函數”(Immediately-Invoked Function Expression,IIFE),可以達到不暴露私有成員的目的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
var module = (function() {
var _count = 0;
var m1 = function() {
alert(_count)
}
var m2 = function() {
alert(_count + 1)
}
 
return {
m1: m1,
m2: m2
}
})()

使用上面的寫法,外部代碼無法讀取內部的_count變量。

1
  console.info(module._count); //undefined

module就是Javascript模塊的基本寫法。

主流模塊規範

在es6以前,還沒有提出一套官方的規範,從社區和框架推廣程度而言,目前通行的javascript模塊規範有兩種:CommonJS 和 AMD

CommonJS規範

2009年,美國程序員Ryan Dahl創造了node.js項目,將javascript語言用於服務器端編程。

這標誌”Javascript模塊化編程”正式誕生。前端的複雜程度有限,沒有模塊也是可以的,但是在服務器端,一定要有模塊,與操作系統和其他應用程序互動,否則根本沒法編程。

node編程中最重要的思想之一就是模塊,而正是這個思想,讓JavaScript的大規模工程成爲可能。模塊化編程在js界流行,也是基於此,隨後在瀏覽器端,requirejs和seajs之類的工具包也出現了,可以說在對應規範下,require統治了ES6之前的所有模塊化編程,即使現在,在ES6 module被完全實現之前,還是這樣。

在CommonJS中,暴露模塊使用module.exports和exports,很多人不明白暴露對象爲什麼會有兩個,後面會介紹區別

在CommonJS中,有一個全局性方法require(),用於加載模塊。假定有一個數學模塊math.js,就可以像下面這樣加載。

1
var math = require('math');

然後,就可以調用模塊提供的方法:

1
2
 var math = require('math');
 math.add(2,3); // 5

正是由於CommonJS 使用的require方式的推動,纔有了後面的AMD、CMD 也採用的require方式來引用模塊的風格

AMD規範

有了服務器端模塊以後,很自然地,大家就想要客戶端模塊。而且最好兩者能夠兼容,一個模塊不用修改,在服務器和瀏覽器都可以運行。

但是,由於一個重大的侷限,使得CommonJS規範不適用於瀏覽器環境。還是上一節的代碼,如果在瀏覽器中運行,會有一個很大的問題

1
2
var math = require('math');
math.add(2, 3);

第二行math.add(2, 3),在第一行require(‘math’)之後運行,因此必須等math.js加載完成。也就是說,如果加載時間很長,整個應用就會停在那裏等。

這對服務器端不是一個問題,因爲所有的模塊都存放在本地硬盤,可以同步加載完成,等待時間就是硬盤的讀取時間。但是,對於瀏覽器,這卻是一個大問題,因爲模塊都放在服務器端,等待時間取決於網速的快慢,可能要等很長時間,瀏覽器處於”假死”狀態。
因此,瀏覽器端的模塊,不能採用”同步加載”(synchronous),只能採用”異步加載”(asynchronous)。這就是AMD規範誕生的背景。

AMD是”Asynchronous Module Definition”的縮寫,意思就是”異步模塊定義”。它採用異步方式加載模塊,模塊的加載不影響它後面語句的運行。所有依賴這個模塊的語句,都定義在一個回調函數中,等到加載完成之後,這個回調函數纔會運行。

模塊必須採用特定的define()函數來定義。

1
define(id?, dependencies?, factory)
  • id:字符串,模塊名稱(可選)
  • dependencies: 是我們要載入的依賴模塊(可選),使用相對路徑。,注意是數組格式
  • factory: 工廠方法,返回一個模塊函數

如果一個模塊不依賴其他模塊,那麼可以直接定義在define()函數之中。

1
2
3
4
5
6
7
8
9
// math.js
  define(function (){
    var add = function (x,y){
      return x+y;
    };
    return {
      add: add
    };
  });

如果這個模塊還依賴其他模塊,那麼define()函數的第一個參數,必須是一個數組,指明該模塊的依賴性。

1
2
3
4
5
6
7
8
define(['Lib'], function(Lib){
    function foo(){
      Lib.doSomething();
    }
    return {
      foo : foo
    };
  });

當require()函數加載上面這個模塊的時候,就會先加載Lib.js文件。

AMD也採用require()語句加載模塊,但是不同於CommonJS,它要求兩個參數:

1
require([module], callback);

第一個參數[module],是一個數組,裏面的成員就是要加載的模塊;第二個參數callback,則是加載成功之後的回調函數。如果將前面的代碼改寫成AMD形式,就是下面這樣:

1
2
3
require(['math'], function (math) {
 math.add(2, 3);
});

math.add()與math模塊加載不是同步的,瀏覽器不會發生假死。所以很顯然,AMD比較適合瀏覽器環境。

目前,主要有兩個Javascript庫實現了AMD規範:require.jscurl.js

CMD規範

CMD (Common Module Definition), 是seajs推崇的規範,CMD則是依賴就近,用的時候再require。它寫起來是這樣的:

1
2
3
4
define(function(require, exports, module) {
var clock = require('clock');
clock.start();
});

CMD與AMD一樣,也是採用特定的define()函數來定義,用require方式來引用模塊

1
define(id?, dependencies?, factory)
  • id:字符串,模塊名稱(可選)
  • dependencies: 是我們要載入的依賴模塊(可選),使用相對路徑。,注意是數組格式
  • factory: 工廠方法,返回一個模塊函數
1
2
3
4
5
define('hello', ['jquery'], function(require, exports, module) {
 
// 模塊代碼
 
});

如果一個模塊不依賴其他模塊,那麼可以直接定義在define()函數之中。

1
2
3
define(function(require, exports, module) {
// 模塊代碼
});

注意:帶 id 和 dependencies 參數的 define 用法不屬於 CMD 規範,而屬於 Modules/Transport 規範。

CMD與AMD區別

AMD和CMD最大的區別是對依賴模塊的執行時機處理不同,而不是加載的時機或者方式不同,二者皆爲異步加載模塊。

AMD依賴前置,js可以方便知道依賴模塊是誰,立即加載;

而CMD就近依賴,需要使用把模塊變爲字符串解析一遍才知道依賴了那些模塊,這也是很多人詬病CMD的一點,犧牲性能來帶來開發的便利性,實際上解析模塊用的時間短到可以忽略。

現階段的標準

ES6標準發佈後,module成爲標準,標準使用是以export指令導出接口,以import引入模塊,但是在我們一貫的node模塊中,我們依然採用的是CommonJS規範,使用require引入模塊,使用module.exports導出接口。

export導出模塊

export語法聲明用於導出函數、對象、指定文件(或模塊)的原始值。

注意:在node中使用的是exports,不要混淆了

export有兩種模塊導出方式:命名式導出(名稱導出)默認導出(定義式導出),命名式導出每個模塊可以多個,而默認導出每個模塊僅一個。

1
2
3
4
5
6
7
8
9
10
11
12
13
export { name1, name2, …, nameN };
export { variable1 as name1, variable2 as name2, …, nameN };
export let name1, name2, …, nameN; // also var
export let name1 = …, name2 = …, …, nameN; // also var, const
 
export default expression;
export default function (…) { … } // also class, function*
export default function name1(…) { … } // also class, function*
export { name1 as default, … };
 
export * from …;
export { name1, name2, …, nameN } from …;
export { import1 as name1, import2 as name2, …, nameN } from …;
  • name1… nameN-導出的“標識符”。導出後,可以通過這個“標識符”在另一個模塊中使用import引用
  • default-設置模塊的默認導出。設置後import不通過“標識符”而直接引用默認導入
  • -繼承模塊並導出繼承模塊所有的方法和屬性
  • as-重命名導出“標識符”
  • from-從已經存在的模塊、腳本文件…導出

命名式導出

模塊可以通過export前綴關鍵詞聲明導出對象,導出對象可以是多個。這些導出對象用名稱進行區分,稱之爲命名式導出。

1
2
export { myFunction }; // 導出一個已定義的函數
export const foo = Math.sqrt(2); // 導出一個常量

我們可以使用*和from關鍵字來實現的模塊的繼承:

1
export * from 'article';

模塊導出時,可以指定模塊的導出成員。導出成員可以認爲是類中的公有對象,而非導出成員可以認爲是類中的私有對象:

1
2
3
4
5
var name = 'IT筆錄';
var domain = 'http://itbilu.com';
 
export {name, domain}; // 相當於導出
{name:name,domain:domain}

模塊導出時,我們可以使用as關鍵字對導出成員進行重命名:

1
2
3
4
var name = 'IT筆錄';
var domain = 'http://itbilu.com';
 
export {name as siteName, domain};

注意,下面的語法有嚴重錯誤的情況:

1
2
3
4
5
// 錯誤演示
export 1; // 絕對不可以
 
var a = 100;
export a;

 

export在導出接口的時候,必須與模塊內部的變量具有一一對應的關係。直接導出1沒有任何意義,也不可能在import的時候有一個變量與之對應

export a雖然看上去成立,但是a的值是一個數字,根本無法完成解構,因此必須寫成export {a}的形式。即使a被賦值爲一個function,也是不允許的。而且,大部分風格都建議,模塊中最好在末尾用一個export導出所有的接口,例如:

1
export {fun as default,a,b,c};

默認導出

默認導出也被稱做定義式導出。命名式導出可以導出多個值,但在在import引用時,也要使用相同的名稱來引用相應的值。而默認導出每個導出只有一個單一值,這個輸出可以是一個函數、類或其它類型的值,這樣在模塊import導入時也會很容易引用。

1
2
export default function() {}; // 可以導出一個函數
export default class(){}; // 也可以出一個類

命名式導出與默認導出

默認導出可以理解爲另一種形式的命名導出,默認導出可以認爲是使用了default名稱的命名導出。

下面兩種導出方式是等價的:

1
2
3
4
const D = 123;
 
export default D;
export { D as default };

export使用示例

使用名稱導出一個模塊時:

1
2
3
4
5
6
// "my-module.js" 模塊
export function cube(x) {
return x * x * x;
}
const foo = Math.PI + Math.SQRT2;
export { foo };

在另一個模塊(腳本文件)中,我們可以像下面這樣引用:

1
2
3
import { cube, foo } from 'my-module';
console.log(cube(3)); // 27
console.log(foo); // 4.555806215962888

使用默認導出一個模塊時:

1
2
3
4
// "my-module.js"模塊
export default function (x) {
return x * x * x;
}

在另一個模塊(腳本文件)中,我們可以像下面這樣引用,相對名稱導出來說使用更爲簡單:

1
2
3
// 引用 "my-module.js"模塊
import cube from 'my-module';
console.log(cube(3)); // 27

import引入模塊

import語法聲明用於從已導出的模塊、腳本中導入函數、對象、指定文件(或模塊)的原始值。

import模塊導入與export模塊導出功能相對應,也存在兩種模塊導入方式:命名式導入(名稱導入)和默認導入(定義式導入)。

import的語法跟require不同,而且import必須放在文件的最開始,且前面不允許有其他邏輯代碼,這和其他所有編程語言風格一致。

1
2
3
4
5
6
7
8
9
import defaultMember from "module-name";
import * as name from "module-name";
import { member } from "module-name";
import { member as alias } from "module-name";
import { member1 , member2 } from "module-name";
import { member1 , member2 as alias2 , [...] } from "module-name";
import defaultMember, { member [ , [...] ] } from "module-name";
import defaultMember, * as name from "module-name";
import "module-name";
  • name-從將要導入模塊中收到的導出值的名稱
  • member, memberN-從導出模塊,導入指定名稱的多個成員
  • defaultMember-從導出模塊,導入默認導出成員
  • alias, aliasN-別名,對指定導入成員進行的重命名
  • module-name-要導入的模塊。是一個文件名
  • as-重命名導入成員名稱(“標識符”)
  • from-從已經存在的模塊、腳本文件等導入

命名式導入

我們可以通過指定名稱,就是將這些成員插入到當作用域中。導出時,可以導入單個成員或多個成員:

注意,花括號裏面的變量與export後面的變量一一對應

1
2
import {myMember} from "my-module";
import {foo, bar} from "my-module";

通過*符號,我們可以導入模塊中的全部屬性和方法。當導入模塊全部導出內容時,就是將導出模塊(’my-module.js’)所有的導出綁定內容,插入到當前模塊(’myModule’)的作用域中:

1
import * as myModule from "my-module";

導入模塊對象時,也可以使用as對導入成員重命名,以方便在當前模塊內使用:

1
import {reallyReallyLongModuleMemberName as shortName} from "my-module";

導入多個成員時,同樣可以使用別名:

1
import {reallyReallyLongModuleMemberName as shortName, anotherLongModuleName as short} from "my-module";

導入一個模塊,但不進行任何綁定:

1
import "my-module";

默認導入

在模塊導出時,可能會存在默認導出。同樣的,在導入時可以使用import指令導出這些默認值。

直接導入默認值:

1
import myDefault from "my-module";

也可以在命名空間導入和名稱導入中,同時使用默認導入:

1
2
3
4
import myDefault, * as myModule from "my-module"; // myModule 做爲命名空間使用
 
import myDefault, {foo, bar} from "my-module"; // 指定成員導入

import使用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// --file.js--
function getJSON(url, callback) {
let xhr = new XMLHttpRequest();
xhr.onload = function () {
callback(this.responseText)
};
xhr.open("GET", url, true);
xhr.send();
}
 
export function getUsefulContents(url, callback) {
getJSON(url, data => callback(JSON.parse(data)));
}
 
// --main.js--
import { getUsefulContents } from "file";
getUsefulContents("http://itbilu.com", data => {
doSomethingUseful(data);
});

default關鍵字

1
2
3
4
5
6
// d.js
export default function() {}
 
// 等效於:
function a() {};
export {a as default};

在import的時候,可以這樣用:

1
2
3
4
import a from './d';
 
// 等效於,或者說就是下面這種寫法的簡寫,是同一個意思
import {default as a} from './d';

這個語法糖的好處就是import的時候,可以省去花括號{}。

簡單的說,如果import的時候,你發現某個變量沒有花括號括起來(沒有*號),那麼你在腦海中應該把它還原成有花括號的as語法。

所以,下面這種寫法你也應該理解了吧:

1
import $,{each,map} from 'jquery';

import後面第一個$是{defalut as $}的替代寫法。

as關鍵字

as簡單的說就是取一個別名,export中可以用,import中其實可以用:

1
2
3
4
5
6
7
// a.js
var a = function() {};
export {a as fun};
 
// b.js
import {fun as a} from './a';
a();

上面這段代碼,export的時候,對外提供的接口是fun,它是a.js內部a這個函數的別名,但是在模塊外面,認不到a,只能認到fun。

import中的as就很簡單,就是你在使用模塊裏面的方法的時候,給這個方法取一個別名,好在當前的文件裏面使用。之所以是這樣,是因爲有的時候不同的兩個模塊可能通過相同的接口,比如有一個c.js也通過了fun這個接口:

1
2
// c.js
export function fun() {};

如果在b.js中同時使用a和c這兩個模塊,就必須想辦法解決接口重名的問題,as就解決了。

CommonJS中module.exports 與 exports的區別

Module.exports

The module.exports object is created by the Module system. Sometimes this is not acceptable; many want their module to be an instance of some class. To do this, assign the desired export object to module.exports. Note that assigning the desired object to exports will simply rebind the local exports variable, which is probably not what you want to do.

譯文:module.exports對象是由模塊系統創建的。 有時這是難以接受的;許多人希望他們的模塊成爲某個類的實例。 爲了實現這個,需要將期望導出的對象賦值給module.exports。 注意,將期望的對象賦值給exports會簡單地重新綁定到本地exports變量上,這可能不是你想要的。

Module.exports

The exports variable is available within a module’s file-level scope, and is assigned the value of module.exports before the module is evaluated. It allows a shortcut, so that module.exports.f = … can be written more succinctly as exports.f = …. However, be aware that like any variable, if a new value is assigned to exports, it is no longer bound to module.exports:

譯文:exports變量是在模塊的文件級別作用域內有效的,它在模塊被執行前被賦於 module.exports 的值。它有一個快捷方式,以便 module.exports.f = … 可以被更簡潔地寫成exports.f = …。 注意,就像任何變量,如果一個新的值被賦值給exports,它就不再綁定到module.exports(其實是exports.屬性會自動掛載到沒有命名衝突的module.exports.屬性)

Api文檔上面的可以看出,從require導入方式去理解,關鍵有兩個變量(全局變量module.exports,局部變量exports)、一個返回值(module.exports)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
function require(...) {
var module = { exports: {} };
((module, exports) => {
// 你的被引入代碼 Start
// var exports = module.exports = {}; (默認都有的)
function some_func() {};
exports = some_func;
// 此時,exports不再掛載到module.exports,
// export將導出{}默認對象
module.exports = some_func;
// 此時,這個模塊將導出some_func對象,覆蓋exports上的some_func
// 你的被引入代碼 End
})(module, module.exports);
// 不管是exports還是module.exports,最後返回的還是module.exports
return module.exports;
}

demo.js:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
console.log(exports); // {}
console.log(module.exports); // {}
console.log(exports === module.exports); // true
console.log(exports == module.exports); // true
console.log(module);
/**
Module {
id: '.',
exports: {},
parent: null,
filename: '/Users/larben/Desktop/demo.js',
loaded: false,
children: [],
paths:
'/Users/larben/Desktop/node_modules',
'/Users/larben/node_modules',
'/Users/node_modules',
'/node_modules' ] }
*/

注意

    1. 每個js文件一創建,都有一個var exports = module.exports = {},使exports和module.exports都指向一個空對象。
    2. module.exports和exports所指向的內存地址相同

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章