動態加載腳本、模塊化開發中,常需檢測全局函數或變量是否已定義。本文提供安全、無副作用的檢測函數,避開 ReferenceError 陷阱。
// 直接讀取未聲明變量 → ReferenceError
if (myFunc) {} // Uncaught ReferenceError: myFunc is not defined
// typeof 未聲明變量 → 安全返回 "undefined"
typeof myFunc; // "undefined" (無錯誤)
var Utils = (function() {
// 檢測全局函數是否存在
function isFunctionExists(funcName) {
try {
// 1. 字符串名稱通過 window 訪問 (推薦)
if (typeof window[funcName] === 'function') return true;
// 2. 或使用 typeof 直接檢測 (需確保標識符合法)
// if (typeof myFunc === 'function') return true;
} catch (e) {}
return false;
}
// 檢測全局變量是否存在 (含 undefined 值)
function isVariableDefined(varName) {
try {
// in 操作符檢測屬性是否存在於對象 (不看值)
return varName in window;
} catch (e) {
return false;
}
}
// 檢測變量有定義且非 undefined
function isVariableTruthy(varName) {
try {
return window[varName] !== undefined;
} catch (e) {
return false;
}
}
// 通用:檢測任意對象路徑 (支持嵌套: "a.b.c")
function exists(path, root) {
root = root || window;
var parts = path.split('.');
for (var i = 0; i < parts.length; i++) {
if (!(parts[i] in root)) return false;
root = root[parts[i]];
}
return true;
}
return {
isFunctionExists: isFunctionExists,
isVariableDefined: isVariableDefined,
isVariableTruthy: isVariableTruthy,
exists: exists
};
})();
// 使用示例
Utils.isFunctionExists('jQuery'); // true (若已加載)
Utils.isFunctionExists('myCustomFunc'); // false
Utils.isVariableDefined('MyConfig'); // true/false
Utils.exists('jQuery.fn.jquery'); // true
Utils.exists('MyApp.Config.version'); // 檢測嵌套對象
typeof 是唯一對未聲明標識符不拋錯的操作符,返回 "undefined"。但只能用於標識符,不能用字符串動態檢測。
var obj = {a: undefined};
'a' in obj; // true (屬性存在,值為 undefined)
obj.hasOwnProperty('a'); // true
'b' in obj; // false
檢測全局變量是否聲明,用 'varName' in window 最語義化。
// 推薦:window[字符串] - 安全、快速、無作用域污染
window['myFunc']
// 不推薦:eval - 安全風險、性能差、嚴格模式下受限
eval('myFunc')
function loadScript(url, callback) {
// 從 URL 提取特徵名 (如 jquery)
var key = url.split('/').pop().replace('.js', '');
if (Utils.isFunctionExists(key) || Utils.exists(key)) {
callback && callback();
return;
}
var script = document.createElement('script');
script.src = url;
script.onload = callback;
document.head.appendChild(script);
}
// 若存在 analytics 則上報,否則靜默
if (Utils.isFunctionExists('ga')) {
ga('send', 'event', 'button', 'click');
}
// 若存在 Polyfill 則使用,否則原生
var PromiseImpl = Utils.exists('Promise') ? Promise : require('es6-promise').Promise;
// CommonJS/AMD/CMD 環境
if (typeof module !== 'undefined' && module.exports) {
// Node/CommonJS
} else if (typeof define === 'function' && define.amd) {
// RequireJS/AMD
} else if (typeof define === 'function' && define.cmd) {
// SeaJS/CMD
} else {
// 瀏覽器全局
}
// 靜態導入:編譯時確定依賴,不存在"是否存在"問題
import { myFunc } from './module.js';
// 動態導入:返回 Promise,捕獲錯誤
import('./module.js')
.then(module => module.myFunc())
.catch(() => console.log('模塊加載失敗或未導出'));
// 條件式加載
if (condition) {
const module = await import('./heavy-module.js');
module.default();
}
掌握安全檢測模式,是編寫健壯、可擴展 JavaScript 應用的基石。