萬盛學電腦網

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

JavaScript 枚舉模擬實現:基於 Microsoft AJAX Library 擴展

前言

JavaScript 原生無枚舉類型。Microsoft AJAX Library(ASP.NET AJAX 客戶端框架)提供了 Type.registerEnum 擴展,本文演示如何使用該庫實現類 C# 枚舉功能。

完整代碼範例

<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
    <title>JS 枚舉演示</title>
    <asp:ScriptManager ID="ScriptManager1" runat="server"></asp:ScriptManager>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" runat="server"></asp:ScriptManager>
        <script type="text/javascript">
            // 1. 註冊命名空間
            Type.registerNamespace("BaoBeiMe");

            // 2. 定義枚舉構造函數
            BaoBeiMe.EnumDepartment = function() { };

            // 3. 定義枚舉成員(原型屬性)
            BaoBeiMe.EnumDepartment.prototype = {
                One: "信息部",
                Two: "業務部",
                Three: "財務部",
                Four: "研發部"
            };

            // 4. 註冊為枚舉類型
            BaoBeiMe.EnumDepartment.registerEnum("BaoBeiMe.EnumDepartment");

            // 5. 使用
            function Button1_onclick() {
                var enumDept = new BaoBeiMe.EnumDepartment();
                var lblMsg = $get('<%=lblMsg.ClientID %>');
                lblMsg.innerText = "One 是 " + enumDept.One + " , " +
                                   "Two 是 " + enumDept.Two + " , " +
                                   "Three 是 " + enumDept.Three + " , " +
                                   "Four 是 " + enumDept.Four;
            }
        </script>
        <div>
            <input id="Button1" type="button" value="獲取所有枚舉值"
                onclick="return Button1_onclick()" /><br /><br />
            <asp:Label ID="lblMsg" runat="server" Text=""></asp:Label>
        </div>
    </form>
</body>
</html>

關鍵步驟解析

  1. Type.registerNamespace("BaoBeiMe"):建立命名空間,避免全局汙染
  2. 定義構造函數 BaoBeiMe.EnumDepartment = function() {}
  3. 在 prototype 上定義枚舉成員(鍵值對)
  4. registerEnum("FullyQualifiedName"):向框架註冊,啟用 Enum.parse、Enum.toString 等輔助方法
  5. 實例化後像訪問普通屬性一樣讀取枚舉值

原生 JS 實現枚舉(無依賴)

方案一:凍結對象(ES5+)

const Department = Object.freeze({
    IT: "IT",
    HR: "HR",
    FINANCE: "FINANCE",
    RND: "RND"
});

// 使用
console.log(Department.IT); // "IT"
// Department.IT = "HACK"; // 嚴格模式下拋錯,非嚴格模式靜默失敗

方案二:ES6 Symbol 唯一值(推薦)

const Department = {
    IT: Symbol("IT"),
    HR: Symbol("HR"),
    FINANCE: Symbol("FINANCE"),
    RND: Symbol("RND")
};

// 使用
switch (dept) {
    case Department.IT: ...
}
// Symbol 保證唯一性,避免字符串衝突

方案三:類風格枚舉(含反向映射)

var Enum = (function() {
    function create(keys, values) {
        var obj = {};
        keys.forEach(function(k, i) {
            var v = values ? values[i] : k;
            obj[k] = v;
            obj[v] = k; // 反向映射
        });
        return Object.freeze(obj);
    }
    return { create: create };
})();

// 使用
var Status = Enum.create(["PENDING", "APPROVED", "REJECTED"]);
// Status.PENDING === "PENDING"
// Status["PENDING"] === "PENDING" (反向)

TypeScript 原生枚舉

enum Direction {
    Up = 1,
    Down,
    Left,
    Right
}

// 編譯為 JS 後自動生成反向映射
console.log(Direction.Up);     // 1
console.log(Direction[1]);     // "Up"

最佳實踐建議

  1. 現代項目:TypeScript enum 或 ES6 Symbol / Object.freeze
  2. 老舊 ASP.NET AJAX 專案:沿用 Type.registerEnum
  3. 需序列化傳輸:使用字符串/數字值枚舉,避免 Symbol 無法 JSON.stringify
  4. 位掩碼場景:使用 2 的冪次數值 READ=1, WRITE=2, EXECUTE=4,配合位運算

結語

枚舉是「有限離散值集合」的語義建模。JS 雖無原生支持,但通過 Object.freeze、Symbol、Map、TypeScript enum 等多種方式均可優雅實現。選擇方案時權衡:運行環境、序列化需求、類型安全、團隊熟悉度。

copyright © 萬盛學電腦網 all rights reserved