萬盛學電腦網

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

JavaScript img onerror 死循環問題分析與三種解決方案

<img onerror="this.src='fallback.jpg'"> 是常見斷圖備援寫法,但若備援圖也失效,會觸發無限 onerror 循環導致「Stack overflow at line: 0」。本文分析成因並提供三種解決方案。

問題重現

<!-- 危險寫法 -->
<img src="missing.jpg" onerror="this.src='fallback.jpg'" alt="圖片">

方案一:移除 onerror 屬性(最簡單)

<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="用戶頭像">

方案三:雙圖片切換法(CSS 控制顯示/隱藏)

<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 最後防線
]);

網路不穩定導致誤觸發 onerror

圖片存在但網路波動也可能觸發 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;
});

現代 HTML 標準:loading="lazy" 與 decoding="async"

<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 = null
  • [ ] 備援圖片體積小、CDN 分發、高可用性
  • [ ] 使用 loading="lazy" 減少初始載入
  • [ ] 監控圖片載入失敗率(Sentry/GA 事件)
copyright © 萬盛學電腦網 all rights reserved