<img onerror="this.src='fallback.jpg'"> 是常見斷圖備援寫法,但若備援圖也失效,會觸發無限 onerror 循環導致「Stack overflow at line: 0」。本文分析成因並提供三種解決方案。
<!-- 危險寫法 -->
<img src="missing.jpg" onerror="this.src='fallback.jpg'" alt="圖片">
<img src="missing.jpg"
onerror="this.onerror=null; this.src='fallback.jpg'"
alt="圖片">
<script>
function handleImageError(img, fallbackSrc) {
// 防止重複處理
if (img.dataset.errorHandled === 'true') return;
img.dataset.errorHandled = 'true';
// 移除事件監聽器(現代寫法)
img.onerror = null;
// 或 img.removeEventListener('error', handleImageError);
// 設定備援圖片
img.src = fallbackSrc;
// 可選:標記為備援圖片,樣式區分
img.classList.add('fallback-image');
}
// 使用
document.querySelectorAll('img[data-fallback]').forEach(img => {
img.addEventListener('error', function() {
handleImageError(this, this.dataset.fallback);
});
});
</script>
<img src="photo.jpg" data-fallback="/images/default-avatar.png" alt="用戶頭像">
<style>
.img-fallback .primary { display: none; }
.img-fallback .fallback { display: block; }
.img-normal .primary { display: block; }
.img-normal .fallback { display: none; }
</style>
<div class="img-normal">
<img class="primary" src="photo.jpg" alt="主要圖片">
<img class="fallback" src="/images/default.png" alt="備援圖片">
</div>
<script>
document.querySelectorAll('.img-normal').forEach(container => {
const primary = container.querySelector('.primary');
primary.addEventListener('error', () => {
container.classList.remove('img-normal');
container.classList.add('img-fallback');
});
});
</script>
class ImageFallbackChain {
constructor(imgElement, fallbackUrls = []) {
this.img = imgElement;
this.fallbacks = [...fallbackUrls];
this.currentIndex = -1;
this.bind();
}
bind() {
this.img.addEventListener('error', () => this.next());
// 成功載入清理
this.img.addEventListener('load', () => this.cleanup());
}
next() {
this.currentIndex++;
if (this.currentIndex < this.fallbacks.length) {
this.img.src = this.fallbacks[this.currentIndex];
} else {
// 全部失敗:顯示佔位或隱藏
this.img.style.display = 'none';
this.cleanup();
}
}
cleanup() {
this.img.removeEventListener('error', this.boundNext);
this.img.removeEventListener('load', this.boundCleanup);
}
}
// 使用
new ImageFallbackChain(document.getElementById('avatar'), [
'/avatars/user123.jpg',
'/avatars/default.png',
'/avatars/anonymous.svg',
'data:image/svg+xml,...' // 內聯 SVG 最後防線
]);
圖片存在但網路波動也可能觸發 error 事件。建議策略:
img.addEventListener('error', function() {
// 延遲重試,避免瞬間網路抖動誤判
if (!this.dataset.retryCount) this.dataset.retryCount = 0;
if (this.dataset.retryCount < 2) {
this.dataset.retryCount++;
setTimeout(() => { this.src = this.src; }, 1000 * this.dataset.retryCount);
return;
}
// 重試失敗才啟用備援
this.onerror = null;
this.src = this.dataset.fallback;
});
<img src="photo.jpg"
loading="lazy"
decoding="async"
onerror="this.onerror=null; this.src='fallback.jpg'">
| 方案 | 優點 | 缺點 | 推薦場景 |
|---|---|---|---|
| onerror=null 單行 | 最簡潔、無依賴 | 只能一層備援 | 簡單專案、單一備援圖 |
| 獨立函式 + data 旗標 | 可複用、支援多實例、可擴充 | 需額外 JS | 中大型專案、元件化開發 |
| 雙圖片 CSS 切換 | 無 JS 邏輯、瀏覽器原生切換、無閃爍 | DOM 結構較複雜、預載兩張圖 | 關鍵圖片(頭像、商品主圖) |
| 備援鏈類別 | 多層備援、重試機制、完整生命週期 | 代碼量最大 | 高可用性要求、CDN 多節點備援 |
<img> 都有 alt 屬性onerror 內部設定 this.onerror = nullloading="lazy" 減少初始載入