大网数据广告活动
Web 标准与前端开发

Document:adoptNode() 方法

· 52CE 我爱测

`Document.adoptNode()`** 将node/dom从另一个Document转移至调用该方法的文档中。被转移的节点及其子树将会从原始文档(如果存在的话)中移除,并且它们的 Node.ownerDocument 会变更为当前文档。然后节点将被插入到当前文档中。

DOM

Document.adoptNode() 将node/dom从另一个Document转移至调用该方法的文档中。被转移的节点及其子树将会从原始文档(如果存在的话)中移除,并且它们的 Node.ownerDocument 会变更为当前文档。然后节点将被插入到当前文档中。

语法

adoptNode(externalNode)

参数

  • externalNode
    • : 将要从另一份文档中转移的节点。

返回值

在导入文档的作用域中复制的 importedNode。

调用此方法后,importedNode 和 externalNode 是同个对象。

[!NOTE] importedNode 的 Node.parentNode 为 null,因为它尚未插入文档树中!

示例

const iframe = document.querySelector("iframe");
const iframeImages = iframe.contentDocument.querySelectorAll("img");
const newParent = document.getElementById("images");

iframeImages.forEach((imgEl) => {
  newParent.appendChild(document.adoptNode(imgEl));
});

备注

在将来自外部文档的节点插入到当前文档之前,应该先进行以下操作之一:

  • 使用 document.importNode() 进行克隆;或
  • 使用 document.adoptNode() 进行转移。

有关 Node.ownerDocument 问题的更多信息,请参阅 W3C DOM 常见问题。

规范

浏览器兼容性

参见

  • document.importNode()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。