Uncaught TypeError: document.getElementById(...) is null
at script.js:10
這是前端開發中最高頻的錯誤之一,本質上是 「在 DOM 就緒前嘗試存取元素」 導致。
瀏覽器解析 HTML 是 自上而下、同步執行 的:
<script> 立即暫停解析,執行腳本<script> 之後的 HTML 尚未解析,對應元素不存在於 DOM 樹中getElementById 返回 null,後續存取屬性/方法拋出 TypeError<body>
<div id="app">內容</div>
<!-- 其他內容 -->
<script>
// 此時 #app 已存在於 DOM
const el = document.getElementById('app');
el.textContent = '就緒';
</script>
</body>
優點:無額外事件監聽開銷,首屏渲染不阻塞。
缺點:需調整模板結構,舊專案重構成本高。
DOMContentLoaded 事件 (標準做法)document.addEventListener('DOMContentLoaded', function() {
// DOM 完全解析完畢,資源(圖片/樣式)可能尚未載入
const el = document.getElementById('app');
// 安全操作...
});
優點:語意明確,不依賴腳本位置。
注意:IE9+ 支援,現代專案首選。
window.onload (舊版相容)window.onload = function() {
// 所有資源(圖片/樣式/iframe)完全載入後觸發
const el = document.getElementById('app');
};
缺點:等待圖片等資源,延遲較大,體驗較差。
適用:需操作圖片尺寸、iframe 內容等強依賴資源載入的場景。
| 寫法 | 觸發時機 | 等同原生 |
|---|---|---|
$(function(){...}) | DOMContentLoaded | document.addEventListener('DOMContentLoaded', ...) |
$(document).ready(...) | DOMContentLoaded | 同上 |
$(window).on('load', ...) | window.onload | window.addEventListener('load', ...) |
關鍵差異:jQuery 的 $('selector') 在元素不存在時返回空 jQuery 物件 (不報錯),但 document.getElementById 返回 null,直接存取屬性才會拋錯。
<head> 中且無 defer/async?shadowRoot.getElementById()contentWindow.document 中查找type="module" 自動延遲執行 (等同 defer)<script defer src="..."></script> 放在 head,瀏覽器會在 DOM 就緒前自動執行</body> 前掌握瀏覽器解析機制,這類低級錯誤即可徹底杜絕。