JavaScript無原生命名空間,早期通過IIFE(立即調用函數表達式)+掛載window屬性模擬。本文演示從簡單閉包到可擴展命名空間的演進,對比現代ES Modules、CommonJS、UMD規範,給出遷移建議。
(function() {
function $(id) { return document.getElementById(id); }
function alertNodeName(id) { alert($(id).nodeName); }
// 外部無法訪問 $ 和 alertNodeName
})();
(function() {
// 1. 確保命名空間對象存在
if (!window.myNamespace) window.myNamespace = {};
// 2. 內部實現
function $(id) { return document.getElementById(id); }
function alertNodeName(id) { alert($(id).nodeName); }
// 3. 選擇性導出 (重命名避免衝突)
window.myNamespace.showNodeName = alertNodeName;
window.myNamespace.$ = $; // 可選
})();
// 外部調用
myNamespace.showNodeName('myElement');
var MyApp = (function(ns) {
ns.util = ns.util || {};
ns.ui = ns.ui || {};
// 內部私有
var secretKey = 'internal';
// 公開工具
ns.util.formatDate = function(date, pattern) { /* ... */ };
ns.util.ajax = function(options) { /* ... */ };
// 公開UI組件
ns.ui.Dialog = function(config) { /* ... */ };
return ns; // 返回擴展後的命名空間
})(window.MyApp || {}); // 安全擴展已有命名空間
// 另一文件繼續擴展
var MyApp = (function(ns) {
ns.data = ns.data || {};
ns.data.UserModel = function() { /* ... */ };
return ns;
})(MyApp || {});
var UserModule = (function() {
// 私有
var users = [];
function validate(user) { return user && user.name; }
// 公共API (顯式揭示)
return {
add: function(user) {
if (validate(user)) users.push(user);
},
getAll: function() { return users.slice(); }, // 返回副本
count: function() { return users.length; }
};
})();
UserModule.add({ name: 'Tom' });
console.log(UserModule.count()); // 1
| 規範 | 語法 | 加載方式 | 環境 | 樹搖剔除 |
|---|---|---|---|---|
| IIFE/命名空間 | var ns = {} | <script>標籤順序 | 瀏覽器直跑 | ❌ |
| CommonJS | require/module.exports | 同步加載 | Node.js | ⚠️ 運行時分析難 |
| AMD | define/require | 異步加載 | RequireJS | ❌ |
| ES Modules (ESM) | import/export | 靜態分析、異步 | 現代瀏覽器/Node/打包器 | ✅ 最佳 |
| UMD | 兼容AMD/CommonJS/全局 | 通用 | 庫發布 | ❌ |
// utils/date.js
export function format(date, pattern) { /* ... */ }
export const DEFAULT_PATTERN = 'YYYY-MM-DD';
// main.js
import { format, DEFAULT_PATTERN } from './utils/date.js';
console.log(format(new Date(), DEFAULT_PATTERN));
import/exportexport default MyApp包裝,或打包器externals配置output.module: true產出ESM<script type="module">原生加載 (支援importmap)window.xxx全局掛載,消除副作用