最近在開發一個能將網頁資源連結轉為 QR Code、方便行動裝置瀏覽的 Chrome 擴充功能。由於 DOM 操作不多,且身為擴充功能無須考慮跨瀏覽器相容性,我選擇使用原生 DOM API 而非 jQuery。其中一項需求是取得元素相對於文件的偏移量 offset,我寫出的方法如下:
function getOffset(ele){
if (!ele || ele.nodeType != 1) {
return;
}
var rect = ele.getBoundingClientRect(),
doc = ele.ownerDocument.documentElement;
return {
top: rect.top + window.pageYOffset - doc.clientTop,
left: rect.left + window.pageXOffset - doc.clientLeft
};
}
因為曾看過一些 jQuery 源碼,寫起來頗順手,跑起來也沒發現問題。正當得意時,我好奇 jQuery 是怎麼實作的,翻了一下(version 2.1.1):
offset: function(options) {
if (arguments.length) {
return options === undefined ?
this :
this.each(function(i) {
jQuery.offset.setOffset(this, options, i);
});
}
var docElem, win,
elem = this[0],
box = { top: 0, left: 0 },
doc = elem && elem.ownerDocument;
if (!doc) { return; }
docElem = doc.documentElement;
if (!jQuery.contains(docElem, elem)) { return box; }
if (typeof elem.getBoundingClientRect !== strundefined) {
box = elem.getBoundingClientRect();
}
win = getWindow(doc);
return {
top: box.top + win.pageYOffset - docElem.clientTop,
left: box.left + win.pageXOffset - docElem.clientLeft
};
}
仔細一看,除了相容性處理與 jQuery 物件操作外,核心邏輯幾乎與我的一致。不過有一行引起了我的注意:win = getWindow(doc),趕緊去查它的實作:
function getWindow(elem) {
return jQuery.isWindow(elem) ? elem : elem.nodeType === 9 && elem.defaultView;
}
等等,defaultView 是什麼?我們知道當 nodeType 為 9 時,該節點就是 document。那麼 document.defaultView 和我代碼裡的 window 有什麼不同?
document.defaultView === window // true
既然如此,為什麼還要多此一舉?是 jQuery 在故弄玄虛嗎?
打開 MDN,找到了 Document.defaultView 的描述:
概要:在瀏覽器中返回關聯 document 的 window 對象,若無則返回 null。
用法:var win = document.defaultView;
這是一個唯讀屬性。
注意:在 quirks mode 模式下,IE 9 以下版本不支援 defaultView。
既然有這個 API,必有其用途。MDN 說它是 document 關聯的 window 對象,那麼它的價值應該體現在「當前上下文的 window 不等於當前 document 關聯的 window」時,也就是 window !== document.defaultView 的情況。我想到三種情境:frame、popup、extension。
測試結果頗令人意外——不論是 iframe、window.open 開啟的彈出視窗,還是我寫的 Chrome 擴充功能裡的 background.js 與 content.js,window === document.defaultView 一律返回 true。
於是我想到了 Firefox 擴充功能。雖然自己沒有開發經驗,但搜尋後發現一段說明:若擴充功能運行在 Firefox 31 以下版本,在 content.js 裡必須使用 document.defaultView.postMessage。繼續深挖,終於在 MDN 找到關鍵段落——大多數情況下 getComputedStyle 可以直接從 window 取得,但有一個例外:使用 Firefox 3.6 存取框架(framed)樣式時,必須透過 document.defaultView 才能取得 window 對象並呼叫其 getComputedStyle 方法。
謎底終於揭曉:jQuery 保留 defaultView,正是為了相容這些老舊的 Firefox 版本。
時常聽人抱怨 jQuery 的代碼「強大」得離譜,用盡各種奇技淫巧去相容所有瀏覽器,即便到了 2.1.1 版仍保留對低版本 Firefox 的支援。回想那個前端開發仍處於蠻荒的時代,jQuery 的出現堪稱里程碑,它極大解放了前端生產力,讓開發者能有餘力打造各種工具與規範,才有了今日大前端時代的到來。