顧名思義,命名空間的主要目的就是避免命名衝突。JavaScript 沒有 Java 那樣的 package 機制,但只要善用匿名函數,就能自己搭一個夠用的隔離層。
(function () {
function $(id) {
return document.getElementById(id);
}
function alertNodeName(id) {
alert($(id).nodeName);
}
})();
把函數、對象、變量都寫進一個立即執行的匿名函數裡,就得到了一個「偽命名空間」。好處很直接:內部的所有聲明都被封裝保護起來,而且因為同處一個函數作用域,彼此之間可以自由訪問,不需要任何前綴。
但問題也隨之而來:外部腳本同樣訪問不到它們了。封裝得太徹底,反而失去了可複用性。
(function () {
if (!window.myNamespace) { window['myNameSpace'] = {}; }
function $(id) {
return document.getElementById(id);
}
function alertNodeName(id) {
alert($(id).nodeName);
}
// 只把需要公開的函數暴露出來
window['myNameSpace']['showNodeName'] = alertNodeName;
})();
做法是先確保 window 上存在一個命名空間對象,再把準備公開的函數掛上去。注意此處的關鍵在於「選擇性暴露」:$ 依然私有,只有 showNodeName 對外可見。這正是模塊設計中最小暴露面的體現。
順帶一提,示例裡判斷用的是 window.myNamespace(小寫 n),賦值用的卻是 window['myNameSpace'](大寫 N),兩者並非同一個屬性,判斷實際上永遠為真。雖然本例中效果無異,但這類大小寫不一致在真實項目裡會埋下隱患,上面的代碼已統一為 myNamespace。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>New Document</TITLE>
<SCRIPT LANGUAGE="JavaScript">
<!--
(function () {
function $(id) {
return document.getElementById(id);
}
function alertNodeName(id) {
alert($(id).nodeName);
}
window['myNamespace'] = {};
window['myNamespace']['showNodeName'] = alertNodeName;
})();
function Test() {
myNamespace.showNodeName("T");
}
//-->
</SCRIPT>
</HEAD>
<BODY onload="Test()">
<INPUT TYPE="text" NAME="T" ID="T" VALUE="Test">
</BODY>
</HTML>
這種模式在 ES Module 普及之前幾乎是唯一選擇,也衍生出更成熟的變體:把工廠函數的返回值直接賦給命名空間對象,即所謂的「揭示模塊模式」(Revealing Module Pattern):
var myNamespace = (function () {
function $(id) { return document.getElementById(id); }
function showNodeName(id) { alert($(id).nodeName); }
// 只揭示需要公開的成員
return {
showNodeName: showNodeName
};
})();
寫法更內聚,也不必去動 window 對象。今天在新項目中,直接用 export / import 標準模塊會更好;但在維護老代碼、或需要寫一段嵌入到第三方頁面的腳本時,IIFE 加命名空間依然是避免污染全局環境最可靠的辦法。