Name
Document.importNode( ) — copy a node from another document for use in this document
Availability
DOM Level 2 Core
Synopsis
Node importNode(NodeimportedNode
, booleandeep
) throws DOMException;
Arguments
-
importedNode
The node to be imported.
-
deep
If
true
, recursively copy all descendants ofimportedNode
as well.
Returns
A copy of importedNode
(and possibly all
of its descendants) with its ownerDocument
set to
this document.
Throws
This method throws a DOMException with a code
of
NOT_SUPPORTED_ERR
if
importedNode
is a Document or DocumentType
node, since those types of nodes cannot be imported.
Description
This method is passed a node defined in another document and returns
a copy of the node that is suitable for insertion into this document.
If deep
is true
, all
descendants of the node are also copied. The original node and its
descendants are not modified in any way. The returned copy has its
ownerDocument
property set to this document but
has a parentNode
of null
since
it has not yet been inserted into the document. EventListener
functions registered on the original node or tree are not copied.
When an Element node is imported, only the attributes that are
explicitly specified in the source document are imported with it.
When an Attr node is imported, its specified
property is automatically set to true
.
See Also
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.