「這張圖片到底在不在」是列表頁、後台管理與使用者上傳功能裡的高頻需求。以下三種做法各有適用場景。
// 檢查圖片是否存在
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 私有屬性,其他瀏覽器沒有。
最輕量的方案,不需要任何 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 標頭。
大量檢測時要節制。批次檢查幾百張圖會同時發出幾百個請求。實務上應該用佇列控制併發數,或乾脆交給後端一次回傳存在清單。