萬盛學電腦網

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

HTML5 window.postMessage 實現跨域通訊完整範例

背景

同源策略限制下,跨域 iframe/視窗通訊傳統方案(document.domain、location.hash、window.name、Flash)皆有缺陷。HTML5 postMessage 提供標準、安全的跨文件訊息傳遞。

API 速查

  • 發送:targetWindow.postMessage(message, targetOrigin)
    • message:字串或物件(IE8/9 僅支援字串,需 JSON.stringify)。
    • targetOrigin:'*'(不限)或具體來源 'https://example.com'(安全)。
  • 接收:監聽 message 事件
    window.addEventListener('message', function(e){
        if (e.origin !== 'https://trusted.com') return; // 驗證來源
        console.log('收到:', e.data);
        // e.source 可回傳訊息:e.source.postMessage('ack', e.origin);
    });

完整範例:父頁面 ↔ 子 iframe

// parent.html
<iframe id="child" src="https://child.example.com/iframe.html"></iframe>
<script>
var childWin = document.getElementById('child').contentWindow;
childWin.postMessage({type: 'init', data: 'hello'}, 'https://child.example.com');

window.addEventListener('message', function(e){
    if (e.origin !== 'https://child.example.com') return;
    if (e.data.type === 'ready') console.log('子頁面就緒');
});
// iframe.html (child.example.com)
window.addEventListener('message', function(e){
    if (e.origin !== 'https://parent.example.com') return;
    if (e.data.type === 'init') {
        e.source.postMessage({type: 'ready'}, e.origin);
    }
});

IE8/9 相容寫法

if (window.addEventListener) {
    window.addEventListener('message', handler, false);
} else {
    window.attachEvent('onmessage', handler);
}
// 發送時 message 傳字串:JSON.stringify(obj)

安全最佳實務

  1. **永遠驗證 e.origin**,拒絕非預期來源。
  2. **指定具體 targetOrigin**,避免資料洩漏至惡意網域。
  3. 訊息結構化:{type: 'action', payload: {...}},避免衝突。
  4. 敏感資料勿透過 postMessage 傳遞,改用後端 API 驗證。

應用場景

  • 第三方登入彈窗(OAuth 回調)。
  • 嵌入式 Widget(付費牆、聊天機器人、地圖)與主站雙向通訊。
  • 微前端架構下子應用間通訊。
copyright © 萬盛學電腦網 all rights reserved