萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript命名空間模式:IIFE封裝、掛載window、模塊化演進

JavaScript無原生命名空間,早期通過IIFE(立即調用函數表達式)+掛載window屬性模擬。本文演示從簡單閉包到可擴展命名空間的演進,對比現代ES Modules、CommonJS、UMD規範,給出遷移建議。

階段一:簡單 IIFE 封裝 (完全私有)

(function() {
    function $(id) { return document.getElementById(id); }
    function alertNodeName(id) { alert($(id).nodeName); }
    // 外部無法訪問 $ 和 alertNodeName
})();

階段二:掛載 window 導出 API (命名空間雛形)

(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 || {});

階段四:模塊模式 (Revealing Module Pattern)

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>標籤順序瀏覽器直跑❌
CommonJSrequire/module.exports同步加載Node.js⚠️ 運行時分析難
AMDdefine/require異步加載RequireJS❌
ES Modules (ESM)import/export靜態分析、異步現代瀏覽器/Node/打包器✅ 最佳
UMD兼容AMD/CommonJS/全局通用庫發布❌

ESM 現代寫法 (生產首選)

// 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));

遷移策略

  1. 新代碼直接用import/export
  2. 舊IIFE模塊用export default MyApp包裝,或打包器externals配置
  3. 構建工具配置output.module: true產出ESM
  4. 瀏覽器<script type="module">原生加載 (支援importmap)
  5. 移除window.xxx全局掛載,消除副作用
copyright © 萬盛學電腦網 all rights reserved