寫通用函式庫時常會遇到一個問題:傳進來的參數可能是視窗、可能是文件、也可能是某個 DOM 元素,三者的 API 有重疊但不等同,必須先分清楚。以下提供三個判斷函數,並說明背後的技巧與陷阱。
function isWindow(obj) {
if (typeof obj.closed == 'undefined') return false;
var result = /\[object (window|global)\]/i.test(Object.prototype.toString.call(obj));
if (result) return result;
try {
obj.closed = obj.closed; // 跨域 window 上讀寫會拋安全性例外
return false;
} catch (e) {
result = true;
}
return result;
}
function isDocument(obj) {
if (typeof obj.body == 'undefined') return false;
var b = obj.body;
try {
obj.body = null; // 唯讀屬性指派會拋錯
obj.body = b;
return false;
} catch (e) {
return true;
}
}
function isElement(o) {
var tn = 'tagName', temp = o[tn], result;
if (typeof temp == 'undefined') return false;
try {
o[tn] = null;
result = (temp == o[tn]); // 指派成功且值變了 → 是一般物件
o[tn] = temp; // 還原
return !result;
} catch (e) {
return true; // 指派拋錯 → 是真正的 DOM 物件
}
}
function getOwnerWindow(node) {
if (isWindow(node)) return node;
var doc = isDocument(node) ? node : node.ownerDocument;
return doc.view || doc.parentWindow || doc.defaultView;
}
(原始碼的最後一行 parentWindiw 是拼字錯誤,已修正為 parentWindow。)
核心思路是:用「能不能寫入」來區分宿主物件與普通物件。
DOM 中的 window、document 與元素,都是由瀏覽器以 C++ 實作的宿主物件(host object),它們的某些屬性是唯讀的。在舊式瀏覽器中,對唯讀屬性指派值會拋出例外;而普通 JavaScript 物件幾乎任何屬性都能寫。於是「指派看看會不會炸」就成了判斷依據。
另一個線索是 Object.prototype.toString.call(obj)。對真正的 DOM 物件,它會回傳 [object Window]、[object HTMLDocument]、[object HTMLDivElement] 這類字串;對普通物件則一律是 [object Object]。用正则比對這個字串,是最直觀的判斷方式。
而 isWindow 裡那個 try/catch 處理的是另一個情況:跨域的 window。基於同源政策,讀取其他網站 window 的多數屬性會拋安全性例外——但「讀取會拋錯」這件事本身,反而成了它確實是 window 的證據。這是個很聰明的推論。
原始碼結尾那句「需要充分測試」其實是關鍵,因為這套寫法有幾個明確的問題:
嚴格模式會失效。 在 'use strict' 之下,對唯讀屬性指派值一律拋 TypeError,於是一般物件也會被誤判成 DOM 物件。整個判斷基礎就崩了。
現代瀏覽器不拋錯了。 ES5 之後,對唯讀屬性指派在非嚴格模式下會靜默失敗(不拋錯、也不生效)。這代表 isElement 裡的 result = (temp == o[tn]) 會得到 false,於是正確回傳 true——剛好歪打正著。但 isDocument 的邏輯反而不成立了:指派不拋錯,它就會回傳 false,把 document 誤判成普通物件。
有副作用。 這些函數會實際去寫入傳入的物件,即使最後有還原。若期間發生例外而沒走到還原那行,物件的狀態就被破壞了。
今天不需要任何技巧,用 instanceof 就好:
function isWindow(obj) {
return obj instanceof Window;
}
function isDocument(obj) {
return obj instanceof Document;
}
function isElement(obj) {
return obj instanceof Element;
}
function getOwnerWindow(node) {
if (isWindow(node)) return node;
var doc = isDocument(node) ? node : (node.ownerDocument || document);
return doc.defaultView || window;
}
若要更寬鬆地處理跨 iframe 的情況(不同 iframe 的 Window 建構子是不同的物件,instanceof 會失敗),可以改用 nodeType:
function isElement(obj) {
return !!obj && obj.nodeType === 1; // 1 = ELEMENT_NODE
}
function isDocument(obj) {
return !!obj && obj.nodeType === 9; // 9 = DOCUMENT_NODE
}
function isWindow(obj) {
return !!obj && obj.window === obj; // window 自我參照
}
nodeType 是標準定義的常數,跨 iframe、跨文件都一致,而且完全沒有副作用。這才是判斷 DOM 物件該用的方式。
最後談談 getOwnerWindow 的實用價值。它解決的是一個真實需求:拿到一個元素,想找到它所屬的視窗,以便呼叫那個視窗上的 setTimeout、getComputedStyle 或 addEventListener。在 iframe 與 popup 寫得多的年代,這很常見;今天有了 doc.defaultView 這個標準屬性,一行就能取得,不必繞路。
這段程式碼最大的教學價值,反而在於它示範了「用拋錯當作偵測手段」這種思路的極限。它聰明、但它依賴實作細節、它會在語言升級時靜默失效。當你在程式碼裡看到 try/catch 包著一行「故意要它失敗」的敘述時,值得多想一秒:有沒有不靠副作用就能問出答案的方法?大多數時候,答案是有的。