想取得圖片的寬高,自然的做法是等它載入完成再讀,於是寫了 onload。但圖片是遠端的,而問題出在 IE:第二次顯示同一張圖時,onload 完全不觸發。
原本的程式碼是這樣:
var img = new Image();
img.src = "loading.gif";
img.onload = function () {
var iheight = img.height;
var iwidth = img.width;
};
請注意順序——src 寫在 onload 之前。
給同事看過之後才發現問題所在:src 應該放在 onload 之後設定。
var img = new Image();
img.onload = function () {
var iheight = img.height;
var iwidth = img.width;
};
img.src = "loading.gif"; // 監聽器先掛好,再開始載入
設定了 src 之後,瀏覽器會立刻開始載入。如果這個圖片已經在快取裡(第二次載入就是這種情況),載入可能在幾毫秒內就完成,甚至在同一次事件迴圈中觸發 load——此時你的 onload 還沒掛上去,事件自然被錯過,永遠等不到。
IE 在讀取緩存資料時不會觸發 onload,Firefox 則會「順便」補觸發一次。這種瀏覽器之間的行為差異,正是 bug 難纏的原因:它只在特定條件下出現,換個瀏覽器又好了。
除了調整順序,還要處理「圖片已完成載入」的情況:
var img = new Image();
img.onload = function () {
console.log(img.width, img.height);
};
img.src = "loading.gif";
// 保險:若 src 設定時圖片已在快取中且已完成,補一次呼叫
if (img.complete) {
img.onload();
}
這裡的 img.complete 是關鍵。它在圖片已載入完成(不論來自網路或快取)時為 true,因此可以用來判斷是否該手動補觸發。要注意 complete 為 true 不代表載入成功——圖片 404 時它同樣為 true,若要區分成功與失敗,需搭配 img.naturalWidth > 0 判斷,或一併掛上 onerror。
這其實是一條通用原則:先掛監聽器,再觸發可能產生結果的操作。用 addEventListener、Ajax、Web Worker 時都一樣,順序顛倒就會出現難以重現的間歇性 bug。
另外提到一個附帶發現:在 onload 裡若還要對圖片做自適應調整,有時得在 onload 內再設定一次 img.src,否則它只記得第一張圖。這通常意味著元素被重複使用而狀態沒清乾淨——遇到這種情況,與其反覆重設 src,不如每次重新建立 Image 物件,狀態會清楚得多。
今日若只是要取得圖片尺寸,也可以考慮 img.decode()(回傳 Promise,能明確等待解碼完成)或直接讀取 naturalWidth / naturalHeight,比 width / height 更可靠——後者受 CSS 影響,可能回傳的是顯示尺寸而非原始尺寸。