萬盛學電腦網

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

JavaScript 判斷函數/變量是否存在的安全模式

動態加載腳本、模塊化開發中,常需檢測全局函數或變量是否已定義。本文提供安全、無副作用的檢測函數,避開 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');    // 檢測嵌套對象

原理深度解析

1. typeof 操作符特權

typeof 是唯一對未聲明標識符不拋錯的操作符,返回 "undefined"。但只能用於標識符,不能用字符串動態檢測。

2. in 操作符 vs hasOwnProperty

var obj = {a: undefined};
'a' in obj;           // true (屬性存在,值為 undefined)
obj.hasOwnProperty('a'); // true
'b' in obj;           // false

檢測全局變量是否聲明,用 'varName' in window 最語義化。

3. window[varName] vs eval(varName)

// 推薦: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 {
  // 瀏覽器全局
}

ES6 模塊時代的新範式

// 靜態導入:編譯時確定依賴,不存在"是否存在"問題
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 應用的基石。

copyright © 萬盛學電腦網 all rights reserved