Document.adoptNode用于安全迁移同源iframe中的DOM节点到主文档，解决直接appendChild报错、importNode丢失状态等问题，能保持结构属性并重绑定文档上下文，但不迁移事件监听器且不支持跨域。

Document.adoptNode 是浏览器原生提供的、用于安全地将一个节点从其原始文档“迁移”到当前文档的方法，特别适用于处理 iframe 中的 DOM 节点——因为直接 appendChild 或 importNode 可能失败或引发异常（如跨源 iframe 不允许访问 contentDocument，或同源但节点仍绑定旧文档上下文）。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

为什么不能直接移动 iframe 中的节点？

DOM 节点与其创建时所在的 document 强绑定。即使 iframe 与主页面同源，从中取出的节点（如 iframe.contentDocument.body.firstChild）仍属于 iframe 的文档对象，不能直接插入主文档：
– 直接 document.body.appendChild(node) 会抛出 "HierarchyRequestError" 或静默失败；
– document.importNode(node, true) 可以克隆，但会丢失事件监听器、自定义属性状态、以及部分内部引用（如 node.dataset 值保留，但 node.isConnected 为 false，且无法恢复原始绑定）；
– adoptNode 则真正“转移”所有权：节点被解除与原文档的关联，并重绑定到目标文档，保持其完整结构、属性、文本内容，且可正常参与主文档渲染和交互。

基本用法：同源 iframe 中安全迁移节点

前提：iframe 必须同源（协议、域名、端口一致），否则 iframe.contentDocument 无法访问，adoptNode 无从谈起。

• 获取 iframe 内的目标节点（例如第一个子元素）：
  const iframe = document.getElementById('myIframe');
const iframeDoc = iframe.contentDocument || iframe.contentWindow?.document;
const nodeToMove = iframeDoc.body.firstElementChild;
• 用主文档 adopt 该节点：
  const adoptedNode = document.adoptNode(nodeToMove);
• 插入到主文档任意位置：
  document.body.appendChild(adoptedNode);

注意事项与常见陷阱

• adoptNode 不支持 DocumentFragment 直接迁移：若需迁移多个节点，先用 DocumentFragment 包裹，再对 fragment 调用 adoptNode（它会递归处理所有后代）；单独对 fragment 子节点逐个 adopt 也可，但 fragment 本身必须是目标文档创建的。
• 事件监听器不会自动迁移：adopt 后节点上已绑定的事件监听器（通过 addEventListener 添加的）会被清除。需在 adopt 后重新绑定，或改用事件委托。
• 表单控件状态可能丢失：如 <input value="xxx"> 的实时输入值（input.value）在 adopt 后通常保留，但某些浏览器对 checked、selected 等布尔属性状态兼容性不一，建议 adopt 后显式同步：
  

  if (adoptedNode.tagName === 'INPUT' && adoptedNode.type === 'checkbox') {<br>
    adoptedNode.checked = nodeToMove.checked;<br>
  }

• 样式与 Shadow DOM 不受影响：adoptNode 不改变节点内联样式、class、或已加载的 CSS 规则；若节点含 open shadow root，shadow root 及其内容也会一同被 adopt，样式依然生效。

替代方案对比：importNode vs adoptNode

• importNode(node, deep)：只克隆，不销毁原节点；适合需要保留 iframe 内容的场景；但克隆后节点是“新对象”，=== 比较为 false，且无法继承原节点运行时状态（如 canvas 绘图上下文、video 播放位置）。
• adoptNode(node)：原节点被移除并重归属；内存更优，语义更清晰（真·迁移）；适用于“剪切+粘贴”逻辑，且要求原位置可清空。
• 两者都**不解决跨域 iframe 问题**：若 iframe 跨域，contentDocument 无法读取，任何迁移都不可行——此时只能依赖 postMessage 协议让 iframe 主动序列化数据（如 innerHTML 字符串），由主页面解析重建。