**父頁面與 iframe 頁面必須同源 (協議、域名、端口一致)**,否則無法訪問彼此 DOM,拋出 SecurityError。跨域場景需用 postMessage 通信。
| 場景 | 推薦寫法 | 說明 |
|---|---|---|
| 父頁面查找 iframe 內元素 | $('#iframeId').contents().find('.target') | .contents() 獲取 iframe 的 document |
| 父頁面查找 iframe 內元素 (按 name) | $(window.frames['iframeName'].document).find('.target') | 兼容性好,無需 iframe id |
| iframe 內查找父頁面元素 | $('#target', parent.document) 或 $(parent.document).find('#target') | parent.document 直接引用父文檔 |
| iframe 內查找頂層頁面元素 | $('#target', top.document) | 跨多層 iframe 直達頂層 |
| 父頁面查找巢狀 iframe | $(window.frames['iframe1'].frames['iframe2'].document).find('.target') | 逐級訪問 frames 集合 |
// 方式 1:length 判斷 (推薦)
var $el = $('#iframeId').contents().find('.target');
if ($el.length > 0) {
console.log('存在', $el);
} else {
console.log('不存在');
}
// 方式 2:原生 DOM (無 jQuery 依賴)
var iframe = document.getElementById('iframeId');
var el = iframe.contentDocument.querySelector('.target');
if (el) { /* 存在 */ }
// 方式 3:封裝通用函數
function findInIframe(iframeSelector, selector) {
var $iframe = $(iframeSelector);
if (!$iframe.length) return $();
try {
return $iframe.contents().find(selector);
} catch (e) {
console.error('跨域或 iframe 未就緒:', e);
return $();
}
}
// 使用
var $btn = findInIframe('#myIframe', '.submit-btn');
if ($btn.length) $btn.click();
// 1. 原生 onload
document.getElementById('myIframe').onload = function () {
// 此時可以安全訪問 contentDocument
var $doc = $(this.contentDocument);
$doc.find('.btn').click();
};
// 2. jQuery ready (需 iframe 頁面也引入 jQuery)
$('#myIframe').on('load', function () {
$(this).contents().find('.btn').click();
});
// 3. 動態創建 iframe
var $iframe = $('
var targetOrigin = 'https://child.example.com'; // 生產環境指定具體源,* 僅調試用
// 發送消息
function sendToIframe(data) {
var iframe = document.getElementById('myIframe');
iframe.contentWindow.postMessage(JSON.stringify(data), targetOrigin);
}
// 接收回應
window.addEventListener('message', function (e) {
if (e.origin !== targetOrigin) return; // 安全校驗
var data = JSON.parse(e.data);
if (data.type === 'elementFound') {
console.log('iframe 回報找到元素:', data.selector);
}
});
// 觸發查找
sendToIframe({ type: 'find', selector: '.target' });
window.addEventListener('message', function (e) {
if (e.origin !== 'https://parent.example.com') return;
var data = JSON.parse(e.data);
if (data.type === 'find') {
var el = document.querySelector(data.selector);
var found = !!el;
var info = found ? {
tag: el.tagName,
id: el.id,
class: el.className,
rect: el.getBoundingClientRect()
} : null;
e.source.postMessage(JSON.stringify({
type: 'elementFound',
selector: data.selector,
found: found,
info: info
}), e.origin);
}
});
| 問題 | 原因 | 解決 |
|---|---|---|
Permission denied to access property "document" | 跨域 | 用 postMessage;或服務端配置 document.domain (僅同主域子域、已棄用) |
| iframe 內容未加載完就操作 | 未等待 load 事件 | 綁定 iframe.onload 或 $iframe.on('load') |
.contents() 返回空 / 報錯 | iframe src 為 about:blank 或 javascript: 或 data: 協議 | 確保 src 為正常 HTTP/HTTPS 頁面 |
| 動態修改 iframe src 後選擇器失效 | 舊 document 引用失效 | 每次 load 後重新獲取 .contents() |
| 查找不到元素但確信存在 | iframe 內有 Shadow DOM | 需 shadowRoot.querySelector 穿透 Shadow DOM |
var FrameUtils = (function () {
function getDoc(iframeEl) {
try {
return iframeEl.contentDocument || iframeEl.contentWindow.document;
} catch (e) {
return null; // 跨域或未就緒
}
}
function $(selector, context) {
return (context || document).querySelectorAll(selector);
}
return {
// 父頁面調用:在 iframe 中查找
find: function (iframeSelector, selector) {
var iframe = typeof iframeSelector === 'string'
? document.querySelector(iframeSelector)
: iframeSelector;
var doc = getDoc(iframe);
return doc ? Array.from(doc.querySelectorAll(selector)) : [];
},
// 父頁面調用:在 iframe 中執行函數 (同域)
exec: function (iframeSelector, fn) {
var iframe = typeof iframeSelector === 'string'
? document.querySelector(iframeSelector)
: iframeSelector;
var win = iframe.contentWindow;
return fn.call(win, win.document);
},
// iframe 內調用:查找父頁面
findParent: function (selector) {
return Array.from(parent.document.querySelectorAll(selector));
},
// iframe 內調用:執行父頁面函數
execParent: function (fn) {
return fn.call(parent, parent.document);
},
// 等待 iframe 加載完成
onReady: function (iframeSelector, callback) {
var iframe = typeof iframeSelector === 'string'
? document.querySelector(iframeSelector)
: iframeSelector;
if (iframe.onload) {
var old = iframe.onload;
iframe.onload = function () { old(); callback(); };
} else {
iframe.onload = callback;
}
}
};
})();
// 使用
FrameUtils.onReady('#myIframe', function () {
var buttons = FrameUtils.find('#myIframe', '.btn');
buttons.forEach(function (btn) { btn.click(); });
});
jQuery 操作 iframe DOM 核心是 .contents() 獲取文檔對象,**前提是同源且已加載完成**。現代開發推薦:
$('#iframe').contents().find(...) + load 事件FrameUtils 統一入口,屏蔽 contentDocument/contentWindow 兼容性差異