萬盛學電腦網

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

iframe 子頁面呼叫父頁面 JavaScript 函數(同源/跨域完整說明)

同源環境:直接呼叫

// 子頁面
// 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 安全通訊

當父子頁面不同源(域名、協定、埠號任一不同)時,直接存取會被瀏覽器阻擋,必須用 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 後發送

安全性最佳實踐

  1. 嚴格驗證 e.origin:不信任則直接 return。
  2. 定義明確的訊息協定:{type, requestId, action, data},避免任意程式碼執行。
  3. 不直接 eval 或 new Function 處理訊息內容。
  4. 設定 X-Frame-Options 或 Content-Security-Policy: frame-ancestors 限制誰能嵌入你的頁面。
copyright © 萬盛學電腦網 all rights reserved