子產品化曆史
一、原始寫法
function m1(){
//...
}
function m2(){
//...
}
二、對象寫法
var module1 = new Object({
_count : 0,
m1 : function (){
//...
},
m2 : function (){
//...
}
});
這樣的寫法會暴露所有子產品成員,内部狀态可以被外部改寫。比如,外部代碼可以直接改變内部計數器的值。
三、立即執行函數寫法
var module1 = (function(){
var _count = 0;
var m1 = function(){
//...
};
var m2 = function(){
//...
};
return {
m1 : m1,
m2 : m2
};
})();
Javascript子產品的基本寫法。
四、放大模式
var module = (function (mod){
mod.m3 = function () {
//...
};
return mod;
})(module);
上面的代碼為
module
子產品添加了一個新方法
m3()
,然後傳回新的
module
子產品。
五、寬放大模式(Loose augmentation)
var module1 = ( function (mod){
//...
return mod;
})(window.module1 || {});
在浏覽器環境中,子產品的各個部分通常都是從網上擷取的,有時無法知道哪個部分會先加載。如果采用上一節的寫法,第一個執行的部分有可能加載一個不存在空對象,這時就要采用"寬放大模式"。
六、輸入全局變量
var module = (function ($, YAHOO) {
//...
})(jQuery, YAHOO);
獨立性是子產品的重要特點,子產品内部最好不與程式的其他部分直接互動。為了在子產品内部調用全局變量,必須顯式地将其他變量輸入子產品。上面的
module
子產品需要使用
jQuery
庫和
YUI
庫,就把這兩個庫(其實是兩個子產品)當作參數輸入
module
。這樣做除了保證子產品的獨立性,還使得子產品之間的依賴關系變得明顯。
CommonJS規範
NodeJS是CommonJS規範的實作,webpack 也是以CommonJS的形式來書寫。
簡單應用
var math = require('math');
math.add(2,3); // 5
原理
浏覽器不相容CommonJS的根本原因,在于缺少四個Node.js環境的變量.
module
exports
require
global
隻要能夠提供這四個變量,浏覽器就能加載 CommonJS 子產品。
var module = {
exports: {}
};
(function(module, exports) {
exports.multiply = function (n) { return n * 1000 };
}(module, module.exports))
var f = module.exports.multiply;
f(5) // 5000
上面代碼向一個立即執行函數提供 module 和 exports 兩個外部變量,子產品就放在這個立即執行函數裡面。子產品的輸出值放在 module.exports 之中,這樣就實作了子產品的加載。
2、Browserify 的實作
知道了原理,就能做出工具了。Browserify是目前最常用的
CommonJS
格式轉換的工具。
請看一個例子,
main.js
子產品加載
foo.js
子產品。
// foo.js
module.exports = function(x) {
console.log(x);
};
// main.js
var foo = require("./foo");
foo("Hi");
使用下面的指令,就能将main.js轉為浏覽器可用的格式。
$ browserify main.js > compiled.js
Browserify到底做了什麼?安裝一下browser-unpack,就能看清楚了。
$ npm install browser-unpack -g
然後,将前面生成的compile.js解包。
$ browser-unpack < compiled.js
[
{
"id":1,
"source":"module.exports = function(x) {\n console.log(x);\n};",
"deps":{}
},
{
"id":2,
"source":"var foo = require(\"./foo\");\nfoo(\"Hi\");",
"deps":{"./foo":1},
"entry":true
}
]
可以看到,
browerify
将所有子產品放入一個數組,
id
屬性是子產品的編号,
source
屬性是子產品的源碼,
deps
屬性是子產品的依賴。
因為
main.js
裡面加載了
foo.js
,是以
deps
屬性就指定
./foo
對應1号子產品。執行的時候,浏覽器遇到
require('./foo')
語句,就自動執行1号子產品的
source
屬性,并将執行後的
module.exports
屬性值輸出。
3、Tiny Browser Require
雖然
Browserify
很強大,但不能在浏覽器裡操作,有時就很不友善。
我根據
mocha
的内部實作,做了一個純浏覽器的
CommonJS
子產品加載器tiny-browser-require。完全不需要指令行,直接放進浏覽器即可,所有代碼隻有30多行。
它的邏輯非常簡單,就是把子產品讀入數組,加載路徑就是子產品的id。
function require(p){
var path = require.resolve(p);
var mod = require.modules[path];
if (!mod) throw new Error('failed to require "' + p + '"');
if (!mod.exports) {
mod.exports = {};
mod.call(mod.exports, mod, mod.exports, require.relative(path));
}
return mod.exports;
}
require.modules = {};
require.resolve = function (path){
var orig = path;
var reg = path + '.js';
var index = path + '/index.js';
return require.modules[reg] && reg
|| require.modules[index] && index
|| orig;
};
require.register = function (path, fn){
require.modules[path] = fn;
};
require.relative = function (parent) {
return function(p){
if ('.' != p.charAt(0)) return require(p);
var path = parent.split('/');
var segs = p.split('/');
path.pop();
for (var i = 0; i < segs.length; i++) {
var seg = segs[i];
if ('..' == seg) path.pop();
else if ('.' != seg) path.push(seg);
}
return require(path.join('/'));
};
};
使用的時候,先将上面的代碼放入頁面。然後,将子產品放在如下的立即執行函數裡面,就可以調用了。
<script src="require.js" /><script>
require.register("moduleId", function(module, exports, require){
// Module code goes here
});
var result = require("moduleId");
</script>
還是以前面的
main.js
加載
foo.js
為例。
require.register("./foo.js", function(module, exports, require){
module.exports = function(x) {
console.log(x);
};
});
var foo = require("./foo.js");
foo("Hi");
注意,這個庫隻模拟了
require
、
module
、
exports
三個變量,如果子產品還用到了
global
或者其他
Node
專有變量(比如
process
),就通過立即執行函數提供即可。
加載機制
CommonJS子產品的加載機制是,輸入的是被輸出的值的拷貝。也就是說,一旦輸出一個值,子產品内部的變化就影響不到這個值,但是引用類型的資料,如對象,數組還是會受影響。
AMD規範
因為CommonJS規範是同步的,如果加載時間很長,整個應用就會停在那裡等。這對伺服器端不是一個問題,因為所有的子產品都存放在本地硬碟,可以同步加載完成,等待時間就是硬碟的讀取時間。但是,對于浏覽器,這卻是一個大問題,因為子產品都放在伺服器端,等待時間取決于網速的快慢,可能要等很長時間,浏覽器處于"假死"狀态。
是以,浏覽器端的子產品,不能采用"同步加載"(synchronous),隻能采用"異步加載"(asynchronous)。這就是AMD規範誕生的背景。
CommonJS是主要為了JS在後端的表現制定的,他是不适合前端的,AMD(異步子產品定義)出現了,它就主要為前端JS的表現制定規範。
AMD是"Asynchronous Module Definition"的縮寫,意思就是"異步子產品定義"。它采用異步方式加載子產品,子產品的加載不影響它後面語句的運作。所有依賴這個子產品的語句,都定義在一個回調函數中,等到加載完成之後,這個回調函數才會運作。
AMD也采用require()語句加載子產品,但是不同于CommonJS,它要求兩個參數:
require([module], callback);
第一個參數[module],是一個數組,裡面的成員就是要加載的子產品;第二個參數callback,則是加載成功之後的回調函數。如果将前面的代碼改寫成AMD形式,就是下面這樣:
require(['math'], function (math) {
math.add(2, 3);
});
math.add()與math子產品加載不是同步的,浏覽器不會發生假死。是以很顯然,AMD比較适合浏覽器環境。目前,主要有兩個Javascript庫實作了AMD規範:require.js和curl.js。
詳細概括:下面以RequireJS為例說明AMD規範
require.js的誕生,就是為了解決這兩個問題:
一、為什麼要用require.js?
(1)實作js檔案的異步加載,避免網頁失去響應;
(2)管理子產品之間的依賴性,便于代碼的編寫和維護。
二、require.js的加載
<script src="js/require.js" defer async="true" ></script>
加載require.js以後,下一步就要加載我們自己的代碼了。假定我們自己的代碼檔案是main.js,也放在js目錄下面。那麼,隻需要寫成下面這樣就行了:
<script src="js/require.js" data-main="js/main"></script>
data-main屬性的作用是,指定網頁程式的主子產品。在上例中,就是js目錄下面的main.js,這個檔案會第一個被require.js加載。由于require.js預設的檔案字尾名是js,是以可以把main.js簡寫成main。
三、主子產品的寫法
// main.js
require(['moduleA', 'moduleB', 'moduleC'], function (moduleA, moduleB, moduleC){
// some code here
});
require.js會先加載jQuery、underscore和backbone,然後再運作回調函數。主子產品的代碼就寫在回調函數中。
四、子產品的加載
上一節最後的示例中,主子產品的依賴子產品是[‘jquery’, ‘underscore’, ‘backbone’]。預設情況下,require.js假定這三個子產品與main.js在同一個目錄,檔案名分别為jquery.js,underscore.js和backbone.js,然後自動加載。
使用require.config()方法,我們可以對子產品的加載行為進行自定義。require.config()就寫在主子產品(main.js)的頭部。參數就是一個對象,這個對象的paths屬性指定各個子產品的加載路徑。
require.config({
paths: {
"jquery": "lib/jquery.min",
"underscore": "lib/underscore.min",
"backbone": "lib/backbone.min"
}
});
require.config({
baseUrl: "js/lib",
paths: {
"jquery": "jquery.min",
"underscore": "underscore.min",
"backbone": "backbone.min"
}
});
require.config({
paths: {
"jquery": "https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min"
}
});
require.js要求,每個子產品是一個單獨的js檔案。這樣的話,如果加載多個子產品,就會發出多次HTTP請求,會影響網頁的加載速度。是以,require.js提供了一個優化工具,當子產品部署完畢以後,可以用這個工具将多個子產品合并在一個檔案中,減少HTTP請求數。
五、AMD子產品的寫法
require.js加載的子產品,采用AMD規範。也就是說,子產品必須按照AMD的規定來寫。
具體來說,就是子產品必須采用特定的define()函數來定義。如果一個子產品不依賴其他子產品,那麼可以直接定義在define()函數之中。
簡單示例
define(function(){
var exports = {};
exports.method = function(){...};
return exports;
});
假定現在有一個math.js檔案,它定義了一個math子產品。那麼,math.js就要這樣寫:
// math.js
define(function (){
var add = function (x,y){
return x+y;
};
return {
add: add
};
});
加載方法如下:
// main.js
require(['math'], function (math){
alert(math.add(1,1));
});
如果這個子產品還依賴其他子產品,那麼define()函數的第一個參數,必須是一個數組,指明該子產品的依賴性。
define(['myLib'], function(myLib){
function foo(){
myLib.doSomething();
}
return {
foo : foo
};
});
當require()函數加載上面這個子產品的時候,就會先加載myLib.js檔案。
六、加載非規範的子產品
這樣的子產品在用require()加載之前,要先用require.config()方法,定義它們的一些特征。
舉例來說,underscore和backbone這兩個庫,都沒有采用AMD規範編寫。如果要加載它們的話,必須先定義它們的特征。
require.config({
shim: {
'underscore':{
exports: '_'
},
'backbone': {
deps: ['underscore', 'jquery'],
exports: 'Backbone'
}
}
});
require.config()接受一個配置對象,這個對象除了有前面說過的paths屬性之外,還有一個shim屬性,專門用來配置不相容的子產品。具體來說,每個子產品要定義(1)exports值(輸出的變量名),表明這個子產品外部調用時的名稱;(2)deps數組,表明該子產品的依賴性。
七、require.js插件
require.js還提供一系列插件,實作一些特定的功能。
domready插件,可以讓回調函數在頁面DOM結構加載完成後再運作。
require(['domready!'], function (doc){
// called once the DOM is ready
});
text和image插件,則是允許require.js加載文本和圖檔檔案。
define(
['text!review.txt','image!cat.jpg'],
function(review,cat){
console.log(review);
document.body.appendChild(cat);
}
);
類似的插件還有json和mdown,用于加載json檔案和markdown檔案。
這有AMD的WIKI中文版,講了很多蠻詳細的東西,用到的時候可以檢視:AMD的WIKI中文版
CMD規範
官網位址
define(function(require,exports,module){...});
SeaJS與 RequireJS 的異同
相同之處
RequireJS 和 Sea.js 都是子產品加載器,倡導子產品化開發理念,核心價值是讓 JavaScript 的子產品化開發變得簡單自然。
不同之處
- 定位有差異。RequireJS 想成為浏覽器端的子產品加載器,同時也想成為 Rhino / Node 等環境的子產品加載器。Sea.js 則專注于 Web 浏覽器端,同時通過 Node 擴充的方式可以很友善跑在 Node 環境中。
- 遵循的規範不同。RequireJS 遵循 AMD(異步子產品定義)規範,Sea.js 遵循 CMD (通用子產品定義)規範。規範的不同,導緻了兩者 API 不同。Sea.js 更貼近 CommonJS Modules/1.1 和 Node Modules 規範。
- 推廣理念有差異。RequireJS 在嘗試讓第三方類庫修改自身來支援 RequireJS,目前隻有少數社群采納。Sea.js 不強推,采用自主封裝的方式來“海納百川”,目前已有較成熟的封裝政策。
- 對開發調試的支援有差異。Sea.js 非常關注代碼的開發調試,有 nocache、debug 等用于調試的插件。RequireJS 無這方面的明顯支援。
- 插件機制不同。RequireJS 采取的是在源碼中預留接口的形式,插件類型比較單一。Sea.js 采取的是通用事件機制,插件類型更豐富。
- SeaJS隻會在真正需要使用(依賴)子產品時才執行該子產品,執行子產品的順序也是嚴格按照子產品在代碼中出現(require)的順序;而RequireJS會先盡早地執行(依賴)子產品, 相當于所有的require都被提前了, 而且子產品執行的順序也不一定100%就是先mod1再mod2. 注意我這裡說的是執行(真正運作define中的代碼)子產品,而非加載(load檔案)子產品.子產品的加載都是并行的, 沒有差別, 差別在于執行子產品的時機,或者說是解析.RequireJS的做法是并行加載所有依賴的子產品, 并完成解析後, 再開始執行其他代碼, 是以執行結果隻會"停頓"1次, 完成整個過程是會比SeaJS要快.而SeaJS一樣是并行加載所有依賴的子產品, 但不會立即執行子產品, 等到真正需要(require)的時候才開始解析, 這裡耗費了時間, 因為這個特例中的子產品巨大, 是以造成"停頓"2次的現象, 這就是我所說的SeaJS中的"懶執行".
總之,如果說 RequireJS 是 Prototype 類庫的話,則 Sea.js 緻力于成為 jQuery 類庫。
ES6 Modules
ES6正式提出了内置的子產品化文法,我們在浏覽器端無需額外引入requirejs來進行子產品化。
ES6中的子產品有以下特點:
- 子產品自動運作在嚴格模式下
- 在子產品的頂級作用域建立的變量,不會被自動添加到共享的全局作用域,它們隻會在子產品頂級作用域的内部存在;
- 子產品頂級作用域的 this 值為 undefined
- 對于需要讓子產品外部代碼通路的内容,子產品必須導出它們
定義子產品
使用export關鍵字将任意變量、函數或者類公開給其他子產品。
//導出變量
export var color = "red";
export let name = "cz";
export const age = 25;
//導出函數
export function add(num1,num2){
return num1+num2;
}
//導出類
export class Rectangle {
constructor(length, width) {
this.length = length;
this.width = width;
}
}
function multiply(num1, num2) {
return num1 * num2;
}
//導出對象,即導出引用
export {multiply}
重命名子產品
重命名想導出的變量、函數或類的名稱
function sum(num1, num2) {
return num1 + num2;
}
export {sum as add}
這裡将本地的sum函數重命名為add導出,是以在使用此子產品的時候必須使用add這個名稱。
導出預設值
子產品的預設值是使用 default 關鍵字所指定的單個變量、函數或類,而你在每個子產品中隻能設定一個預設導出。
export default function(num1, num2) {
return num1 + num2;
}
此子產品将一個函數作為預設值進行了導出, default 關鍵字标明了這是一個預設導出。此函數并不需要有名稱,因為它就代表這個子產品自身。對比最前面使用export導出的函數,并不是匿名函數而是必須有一個名稱用于加載子產品的時候使用,但是預設導出則無需一個名字,因為子產品名就代表了這個導出值。
也可以使用重命名文法來導出預設值。
function sum(num1, num2) {
return num1 + num2;
}
export { sum as default };
加載子產品
在子產品中使用import關鍵字來導入其他子產品。
import 語句有兩個部分,一是需要導入的辨別符,二是需導入的辨別符的來源子產品。此處是導入語句的基本形式:
import { identifier1,identifier2 } from "./example.js"
- 大括号中指定了從給定子產品導入的辨別符
- from指明了需要導入的子產品。子產品由一個表示子產品路徑的字元串來指定。
當從子產品導入了一個綁定時,你不能在目前檔案中再定義另一個同名變量(包括導入另一個同名綁定),也不能在對應的 import 語句之前使用此辨別符,更不能修改它的值。
導入單個綁定
如果一個子產品隻導出了一個函數(或變量或類),或者導出了多個接口但是隻選擇導入其中的一個,那麼就可以寫成下面單個導入的模式:
import {sum} from './example.js'
導入多個綁定
從一個子產品中導入多個綁定:
import {sum,multiply} from './example.js'
完全導入一個子產品
還有一種情況,就是将整個子產品當做單一對象導入,該子產品的所有導出都會作為對象的屬性存在:
import * as example from './example.js'
example.sum(1,2);
example.multiply(2,3);
在此代碼中, example.js 中所有導出的綁定都被加載到一個名為 example 的對象中,具名導出( sum() 函數、 multiple() 函數)都成為 example 的可用屬性。
這種導入格式被稱為命名空間導入,這是因為該 example 對象并不存在于 example.js 檔案中,而是作為一個命名空間對象被建立使用,其中包含了 example.js 的所有導出成員。
然而要記住,無論你對同一個子產品使用了多少次 import 語句,該子產品都隻會被執行一次。
在導出子產品的代碼執行之後,已被執行個體化的子產品就被保留在記憶體中,并随時都能被其他 import 所引用.
import { sum } from "./example.js";
import { multiply } from "./example.js";
import { magicNumber } from "./example.js";
盡管此處的子產品使用了三個 import 語句,但 example.js 隻會被執行一次。若同一個應用中的其他子產品打算從 example.js 導入綁定,則那些子產品都會使用這段代碼中所用的同一個子產品執行個體。
重命名導入
與導出相同,我們同樣可以重命名導入的綁定:
import { sum as add} from './example.js'
導入預設值
如果一個子產品導出了預設值,那麼可以這樣導入預設值:
import sum from "./example.js";
這個導入語句從 example.js 子產品導入了其預設值。注意此處并未使用花括号,與之前在非預設的導入中看到的不同。本地名稱 sum 被用于代表目标子產品所預設導出的函數,是以無需使用花括号。
如果一個子產品既導出了預設值、又導出了一個或更多非預設的綁定的子產品:
export let color = "red";
export default function(num1, num2) {
return num1 + num2;
}
可以像下面這樣使用一條import語句來導入它的所有導出綁定:
import sum,{color} from "./example.js"
逗号将預設的本地名稱與非預設的名稱分隔開,後者仍舊被花括号所包裹。
要記住在 import 語句中預設名稱必須位于非預設名稱之前。
導入的再導出
有時想在目前的子產品中将已導入的内容再導出去,可以像下面這樣寫:
import {sum} from './example.js'
……
export {sum}
但是有一種更簡潔的方法:
export {sum} from './example.js'
同樣可以重命名:
export { sum as add } from "./example.js";
也可以使用完全導出:
export * from "./example.js";
限制
export 與 import 都有一個重要的限制,那就是它們必須被用在其他語句或表達式的外部,而不能使用在if等代碼塊内部。原因之一是子產品文法需要讓 JS 能靜态判斷需要導出什麼,正因為此,你隻能在子產品的頂級作用域使用 export與import。
# 相容
AMD規範允許輸出的子產品相容CommonJS規範,這時define方法需要寫成下面這樣:
define(function(require,exports,module){
var someModule = require("someModule");
var anotherModule = require("anotherModule");
……
exports.asplode = function(){
}
})
參考資料
- SeaJS與RequireJS的異同
- CommonJS、requirejs、ES6的對比
- SeaJS與RequireJS最大的差別
- 阮一峰教程