DIV CSS 佈局教程網

三種方式檢測圖片是否存在:從 Image 物件到 onerror
編輯:關於JavaScript     

「這張圖片到底在不在」是列表頁、後台管理與使用者上傳功能裡的高頻需求。以下三種做法各有適用場景。

做法一:用 Image 物件主動檢測

// 檢查圖片是否存在
function CheckImgExists(imgurl) {
  var ImgObj = new Image();
  ImgObj.src = imgurl;          // 指定來源,瀏覽器會嘗試載入

  // 圖片存在時會有尺寸
  if (ImgObj.fileSize > 0 || (ImgObj.width > 0 && ImgObj.height > 0)) {
    alert(imgurl + '存在');
  } else {
    alert(imgurl + '不存在');
  }
}

CheckImgExists('/editor/simple/FileIconDir/rar.gif');
CheckImgExists('/editor/simple/FileIconDir/rarsdfs.gif');

這個寫法有個明顯缺陷:它沒有等圖片載完。指定 src 之後立刻檢查寬高,網路圖片幾乎必然還是 0。正確做法必須搭配 onload/onerror(見做法三)。另外 fileSize 是 IE 私有屬性,其他瀏覽器沒有。

做法二:用 onerror 屬性做退路

最輕量的方案,不需要任何 JS 函式:

<img src="原圖片" alt="圖片" onerror="this.src='替換圖片'">

瀏覽器載不到圖片時自動換成佔位圖。這適合「偶爾缺圖、不想大動干戈」的情況。要注意兩點:一是替換圖片本身必須確定存在,否則會陷入無限迴圈;二是應加上 alt 文字,兼顧無障礙。

做法三:明確區分成功與失敗

<script language="javascript" type="text/javascript">
// 載入失敗時呼叫此函式
function defaultImg(T) {
  T.src = "images/closelabel.gif";   // 預設圖片
}

// 載入成功後呼叫此函式
function LoadOK() {
  alert("LoadOK");
}
</script>
</head>
<body>
<img src="123.jpg" onerror="defaultImg(this);" onload="LoadOK()" />
<!--123.jpg 是一個錯誤的圖片路徑-->

最穩妥的版本

把三種想法整合起來,用 Promise 包成一個可直接 await 的函式:

function checkImage(url, fallback) {
  return new Promise(function (resolve) {
    var img = new Image();

    img.onload = function () {
      resolve({ ok: true, width: img.naturalWidth, height: img.naturalHeight });
    };

    img.onerror = function () {
      if (fallback) {
        // 有備援圖就再試一次,但這次不再重試,避免迴圈
        img.onerror = null;
        img.src = fallback;
      } else {
        resolve({ ok: false, width: 0, height: 0 });
      }
    };

    img.src = url;
  });
}

// 使用
checkImage('/images/avatar.jpg', '/images/default.png')
  .then(function (r) {
    if (r.ok) {
      console.log('尺寸:' + r.width + ' x ' + r.height);
    } else {
      console.log('圖片不存在,已改用預設圖');
    }
  });

幾點實務提醒

記得先掛 onload 再指定 src。快取命中的圖片載入極快,順序顛倒會導致事件永遠不觸發。這是圖片相關程式碼最常犯的錯誤。

優先用 naturalWidth。它回傳圖片的原始尺寸,不受 CSS 縮放影響,比 width 可靠。

跨來源的圖片檢測有限制。基於同源政策,你無法讀取不同網域圖片的尺寸細節(雖然 onload 仍會觸發)。若需要,請由後端代理或設定 CORS 標頭。

大量檢測時要節制。批次檢查幾百張圖會同時發出幾百個請求。實務上應該用佇列控制併發數,或乾脆交給後端一次回傳存在清單。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved