萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 與 iframe 交互全景指南:同域操作、跨子域 document.domain、跨域 postMessage 通信

iframe 嵌入頁面時,父子頁面通信受同源策略限制。本文系統梳理**同域/跨子域直接操作 DOM**、**完全跨域 postMessage 通信**兩大體系,並在 9 款主流瀏覽器 (IE6-IE8, Firefox 2/3/3.6, Chrome 8, Opera 11, Safari 5) 實測兼容性,給出生產級最佳實踐。

一、同域或跨子域:直接讀寫 DOM

1. 父頁面操作子頁面

<iframe id="test-iframe" name="test-iframe" src="child.html" scrolling="no" frameborder="0"></iframe>
<script>
window.onload = function() {
    // 必須在 onload 後訪問,否則 IE6/7 報「拒絕訪問」
    // 方式一:window.frames["name"] (通用,含 IE6/7)
    var doc = window.frames["test-iframe"].document;
    // 方式二:contentDocument (IE8+, 現代瀏覽器)
    // var doc = document.getElementById("test-iframe").contentDocument;
    
    doc.getElementsByTagName('h1')[0].innerHTML = '父頁修改子頁標題';
    alert(doc.getElementsByTagName('h1')[0].firstChild.data);
};
</script>

2. 子頁面操作父頁面

<script>
parent.document.getElementsByTagName('h1')[0].innerHTML = '子頁修改父頁標題';
alert(parent.document.getElementsByTagName('h1')[0].firstChild.data);
</script>

3. 跨子域配置

父頁面與子頁面主域相同 (如 a.example.com 嵌入 b.example.com) 時,雙方 JS 頭部均需設置:

document.domain = 'example.com'; // 必須設置為相同主域

設置後,雙方視為同源,可直接互訪 DOM。

4. 兼容性測試結果

  • ✅ 通過:IE6, IE7, IE8, Firefox 2.0/3.0/3.6, Chrome 8, Opera 11, Safari 5。
  • ⚠️ 注意:IE6/7 僅支援 window.frames["name"].document,不支援 contentDocument。
  • ⚠️ document.getElementById('id').contentDocument 等價於 window.frames["name"].document。

二、完全跨域:postMessage / Hash Hack 通信

當域名完全不同時 (如 xxx.com 嵌入 yyy.com),無法直接操作 DOM,只能通過 location.hash 變化傳遞消息 (老技巧) 或現代 postMessage。

1. 老式 Hash 輪詢方案 (不推薦新項目使用)

// 父頁面 (xxx.com/father.html)
<iframe id="test-iframe" src="https://www.yyy.com/child.html"></iframe>
<input type="button" value="send" onclick="sendRequest()" />
<script>
function sendRequest() {
    document.getElementById('test-iframe').src += '#action=refresh'; // 改變 hash 觸發子頁面輪詢檢測
}
var interval = setInterval(function(){
    if (location.hash) { alert('收到子頁回傳: ' + location.hash); clearInterval(interval); }
}, 1000);
</script>
// 子頁面 (yyy.com/child.html)
<h1>RRRRRR</h1>
<script>
var url = 'https://www.xxx.com/father.html';
var oldHash = self.location.hash;
setInterval(function(){
    var newHash = self.location.hash;
    if (oldHash !== newHash) {
        document.getElementsByTagName('h1')[0].innerHTML = 'pp'; // 響應父頁指令
        // 回傳:修改父頁 hash (會導致父頁歷史記錄增加)
        parent.location.href = url + '#response=ok'; 
        clearInterval(interval);
    }
}, 500);
</script>

Hash 方案缺陷

  • 汙染瀏覽器歷史記錄 (用戶點返回會回到上一個 hash 狀態)。
  • 輪詢消耗資源,延遲不可控。
  • IE6/7 修改 hash 不觸發 onhashchange,需輪詢;現代瀏覽器修改 hash 會記錄歷史。
  • 子頁無法讀取父頁完整 URL (無權限),只能寫入,故父頁 URL 需雙方約定好。

2. 現代標準:window.postMessage (強烈推薦)

// 父頁面
var iframe = document.getElementById('test-iframe');
iframe.onload = function() {
    iframe.contentWindow.postMessage({cmd: 'refresh', payload: {id: 123}}, 'https://www.yyy.com');
};
window.addEventListener('message', function(e) {
    if (e.origin !== 'https://www.yyy.com') return; // 嚴格驗證源
    if (e.data.type === 'result') console.log('子頁返回:', e.data.data);
});

// 子頁面
window.addEventListener('message', function(e) {
    if (e.origin !== 'https://www.xxx.com') return;
    if (e.data.cmd === 'refresh') {
        // 執行刷新邏輯
        document.getElementsByTagName('h1')[0].innerHTML = 'pp';
        // 回傳結果
        e.source.postMessage({type: 'result', data: {status: 'ok'}}, e.origin);
    }
});

三、工程化最佳實踐總結

場景推薦方案關鍵點
同域直接 DOM 訪問iframe.onload 後用 contentDocument 或 .contents()
跨子域 (主域相同)document.domain + DOM雙方同步設置 document.domain,**注意:標準已廢棄,Chrome 100+ 可能移除**
完全跨域postMessage**唯一標準、安全、異步、不汙染歷史**,嚴格驗證 e.origin
嵌入第三方 (支付/地圖/編輯器)postMessage SDK定義嚴格消息協議,雙方約定 type/payload 結構

避坑清單

  • ❌ 使用 parent.location.replace 試圖避免歷史記錄 — **無效**,父頁仍會導航。
  • ❌ 子頁嘗試讀取 parent.location.href — **跨域拒絕訪問**。
  • ✅ 關鍵數據交互走後端 API,前端僅做 UI 觸發,降低耦合與安全風險。
  • ✅ 新架構優先考慮 **微前端 / Web Components / 模塊聯邦** 替代 iframe。

iframe 通信是前端工程師必修課,理解同源策略邊界與 postMessage 協議設計,能從容應對嵌入式開發、第三方集成、微前端沙箱隔離等高階場景。

copyright © 萬盛學電腦網 all rights reserved