在JavaScript發展初期就是爲了實現簡單的頁面交互邏輯,寥寥數語便可;現在CPU、瀏覽器性能獲得了極大的提高,不少頁面邏輯遷移到了客戶端(表單驗證等),隨着web2.0時代的到來,Ajax技術獲得普遍應用,jQuery等前端庫層出不窮,前端代碼日益膨脹,此時在JS方面就會考慮使用模塊化規範去管理。 本文內容主要有理解模塊化,爲何要模塊化,模塊化的優缺點以及模塊化規範,而且介紹下開發中最流行的CommonJS, AMD, ES六、CMD規範。本文試圖站在小白的角度,用通俗易懂的筆調介紹這些枯燥無味的概念,但願諸君閱讀後,對模塊化編程有個全新的認識和理解!javascript
建議下載本文源代碼,本身動手敲一遍,請猛戳GitHub我的博客(全集)css
function m1(){
//...
}
function m2(){
//...
}
複製代碼
let myModule = {
data: 'www.baidu.com',
foo() {
console.log(`foo() ${this.data}`)
},
bar() {
console.log(`bar() ${this.data}`)
}
}
myModule.data = 'other data' //能直接修改模塊內部的數據
myModule.foo() // foo() other data
複製代碼
這樣的寫法會暴露全部模塊成員,內部狀態能夠被外部改寫。html
// index.html文件
<script type="text/javascript" src="module.js"></script>
<script type="text/javascript">
myModule.foo()
myModule.bar()
console.log(myModule.data) //undefined 不能訪問模塊內部數據
myModule.data = 'xxxx' //不是修改的模塊內部的data
myModule.foo() //沒有改變
</script>
複製代碼
// module.js文件
(function(window) {
let data = 'www.baidu.com'
//操做數據的函數
function foo() {
//用於暴露有函數
console.log(`foo() ${data}`)
}
function bar() {
//用於暴露有函數
console.log(`bar() ${data}`)
otherFun() //內部調用
}
function otherFun() {
//內部私有的函數
console.log('otherFun()')
}
//暴露行爲
window.myModule = { foo, bar } //ES6寫法
})(window)
複製代碼
最後獲得的結果:前端
這就是現代模塊實現的基石java
// module.js文件
(function(window, $) {
let data = 'www.baidu.com'
//操做數據的函數
function foo() {
//用於暴露有函數
console.log(`foo() ${data}`)
$('body').css('background', 'red')
}
function bar() {
//用於暴露有函數
console.log(`bar() ${data}`)
otherFun() //內部調用
}
function otherFun() {
//內部私有的函數
console.log('otherFun()')
}
//暴露行爲
window.myModule = { foo, bar }
})(window, jQuery)
複製代碼
// index.html文件
<!-- 引入的js必須有必定順序 -->
<script type="text/javascript" src="jquery-1.10.1.js"></script>
<script type="text/javascript" src="module.js"></script>
<script type="text/javascript">
myModule.foo()
</script>
複製代碼
上例子經過jquery方法將頁面的背景顏色改爲紅色,因此必須先引入jQuery庫,就把這個庫看成參數傳入。這樣作除了保證模塊的獨立性,還使得模塊之間的依賴關係變得明顯。node
<script>
後出現出現問題首先咱們要依賴多個模塊,那樣就會發送多個請求,致使請求過多jquery
咱們不知道他們的具體依賴關係是什麼,也就是說很容易由於不瞭解他們之間的依賴關係致使加載前後順序出錯。git
以上兩種緣由就致使了很難維護,極可能出現牽一髮而動全身的狀況致使項目出現嚴重的問題。 模塊化當然有多個好處,然而一個頁面須要引入多個js文件,就會出現以上這些問題。而這些問題能夠經過模塊化規範來解決,下面介紹開發中最流行的commonjs, AMD, ES6, CMD規範。es6
Node 應用由模塊組成,採用 CommonJS 模塊規範。每一個文件就是一個模塊,有本身的做用域。在一個文件裏面定義的變量、函數、類,都是私有的,對其餘文件不可見。在服務器端,模塊的加載是運行時同步加載的;在瀏覽器端,模塊須要提早編譯打包處理。github
module.exports = value
或exports.xxx = value
require(xxx)
,若是是第三方模塊,xxx爲模塊名;若是是自定義模塊,xxx爲模塊文件路徑此處咱們有個疑問:CommonJS暴露的模塊究竟是什麼? CommonJS規範規定,每一個模塊內部,module變量表明當前模塊。這個變量是一個對象,它的exports屬性(即module.exports)是對外的接口。加載某個模塊,實際上是加載該模塊的module.exports屬性。
// example.js
var x = 5;
var addX = function (value) {
return value + x;
};
module.exports.x = x;
module.exports.addX = addX;
複製代碼
上面代碼經過module.exports輸出變量x和函數addX。
var example = require('./example.js');//若是參數字符串以「./」開頭,則表示加載的是一個位於相對路徑
console.log(example.x); // 5
console.log(example.addX(1)); // 6
複製代碼
require命令用於加載模塊文件。require命令的基本功能是,讀入並執行一個JavaScript文件,而後返回該模塊的exports對象。若是沒有發現指定模塊,會報錯。
CommonJS模塊的加載機制是,輸入的是被輸出的值的拷貝。也就是說,一旦輸出一個值,模塊內部的變化就影響不到這個值。這點與ES6模塊化有重大差別(下文會介紹),請看下面這個例子:
// lib.js
var counter = 3;
function incCounter() {
counter++;
}
module.exports = {
counter: counter,
incCounter: incCounter,
};
複製代碼
上面代碼輸出內部變量counter和改寫這個變量的內部方法incCounter。
// main.js
var counter = require('./lib').counter;
var incCounter = require('./lib').incCounter;
console.log(counter); // 3
incCounter();
console.log(counter); // 3
複製代碼
上面代碼說明,counter輸出之後,lib.js模塊內部的變化就影響不到counter了。這是由於counter是一個原始類型的值,會被緩存。除非寫成一個函數,才能獲得內部變更後的值。
注意:用npm init 自動生成package.json時,package name(包名)不能有中文和大寫
|-modules
|-module1.js
|-module2.js
|-module3.js
|-app.js
|-package.json
{
"name": "commonJS-node",
"version": "1.0.0"
}
複製代碼
npm install uniq --save // 用於數組去重
//module1.js
module.exports = {
msg: 'module1',
foo() {
console.log(this.msg)
}
}
複製代碼
//module2.js
module.exports = function() {
console.log('module2')
}
複製代碼
//module3.js
exports.foo = function() {
console.log('foo() module3')
}
exports.arr = [1, 2, 3, 3, 2]
複製代碼
// app.js文件
// 引入第三方庫,應該放置在最前面
let uniq = require('uniq')
let module1 = require('./modules/module1')
let module2 = require('./modules/module2')
let module3 = require('./modules/module3')
module1.foo() //module1
module2() //module2
module3.foo() //foo() module3
console.log(uniq(module3.arr)) //[ 1, 2, 3 ]
複製代碼
命令行輸入node app.js
,運行JS文件
|-js
|-dist //打包生成文件的目錄
|-src //源碼所在的目錄
|-module1.js
|-module2.js
|-module3.js
|-app.js //應用主源文件
|-index.html //運行於瀏覽器上
|-package.json
{
"name": "browserify-test",
"version": "1.0.0"
}
複製代碼
注意:index.html
文件要運行在瀏覽器上,須要藉助browserify將app.js
文件打包編譯,若是直接在index.html
引入app.js
就會報錯!
根目錄下運行browserify js/src/app.js -o js/dist/bundle.js
在index.html文件中引入<script type="text/javascript" src="js/dist/bundle.js"></script>
CommonJS規範加載模塊是同步的,也就是說,只有加載完成,才能執行後面的操做。AMD規範則是非同步加載模塊,容許指定回調函數。因爲Node.js主要用於服務器編程,模塊文件通常都已經存在於本地硬盤,因此加載起來比較快,不用考慮非同步加載的方式,因此CommonJS規範比較適用。可是,若是是瀏覽器環境,要從服務器端加載模塊,這時就必須採用非同步模式,所以瀏覽器端通常採用AMD規範。此外AMD規範比CommonJS規範在瀏覽器端實現要來着早。
定義暴露模塊:
//定義沒有依賴的模塊
define(function(){
return 模塊
})
複製代碼
//定義有依賴的模塊
define(['module1', 'module2'], function(m1, m2){
return 模塊
})
複製代碼
引入使用模塊:
require(['module1', 'module2'], function(m1, m2){
使用m1/m2
})
複製代碼
經過比較二者的實現方法,來講明使用AMD規範的好處。
// dataService.js文件
(function (window) {
let msg = 'www.baidu.com'
function getMsg() {
return msg.toUpperCase()
}
window.dataService = {getMsg}
})(window)
複製代碼
// alerter.js文件
(function (window, dataService) {
let name = 'Tom'
function showMsg() {
alert(dataService.getMsg() + ', ' + name)
}
window.alerter = {showMsg}
})(window, dataService)
複製代碼
// main.js文件
(function (alerter) {
alerter.showMsg()
})(alerter)
複製代碼
// index.html文件
<div><h1>Modular Demo 1: 未使用AMD(require.js)</h1></div>
<script type="text/javascript" src="js/modules/dataService.js"></script>
<script type="text/javascript" src="js/modules/alerter.js"></script>
<script type="text/javascript" src="js/main.js"></script>
複製代碼
最後獲得以下結果:
這種方式缺點很明顯:首先會發送多個請求,其次引入的js文件順序不能搞錯,不然會報錯!
RequireJS是一個工具庫,主要用於客戶端的模塊管理。它的模塊管理遵照AMD規範,RequireJS的基本思想是,經過define方法,將代碼定義爲模塊;經過require方法,實現代碼的模塊加載。 接下來介紹AMD規範在瀏覽器實現的步驟:
http://www.requirejs.cn/
https://github.com/requirejs/requirejs
而後將require.js導入項目: js/libs/require.js
|-js
|-libs
|-require.js
|-modules
|-alerter.js
|-dataService.js
|-main.js
|-index.html
複製代碼
// dataService.js文件
// 定義沒有依賴的模塊
define(function() {
let msg = 'www.baidu.com'
function getMsg() {
return msg.toUpperCase()
}
return { getMsg } // 暴露模塊
})
複製代碼
//alerter.js文件
// 定義有依賴的模塊
define(['dataService'], function(dataService) {
let name = 'Tom'
function showMsg() {
alert(dataService.getMsg() + ', ' + name)
}
// 暴露模塊
return { showMsg }
})
複製代碼
// main.js文件
(function() {
require.config({
baseUrl: 'js/', //基本路徑 出發點在根目錄下
paths: {
//映射: 模塊標識名: 路徑
alerter: './modules/alerter', //此處不能寫成alerter.js,會報錯
dataService: './modules/dataService'
}
})
require(['alerter'], function(alerter) {
alerter.showMsg()
})
})()
複製代碼
// index.html文件
<!DOCTYPE html>
<html>
<head>
<title>Modular Demo</title>
</head>
<body>
<!-- 引入require.js並指定js主文件的入口 -->
<script data-main="js/main" src="js/libs/require.js"></script>
</body>
</html>
複製代碼
在index.html引入 <script data-main="js/main" src="js/libs/require.js"></script>
此外在項目中如何引入第三方庫?只需在上面代碼的基礎稍做修改:
// alerter.js文件
define(['dataService', 'jquery'], function(dataService, $) {
let name = 'Tom'
function showMsg() {
alert(dataService.getMsg() + ', ' + name)
}
$('body').css('background', 'green')
// 暴露模塊
return { showMsg }
})
複製代碼
// main.js文件
(function() {
require.config({
baseUrl: 'js/', //基本路徑 出發點在根目錄下
paths: {
//自定義模塊
alerter: './modules/alerter', //此處不能寫成alerter.js,會報錯
dataService: './modules/dataService',
// 第三方庫模塊
jquery: './libs/jquery-1.10.1' //注意:寫成jQuery會報錯
}
})
require(['alerter'], function(alerter) {
alerter.showMsg()
})
})()
複製代碼
上例是在alerter.js文件中引入jQuery第三方庫,main.js文件也要有相應的路徑配置。 小結:經過二者的比較,能夠得出AMD模塊定義的方法很是清晰,不會污染全局環境,可以清楚地顯示依賴關係。AMD模式能夠用於瀏覽器環境,而且容許非同步加載模塊,也能夠根據須要動態加載模塊。
CMD規範專門用於瀏覽器端,模塊的加載是異步的,模塊使用時纔會加載執行。CMD規範整合了CommonJS和AMD規範的特色。在 Sea.js 中,全部 JavaScript 模塊都遵循 CMD模塊定義規範。
定義暴露模塊:
//定義沒有依賴的模塊
define(function(require, exports, module){
exports.xxx = value
module.exports = value
})
複製代碼
//定義有依賴的模塊
define(function(require, exports, module){
//引入依賴模塊(同步)
var module2 = require('./module2')
//引入依賴模塊(異步)
require.async('./module3', function (m3) {
})
//暴露模塊
exports.xxx = value
})
複製代碼
引入使用模塊:
define(function (require) {
var m1 = require('./module1')
var m4 = require('./module4')
m1.show()
m4.show()
})
複製代碼
而後將sea.js導入項目: js/libs/sea.js
|-js
|-libs
|-sea.js
|-modules
|-module1.js
|-module2.js
|-module3.js
|-module4.js
|-main.js
|-index.html
複製代碼
// module1.js文件
define(function (require, exports, module) {
//內部變量數據
var data = 'atguigu.com'
//內部函數
function show() {
console.log('module1 show() ' + data)
}
//向外暴露
exports.show = show
})
複製代碼
// module2.js文件
define(function (require, exports, module) {
module.exports = {
msg: 'I Will Back'
}
})
複製代碼
// module3.js文件
define(function(require, exports, module) {
const API_KEY = 'abc123'
exports.API_KEY = API_KEY
})
複製代碼
// module4.js文件
define(function (require, exports, module) {
//引入依賴模塊(同步)
var module2 = require('./module2')
function show() {
console.log('module4 show() ' + module2.msg)
}
exports.show = show
//引入依賴模塊(異步)
require.async('./module3', function (m3) {
console.log('異步引入依賴模塊3 ' + m3.API_KEY)
})
})
複製代碼
// main.js文件
define(function (require) {
var m1 = require('./module1')
var m4 = require('./module4')
m1.show()
m4.show()
})
複製代碼
<script type="text/javascript" src="js/libs/sea.js"></script>
<script type="text/javascript">
seajs.use('./js/modules/main')
</script>
複製代碼
最後獲得結果以下:
ES6 模塊的設計思想是儘可能的靜態化,使得編譯時就能肯定模塊的依賴關係,以及輸入和輸出的變量。CommonJS 和 AMD 模塊,都只能在運行時肯定這些東西。好比,CommonJS 模塊就是對象,輸入時必須查找對象屬性。
export命令用於規定模塊的對外接口,import命令用於輸入其餘模塊提供的功能。
/** 定義模塊 math.js **/
var basicNum = 0;
var add = function (a, b) {
return a + b;
};
export { basicNum, add };
/** 引用模塊 **/
import { basicNum, add } from './math';
function test(ele) {
ele.textContent = add(99 + basicNum);
}
複製代碼
如上例所示,使用import命令的時候,用戶須要知道所要加載的變量名或函數名,不然沒法加載。爲了給用戶提供方便,讓他們不用閱讀文檔就能加載模塊,就要用到export default命令,爲模塊指定默認輸出。
// export-default.js
export default function () {
console.log('foo');
}
複製代碼
// import-default.js
import customName from './export-default';
customName(); // 'foo'
複製代碼
模塊默認輸出, 其餘模塊加載該模塊時,import命令能夠爲該匿名函數指定任意名字。
它們有兩個重大差別:
① CommonJS 模塊輸出的是一個值的拷貝,ES6 模塊輸出的是值的引用。
② CommonJS 模塊是運行時加載,ES6 模塊是編譯時輸出接口。
第二個差別是由於 CommonJS 加載的是一個對象(即module.exports屬性),該對象只有在腳本運行完纔會生成。而 ES6 模塊不是對象,它的對外接口只是一種靜態定義,在代碼靜態解析階段就會生成。
下面重點解釋第一個差別,咱們仍是舉上面那個CommonJS模塊的加載機制例子:
// lib.js
export let counter = 3;
export function incCounter() {
counter++;
}
// main.js
import { counter, incCounter } from './lib';
console.log(counter); // 3
incCounter();
console.log(counter); // 4
複製代碼
ES6 模塊的運行機制與 CommonJS 不同。ES6 模塊是動態引用,而且不會緩存值,模塊裏面的變量綁定其所在的模塊。
簡單來講就一句話:使用Babel將ES6編譯爲ES5代碼,使用Browserify編譯打包js。
{
"name" : "es6-babel-browserify",
"version" : "1.0.0"
}
複製代碼
{
"presets": ["es2015"]
}
複製代碼
//module1.js文件
// 分別暴露
export function foo() {
console.log('foo() module1')
}
export function bar() {
console.log('bar() module1')
}
複製代碼
//module2.js文件
// 統一暴露
function fun1() {
console.log('fun1() module2')
}
function fun2() {
console.log('fun2() module2')
}
export { fun1, fun2 }
複製代碼
//module3.js文件
// 默認暴露 能夠暴露任意數據類項,暴露什麼數據,接收到就是什麼數據
export default () => {
console.log('默認暴露')
}
複製代碼
// app.js文件
import { foo, bar } from './module1'
import { fun1, fun2 } from './module2'
import module3 from './module3'
foo()
bar()
fun1()
fun2()
module3()
複製代碼
babel js/src -d js/lib
browserify js/lib/app.js -o js/lib/bundle.js
而後在index.html文件中引入
<script type="text/javascript" src="js/lib/bundle.js"></script>
複製代碼
最後獲得以下結果:
此外第三方庫(以jQuery爲例)如何引入呢? 首先安裝依賴npm install jquery@1
而後在app.js文件中引入
//app.js文件
import { foo, bar } from './module1'
import { fun1, fun2 } from './module2'
import module3 from './module3'
import $ from 'jquery'
foo()
bar()
fun1()
fun2()
module3()
$('body').css('background', 'green')
複製代碼