在開發過程中,我們常常需要讓來自不同來源的頁面互相溝通,而 HTML5 提供的 postMessage 正是實現跨域通訊的利器。以下透過一組「入口頁」與「內嵌頁」的範例,說明它的實際用法。
這個頁面作為主頁,透過 iframe 嵌入另一個來源的頁面,並負責傳送與接收訊息:
<!DOCTYPE html>
<title>標題</title>
<link rel="stylesheet" href="styles.css">
<link rel="icon" href="https://apress.com/favicon.ico">
<script>
var targetOrigin = "https://22527.vhost20.boxcdn.cn";
var defaultTitle = "Portal";
var notificationTimer = null;
function messageHandler(e) {
if (e.origin == targetOrigin) {
notify(e.data);
} else {
// 忽略其他來源的訊息
}
}
function sendString(s) {
document.getElementById("widget").contentWindow.postMessage(s, targetOrigin);
}
function notify(message) {
stopBlinking();
blinkTitle(message, defaultTitle);
}
function stopBlinking() {
if (notificationTimer !== null) {
clearTimeout(notificationTimer);
}
document.title = defaultTitle;
}
function blinkTitle(m1, m2) {
document.title = m1;
notificationTimer = setTimeout(blinkTitle, 1000, m2, m1)
}
function sendStatus() {
var statusText = document.getElementById("statusText").value;
sendString(statusText);
}
function loadDemo() {
document.getElementById("sendButton").addEventListener("click", sendStatus, true);
document.getElementById("stopButton").addEventListener("click", stopBlinking, true);
sendStatus();
}
window.addEventListener("load", loadDemo, true);
window.addEventListener("message", messageHandler, true);
</script>
<h1>跨域通訊</h1>
傳遞訊息:<input type="text" id="statusText" value="Online">
<button id="sendButton">確定</button>
<iframe id="widget" src="https://22527.vhost20.boxcdn.cn/postMessageWidget.html"></iframe>
<p>
<button id="stopButton">停止標題閃爍</button>
</p>
這個頁面被嵌入到主頁的 iframe 中,負責接收主頁傳來的訊息,並能反向傳送訊息給上層視窗:
<!DOCTYPE html>
<title>標題</title>
<link rel="stylesheet" href="styles.css">
<script>
var targetOrigin = "https://www.weixiu0376.cn";
// 建議建立白名單陣列
function messageHandler(e) {
if (e.origin === "https://www.weixiu0376.cn") {
document.getElementById("status").textContent = e.data;
} else {
// 忽略其他來源的訊息
}
}
function sendString(s) {
window.top.postMessage(s, targetOrigin);
}
function loadDemo() {
document.getElementById("actionButton").addEventListener("click",
function() {
var messageText = document.getElementById("messageText").value;
sendString(messageText);
}, true);
}
window.addEventListener("load", loadDemo, true);
window.addEventListener("message", messageHandler, true);
</script>
<p>顯示接收訊息: <strong id="status"></strong>
<div>
<input type="text" id="messageText" value="填寫訊息內容">
<button id="actionButton">發送訊息</button>
</div>
從範例中不難看出,postMessage 的關鍵在於三個部分:發送時指定目標來源(targetOrigin)、接收時透過 message 事件監聽、以及務必檢查 e.origin 以確保訊息來自可信的來源。特別是在正式環境中,強烈建議建立來源白名單,避免執行任何來路不明的資料,才能兼顧功能與安全性。