JavaScript: The Definitive Guide, 5th Edition

Name

Document.importNode( ): copy a node from another document for use in this document — DOM Level 2 Core:

Synopsis

Node importNode(NodeimportedNode,
                boolean deep)
    throws DOMException;

Arguments

importedNode

The node to be imported.

deep

If true, recursively copy all descendants of importedNode 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, because 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 because it has not yet been inserted into the document. Event-listener 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

Node.cloneNode( )