The Document
object's importNode()
method creates a copy of a Node
or DocumentFragment
from another document, to be inserted into the current document later.
The imported node is not yet included in the document tree. To include it, you need to call an insertion method such as appendChild()
or insertBefore()
with a node that is currently in the document tree.
Unlike document.adoptNode()
, the original node is not removed from its original document. The imported node is a clone of the original.
importNode(externalNode)
importNode(externalNode, deep)
The copied importedNode
in the scope of the importing document.
Note: importedNode
's Node.parentNode
is null
, since it has not yet been inserted into the document tree!
const iframe = document.querySelector("iframe");
const oldNode = iframe.contentWindow.document.getElementById("myNode");
const newNode = document.importNode(oldNode, true);
document.getElementById("container").appendChild(newNode);
Before they can be inserted into the current document, nodes from external documents should either be:
Note: Although Firefox doesn't currently enforce this rule, we encourage you to follow this rule for improved future compatibility.
For more on the Node.ownerDocument
issues, see the W3C DOM FAQ.