DIV CSS 佈局教程網

動手拆解 JavaScript 的 namespace 命名空間實作
編輯:關於JavaScript     

早年在一些大型網站的腳本裡看過類似 xxx.namespace("xxx.lang.array") 的寫法,當時對 JS 的理解還很粗淺,看到這種層層遞進的呼叫方式直接被震住。這次決定自己動手拆一遍,以後再遇到就不會摸不著頭緒了。

壓縮後的原始版本

以下是一份經過壓縮、變數被改成 a、b、c、d 的實作,註解是我加的:

// 呼叫方式:bradio.namespace("bradio.lang.array");

bradio.namespace = function () {          // 建立命名空間
    var a = arguments,                    // ["bradio.lang.array"]
        b = null,                         // 用來存放上一層物件
        c, d, e, f;                       // c 外層計數器、d 內層計數器
                                          // e 拆分後的陣列、f 參數個數
    c = 0;
    for (f = a.length; c < f; c++) {
        e = ("" + a[c]).split(".");       // 拆成 ["bradio", "lang", "array"]
        b = bradio;                       // 以 bradio 作為基礎物件

        // 若第一段就是 bradio,從第二段開始遍歷
        for (d = "bradio" == e[0] ? 1 : 0; d < e.length; d++)
            b[e[d]] = b[e[d]] || {}, b = b[e[d]]
            // 等價於以下兩行:
            // b[e[d]] = b[e[d]] || {}   // 已存在就沿用,不存在就給個空物件
            // b = b[e[d]]               // 用子物件取代 b,下輪繼續往下鑽
    }
    return b                              // 回傳最末層物件
};

整理後的可讀版本

// bradio.namespace("bradio.lang.array");

bradio.namespace = function () {
    var args = arguments,
        parent = null,
        arr, i, j, len;

    for (i = 0, len = args.length; i < len; i++) {
        // 把 "bradio.lang.array" 切成 ["bradio", "lang", "array"]
        arr = ("" + args[i]).split(".");

        // 每一段命名空間都從根物件 bradio 重新開始走
        parent = bradio;

        // 如果第一段就叫 bradio,那它已經存在,從第二段開始建即可
        for (j = "bradio" == arr[0] ? 1 : 0; j < arr.length; j++) {
            // 這一層沒有就補一個空物件,有就沿用
            parent[arr[j]] = parent[arr[j]] || {};
            // 往下一層走
            parent = parent[arr[j]];
        }
    }
    return parent;
};

它到底做了什麼

關鍵只有兩行:parent[arr[j]] = parent[arr[j]] || {} 和 parent = parent[arr[j]]。前者是「不存在就補、存在就沿用」的懶初始化,後者是把游標往下一層推。迴圈走完,bradio.lang.array 這條路徑上該有的物件就都層層建好了,而且不會覆蓋掉既有的內容——這是命名空間函數最重要的性質,否則第二次呼叫就會把第一次掛上去的方法全部清空。

而外層的 for 迴圈讓它能一次接收多個參數,bradio.namespace("a.b", "c.d") 這樣一次建兩條路徑。"" + args[i] 這個看似多餘的字串串接,作用是把傳入的 String 物件或其他型別統一轉成原始字串,確保 split 一定存在。

為什麼 JavaScript 需要這個

JavaScript 沒有 Java 那種 package 機制,所有在頂層用 var 或 function 宣告的東西都掛在全域物件上,彼此可見。頁面一旦引入幾個第三方程式庫,命名衝突幾乎無可避免——你的 init() 很可能就被別人的 init() 蓋掉了。用物件一層層包住,等於自己動手做出一套假的模組系統,這在 ES Module 普及之前是標準做法。

今天的專案已經有 import / export、打包工具與 npm 可以使用,不太需要再手寫 namespace。但理解這段程式碼仍有價值:它示範了 JS 物件作為雜湊表的靈活性,也解釋了為什麼你會在舊程式碼裡看到 window.APP = window.APP || {} 這類寫法。

以上純屬個人理解,若有解讀不到位之處,歡迎指正。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved