全局變量汙染是早期 JS 開發最大痛點:
命名空間模式通過單一全局對象承載所有模塊,成為 ES6 Modules 標準化前的事實標準。
// 原始壓縮代碼(變量名 a,b,c...)
bradio.namespace = function() {
var a = arguments, b = null, c, d, e, f;
c = 0;
for (f = a.length; c < f; c++) {
e = ("" + a[c]).split(".");
b = bradio;
for (d = "bradio" == e[0] ? 1 : 0; d < e.length; d++)
b[e[d]] = b[e[d]] || {}, b = b[e[d]];
}
return b;
};
bradio.namespace = function() {
const args = arguments; // 參數列表:["bradio.lang.array", ...]
let parent = null; // 當前層級父對象
let parts, i, j, len;
for (i = 0, len = args.length; i < len; i++) {
parts = (args[i] + '').split('.'); // 字串分割:["bradio", "lang", "array"]
parent = bradio; // 從根命名空間開始
// 若首段是 "bradio" 則跳過(已在根對象上)
for (j = parts[0] === 'bradio' ? 1 : 0; j < parts.length; j++) {
// 核心邏輯:不存在則創建空對象,然後下潛
parent[parts[j]] = parent[parts[j]] || {};
parent = parent[parts[j]];
}
}
return parent; // 返回最深層命名空間對象
};
調用: bradio.namespace("bradio.lang.array", "bradio.dom")
初始: bradio = {}
第一輪 "bradio.lang.array":
parent = bradio
parts = ["bradio", "lang", "array"]
j=1: parent["lang"] = {} → parent = bradio.lang
j=2: parent["array"] = {} → parent = bradio.lang.array
返回 bradio.lang.array
第二輪 "bradio.dom":
parent = bradio
parts = ["bradio", "dom"]
j=1: parent["dom"] = {} → parent = bradio.dom
返回 bradio.dom
最終結構:
bradio = {
lang: { array: {} },
dom: {}
}
| 細節 | 代碼體現 | 作用 |
|---|---|---|
| 多參數支援 | for (i=0; i | 一次調用創建多個命名空間 | 根對象固定 | parent = bradio | 以品牌/項目名為根,避免汙染 |
| 首段跳過邏輯 | parts[0]==='bradio' ? 1 : 0 | 允許「完整路徑」或「相對路徑」兩種調用 |
| 惰性創建 | parent[x] = parent[x] || {} | 只創建不存在的層級,保留已有模塊 |
| 返回最深層 | return parent | 鏈式調用:bradio.namespace('a.b').method = ... |
| 時代 | 模式 | 語法 | 優點 | 缺點 |
|---|---|---|---|---|
| 遠古 | 全局變量 | var foo = {} | 簡單 | 極易衝突 |
| jQuery 時代 | 命名空間 | $.fn.plugin = ... | 單一全局 $ | 插件生態鎖定 |
| 模塊化萌芽 | IIFE + 命名空間 | (function(ns){...})(app) | 私有作用域 | 依賴管理手動 |
| CommonJS/AMD | 模塊系統 | require/define | 依賴聲明、按需加載 | 構建工具強綁定 |
| ES6+ 現代 | ES Modules | import/export | 靜態分析、樹搖、瀏覽器原生 | 舊環境需轉譯 |
window.MyLib = { version: '1.0', utils: {...} }window.APP_CONFIG = { apiBase: '...', featureFlags: {} }window.__MICRO_APP__.subAppconst NS = (() => {
const root = window;
const cache = new Map(); // 緩存已創建路徑
function create(path, base = root) {
if (cache.has(path)) return cache.get(path);
const parts = path.split('.');
let current = base;
for (const part of parts) {
if (!current[part]) current[part] = {};
current = current[part];
}
cache.set(path, current);
return current;
}
return {
register: (path, base) => create(path, base),
get: (path, base) => {
const parts = path.split('.');
let current = base || root;
for (const part of parts) {
if (!current) return undefined;
current = current[part];
}
return current;
},
set: (path, value, base) => {
const parts = path.split('.');
const last = parts.pop();
const parent = create(parts.join('.'), base);
parent[last] = value;
}
};
})();
// 使用
NS.register('app.modules.user');
NS.set('app.config.api', '/api/v1');
const UserModule = NS.get('app.modules.user');
UserModule.service = { login() {} };
命名空間模式是 JS 模塊化歷程中的關鍵過渡形態:
雖然 ES Modules 已成主流,但理解命名空間「對象屬性鏈模擬作用域」的核心思想,能幫你讀懂歷史代碼、處理非模塊化第三方庫、設計運行時動態註冊系統。工具變了,底層抽象沒變。