萬盛學電腦網

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

JavaScript 判斷變量狀態:try-catch 區分「未聲明」、「已聲明未賦值」、「已賦值」

JavaScript 中判斷變量狀態看似簡單,實則暗藏 typeof 陷阱、作用域鏈、聲明提升、TDZ (暫時性死區) 等機制。本文分析為什麼 typeof x === 'undefined' 無法區分「未聲明」與「已聲明未賦值」,並提供基於 try-catch 的精準判斷方案,最後給出現代 Reflect.has / globalThis.hasOwnProperty 的標準解法。

問題場景

var a;           // 已聲明未賦值 (undefined)
// b 未聲明
// c = 1 已聲明已賦值

// 目標:精準區分三種狀態
function getVarState(varName) {
  // 返回 'undeclared' | 'uninitialized' | 'initialized'
}

為什麼 typeof 不夠用?

var a; 
typeof a;        // 'undefined' ✅
typeof b;        // 'undefined' ❌ 無法區分「未聲明」
typeof c;        // 'number' ✅

// 更糟:函數作用域聲明提升
function test() {
  if (typeof a === 'undefined') { var a = 1; } // 捕獲到函數作用域的 a (undefined)
  console.log(a); // 1 (非預期)
}
test();

方案一:try-catch + ReferenceError 捕獲 (經典技巧)

function getVarStateTryCatch(varName, scope = globalThis) {
  try {
    // 嘗試讀取:未聲明拋 ReferenceError,已聲明未賦值返回 undefined
    const value = scope[varName]; // 或直接用 eval(varName) 但不推薦
    return value === undefined ? 'uninitialized' : 'initialized';
  } catch (e) {
    if (e instanceof ReferenceError) return 'undeclared';
    throw e;
  }
}

// 測試
var a; let b; const c = 1;
console.log(getVarStateTryCatch('a')); // 'uninitialized'
console.log(getVarStateTryCatch('b')); // 'uninitialized' (let TDZ 會拋錯!見下)
console.log(getVarStateTryCatch('c')); // 'initialized'
console.log(getVarStateTryCatch('d')); // 'undeclared'

⚠️ 陷阱:let/const 有 TDZ,讀取未初始化綁定會拋 ReferenceError,會被誤判為「未聲明」。

方案二:in 運算符檢測綁定存在性 (ES6+ 推薦)

function getVarStateIn(varName, scope = globalThis) {
  if (!(varName in scope)) return 'undeclared';
  
  // 進一步區分 let/const TDZ:嘗試獲取描述符
  try {
    const desc = Object.getOwnPropertyDescriptor(scope, varName);
    if (!desc) return 'undeclared'; // 繼承屬性或不存在
    
    // 資料屬性有 value,存取器有 get/set
    if ('value' in desc) return desc.value === undefined ? 'uninitialized' : 'initialized';
    if ('get' in desc) return 'initialized'; // 存取器視為已初始化
  } catch (e) {
    // TDZ 期間 getOwnPropertyDescriptor 也會拋 ReferenceError (罕見)
    return 'uninitialized';
  }
  return 'initialized';
}

方案三:現代標準 Reflect.has / globalThis.hasOwnProperty

function getVarStateModern(varName, scope = globalThis) {
  // 1. 檢查綁定是否存在 (不觸發 TDZ)
  if (!Reflect.has(scope, varName)) return 'undeclared';
  
  // 2. 嘗試安全獲取值
  try {
    const value = scope[varName]; // 可能觸發 TDZ (let/const)
    return value === undefined ? 'uninitialized' : 'initialized';
  } catch (e) {
    if (e instanceof ReferenceError) return 'uninitialized'; // TDZ 狀態
    throw e;
  }
}

// 全域變數 (var/function) 掛載在 globalThis
// 模組/塊級作用域變數無法從外部直接檢測,需在同作用域內執行檢測代碼

作用域限制:核心痛點

無法從外部檢測函數作用域、塊級作用域、模組作用域的變量狀態。
只能檢測 全域物件屬性 (var/function 在全域) 或 物件屬性。

實際應用場景與替代模式

場景 1:配置物件預設值合併

// ❌ 不要檢測變量聲明
// ✅ 用解構賦值預設值
const { apiUrl = '/api', timeout = 5000 } = config || {};

// ✅ 或用 ?? 空值合併
const apiUrl = config?.apiUrl ?? '/api';

場景 2:動態載入腳本後檢測全域變數

// 載入 SDK 後檢測
loadScript('https://sdk.example.com.js').then(() => {
  if (typeof window.SDK !== 'undefined') {
    window.SDK.init({...});
  }
});

場景 3:條件式定義 Polyfill

// 標準模式
if (!Array.prototype.flat) {
  Array.prototype.flat = function(depth) { ... };
}

// 或用 Object.defineProperty 避免覆蓋
if (!Reflect.has(Array.prototype, 'flat')) {
  Object.defineProperty(Array.prototype, 'flat', { value: ..., configurable: true, writable: true });
}

總結對照表

方法區分未聲明/未初始化適用範圍TDZ 安全推薦度
typeof❌全域/物件屬性✅⭐ (僅判斷 undefined)
try-catch + 直接讀取⚠️ (let/const 誤判)全域 var/function❌⭐⭐ (舊代碼常見)
in / Reflect.has✅物件屬性/全域綁定✅⭐⭐⭐ (現代標準)
Object.getOwnPropertyDescriptor✅物件自有屬性⚠️⭐⭐⭐ (精準)

最佳實踐建議

  1. 業務邏輯不要依賴動態檢測變量聲明狀態
  2. 用預設參數、解構賦值預設值、?? 運算符處理可選值
  3. 全域特性檢測用 'feature' in window 或 Reflect.has(window, 'feature')
  4. 物件屬性檢測用 obj.hasOwnProperty(prop) / Reflect.has(obj, prop)
  5. 避免 eval、with、動態變量名,破壞靜態分析與最佳化

理解變量狀態檢測的邊界與陷阱,能寫出更健壯、可靜態分析的代碼。

copyright © 萬盛學電腦網 all rights reserved