// 子頁面
// 1. 呼叫父頁面全域函數
window.parent.myFunction();
// 2. 傳遞參數
window.parent.myFunction('參數1', {key: 'value'});
// 3. 存取父頁面變數/元素
const val = window.parent.document.getElementById('someId').value;
const globalVar = window.parent.someGlobalVariable;
當父子頁面不同源(域名、協定、埠號任一不同)時,直接存取會被瀏覽器阻擋,必須用 postMessage。
<iframe id="childFrame" src="https://child.example.com/page.html"></iframe>
<script>
const allowedOrigin = 'https://child.example.com';
window.addEventListener('message', e => {
// 安全性:驗證來源
if (e.origin !== allowedOrigin) return;
const {type, payload} = e.data;
switch (type) {
case 'CALL_PARENT_FN':
handleChildRequest(payload);
break;
case 'RESIZE_IFRAME':
document.getElementById('childFrame').style.height = payload.height + 'px';
break;
}
});
function handleChildRequest(payload) {
// 執行父頁面邏輯
console.log('子頁面請求:', payload);
// 回應子頁面
document.getElementById('childFrame').contentWindow.postMessage(
{type: 'RESPONSE', requestId: payload.requestId, result: 'ok'},
allowedOrigin
);
}
</script>
<script>
const PARENT_ORIGIN = 'https://parent.example.com';
let requestId = 0;
const pendingCallbacks = new Map();
// 發送請求給父頁面
function callParent(action, data) {
return new Promise((resolve, reject) => {
const id = ++requestId;
pendingCallbacks.set(id, {resolve, reject, timeout: setTimeout(() => reject(new Error('Timeout')), 5000)});
window.parent.postMessage(
{type: 'CALL_PARENT_FN', requestId: id, action, data},
PARENT_ORIGIN
);
});
}
// 接收父頁面回應
window.addEventListener('message', e => {
if (e.origin !== PARENT_ORIGIN) return;
const {type, requestId, result, error} = e.data;
if (type === 'RESPONSE' && pendingCallbacks.has(requestId)) {
const {resolve, reject, timeout} = pendingCallbacks.get(requestId);
clearTimeout(timeout);
pendingCallbacks.delete(requestId);
error ? reject(new Error(error)) : resolve(result);
}
});
// 使用範例
async function saveData() {
try {
const result = await callParent('save', {name: 'Test'});
console.log('父頁面回應:', result);
} catch (err) {
console.error('呼叫失敗:', err);
}
}
</script>
| 錯誤 | 原因 | 解決 |
|---|---|---|
Blocked a frame with origin "..." from accessing a cross-origin frame | 直接存取跨域 iframe DOM/函數 | 改用 postMessage |
window.parent.myFunction is not a function | 父頁面未定義該函數、拼字錯誤、腳本未載入完成 | 在父頁面 window.onload 後才呼叫、檢查拼字 |
| postMessage 收不到 | origin 不匹配、iframe 尚未載入、目標視窗已關閉 | 確認 origin 字串完全一致(含協定、埠)、在 iframe onload 後發送 |
e.origin:不信任則直接 return。{type, requestId, action, data},避免任意程式碼執行。eval 或 new Function 處理訊息內容。X-Frame-Options 或 Content-Security-Policy: frame-ancestors 限制誰能嵌入你的頁面。