HTML5 提供的跨文件消息傳輸(Cross-document messaging)機制,讓不同來源、彼此隔離的視窗與 iframe 之間可以安全地交換訊息。核心只有兩個 API:接收端監聽 window 的 message 事件,發送端呼叫 postMessage()。
window.addEventListener("message", function (event) {
// 在這裡處理收到的訊息
}, false);
otherWindow.postMessage(message, targetOrigin);
這個方法有兩個參數。第一個參數是要傳送的內容,可以是字串,也可以是任何 JavaScript 物件(透過 JSON 在物件與文字之間轉換)。第二個參數是接收方視窗的 URL;字串中可以使用萬用字元「*」放寬比對,但實務上強烈建議填入精確的 URL,以避免訊息外洩。
其中 otherWindow 是目標視窗物件的參照,取得方式有兩種:由 window.open() 的回傳值取得,或透過 window.frames 陣列以索引(index)或名稱取出單一 frame 所屬的視窗物件。
主頁面
<!DOCTYPE Html>
<Html>
<head>
<meta charset="UTF-8"/>
<title>跨文件消息傳輸示例主文檔</title>
<script type="text/Javascript" src="https://code.jquery.com/jquery-1.6.4.min.js"></script>
<script type="text/Javascript">
$(function() {
// 監聽 message 事件
window.addEventListener("message", function(event) {
// 忽略指定 URL 之外的頁面送來的消息
if (event.origin != "https://www.blue-butterfly.Net") return;
alert(event.data); // 顯示消息
}, false);
$("#iframeContent").load(function(event) {
// 向子頁面發送消息
this[0].postMessage("Hello", "https://www.blue-butterfly.Net/test/");
});
});
</script>
</head>
<body>
<header>
<h1>跨域通信示例</h1>
</header>
<iframe id="iframeContent" width="400" src="https://www.blue-butterfly.Net/test/"></iframe>
</body>
</Html>
子頁面(iframe 內容)
<!DOCTYPE Html>
<Html>
<head>
<meta charset="UTF-8"/>
<script type="text/Javascript" src="https://code.jquery.com/jquery-1.6.4.min.js"></script>
<script type="text/Javascript">
$(function() {
window.addEventListener("message", function(event) {
if (event.origin != "https://Lulingniu") return;
$("#console").append(event.origin).append("傳來的消息:").append(event.data);
// 向主頁面發送消息
event.source.postMessage("Hello, there is :" + this.location, event.origin);
}, false);
});
</script>
</head>
<body>
<p>這是 iframe 中的內容。</p>
<div id="console"></div>
</body>
</Html>
https://Lulingniu,子頁面的來源是 https://www.blue-butterfly.Net。特別注意:來源(origin)與網站的 URL 不是同一個概念,origin 只包含「通訊協定+網域+連接埠」。為了不接收其他來源惡意送出的訊息,務必對 origin 做檢查。實務上,只要涉及 iframe 嵌入、跨網域視窗互動,或第三方腳本與主站溝通,這套機制幾乎都是首選。切記兩條安全底線:發送時給出精確的 targetOrigin,接收時驗證 event.origin。