window.name 這項技巧最早由 Thomas Frank 提出,目的在繞開 cookie 的先天限制:每個域名 4×20KB 的容量上限、只能存字串、設定與讀取的語法繁瑣等等。後來 Kris Zyp 在此基礎上強化了傳輸機制,並把它整合進 Dojo(dojox.io.windowName),正式用來解決跨域資料傳輸的問題。
它最迷人的地方在於:name 的值在頁面跳轉、甚至跨域名載入之後依然存在,而且能承載相當長的內容(可達 2MB 等級)。
name 是瀏覽器環境中 window 物件上的屬性。當 iframe 內載入新頁面時,這個屬性值不會被清除。於是流程變成:
先在 iframe 中載入遠端資源,由該頁面把 frame 的 name 屬性設為要傳遞的資料;主頁面把 iframe 導航回自己的域名後,就能讀取 name,取得 Web 服務送出的資訊。之所以能這樣做,是因為同源策略只允許同域的 frame 存取 name;而一旦資料取到手,就立刻銷毀這個 iframe。
要注意的是,在最頂層視窗裡,name 是不安全的——後續任何頁面都能讀到裡面的資訊。因此這個模組總是把資源載入 iframe 中,並在取到資料後馬上銷毀 frame,其他頁面自然再也碰不到 window.name。
以下範例以 YUI 為基礎:
(function(){
var YUD = YAHOO.util.Dom, YUE = YAHOO.util.Event;
var dataRequest = {
_doc: document,
cfg: {
proxyUrl: 'proxy.html'
}
};
dataRequest.send = function(sUrl, fnCallBack){
if(!sUrl || typeof sUrl !== 'string'){
return;
}
sUrl += (sUrl.indexOf('?') > 0 ? '&' : '?') + 'windowname=true';
var frame = this._doc.createElement('iframe'), state = 0, self = this;
this._doc.body.appendChild(frame);
frame.style.display = 'none';
var clear = function(){
try{
frame.contentWindow.document.write('');
frame.contentWindow.close();
self._doc.body.removeChild(frame);
}catch(e){}
};
var getData = function(){
try{
var data = frame.contentWindow.name;
if(typeof fnCallBack === 'function'){
fnCallBack(data);
}
clear();
}catch(e){}
};
frame.onload = function(){
if(state === 0){
state = 1;
frame.contentWindow.location.href = self.cfg.proxyUrl;
}else if(state === 1){
state = 2;
getData();
}
};
frame.src = sUrl;
};
})();
配套的 proxy.html 只需要是個放在同域下的空白頁,它的存在就是為了讓 iframe 在讀取 name 之前先「回家」。
這套做法的代價是多一次請求與一個隱藏 frame,但換來的是不受 4KB 限制的資料通道,在需要跨域傳遞較大結構化資料時相當實用。