萬盛學電腦網

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

JavaScript「為空或不是對象」錯誤快速排查與解決方案

錯誤本質

SCRIPT5007: 為空或不是對象 (IE) / Uncaught TypeError: Cannot read property 'xxx' of null/undefined (現代瀏覽器) — 核心原因:**嘗試在 null/undefined 上訪問屬性或調用方法**。

最常見 5 大原因與解決

1. DOM 元素未就緒就操作 (最常見)

// ❌ 錯誤:腳本在  執行,body 還未解析
var btn = document.getElementById('submitBtn');
btn.onclick = handleClick; // btn 為 null

// ✅ 修正 1:腳本放在  前
// ✅ 修正 2:DOMContentLoaded
document.addEventListener('DOMContentLoaded', function() {
    var btn = document.getElementById('submitBtn');
    btn.onclick = handleClick;
});
// ✅ 修正 3:jQuery ready
$(function() { /* 代碼 */ });

2. 選擇器寫錯 / ID 重複 / 大小寫不匹配

// HTML: 
...
// JS: var list = document.getElementById('userlist'); // 小寫 L → null // ✅ 檢查清單 console.log(document.getElementById('userList')); // 應輸出元素 console.log($('#userList').length); // jQuery 應 > 0

3. 異步數據未返回就使用

// ❌ 錯誤
var user = fetchUser(1); // 異步返回 Promise/undefined
console.log(user.name); // user 為 undefined

// ✅ 修正:回調 / Promise / async-await
fetchUser(1).then(function(user) {
    console.log(user.name);
});

// 或 async/await
async function init() {
    var user = await fetchUser(1);
    console.log(user.name);
}

4. 事件處理中 this / 事件對象指向錯誤

// ❌ 內聯事件傳參錯誤

5. 可選鏈缺失 (深層嵌套對象)

// ❌ 任意一層為 null 拋錯
var city = user.address.city.name;

// ✅ ES2020 可選鏈 ?.
var city = user?.address?.city?.name;

// ✅ 兼容寫法
var city = (user && user.address && user.address.city && user.address.city.name) || '未知';

快速排查清單

  1. 看行號:瀏覽器 Console 點擊錯誤行號定位源碼
  2. 加斷點:DevTools Sources 面板打斷點,觀察變量值
  3. 加守衛:關鍵變量前加 if (!obj) return; 或 obj?.prop
  4. 檢查時機:DOM 操作是否在 ready/onload 後
  5. 檢查拼寫:ID、class、屬性名大小寫
  6. 檢查異步:回調/Promise/await 是否正確串聯

防禦性編程模式

// 1. 早期返回
function process(user) {
    if (!user || !user.id) return; // 守衛
    // 正常邏輯
}

// 2. 默認值
var name = (user && user.profile && user.profile.name) || '匿名用戶';
// 或 ES2020
var name = user?.profile?.name ?? '匿名用戶';

// 3. 類型檢查
if (Array.isArray(list)) { list.forEach(...); }

// 4. 統一錯誤邊界 (React/Vue) / try-catch (原生)
try {
    riskyOperation();
} catch (e) {
    logger.error(e);
    showFriendlyMessage();
}

IE 特有歷史問題

  • defer 屬性:`
copyright © 萬盛學電腦網 all rights reserved