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();
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.hasOwnPropertyfunction 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在全域) 或 物件屬性。
// ❌ 不要檢測變量聲明
// ✅ 用解構賦值預設值
const { apiUrl = '/api', timeout = 5000 } = config || {};
// ✅ 或用 ?? 空值合併
const apiUrl = config?.apiUrl ?? '/api';
// 載入 SDK 後檢測
loadScript('https://sdk.example.com.js').then(() => {
if (typeof window.SDK !== 'undefined') {
window.SDK.init({...});
}
});
// 標準模式
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 | ✅ | 物件自有屬性 | ⚠️ | ⭐⭐⭐ (精準) |
'feature' in window 或 Reflect.has(window, 'feature')obj.hasOwnProperty(prop) / Reflect.has(obj, prop)eval、with、動態變量名,破壞靜態分析與最佳化理解變量狀態檢測的邊界與陷阱,能寫出更健壯、可靜態分析的代碼。