Name

adoptNode: adoptNode, source(3)

Synopsis

Similar to importNode( ), this method is used to migrate a DOM Node from one Document instance to another. The source node is removed from the DOM tree of its parent document and prepared to be inserted into the adopting document, unlike the importNode() method which creates a copy of the source node and leaves the original in place. The following table explains the behavior of this method for the individual node types:

Node type	Result
ATTRIBUTE_NODE	Adopts the source attribute and all its children. The ownerElement attribute is set to null, and the specified flag is set to true.
DOCUMENT_FRAGMENT_NODE	Adopts the DocumentFragment node along with all of its child nodes.
DOCUMENT_NODE	Cannot be adopted.
DOCUMENT_TYPE_NODE	Cannot be adopted.
ELEMENT_NODE	Adopts the element as well as all child nodes. Adopts the attribute nodes that have their specified flag set, and may insert additional attributes based on the DTD or schema of the target document.
ENTITY_NODE	Cannot be adopted.
ENTITY_REFERENCE_NODE	Adopts only the EntityReference node. Its value, if any, is taken from the DTD of the document doing the import.
NOTATION_NODE	Cannot be adopted.
PROCESSING_INSTRUCTION_ NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE	All adopted without restrictions.

Since the newly adopted node was not created by the target document, it is possible that the names of elements, attributes, etc., may not conform to the XML version of the new document (see the xmlVersion attribute). Consider using the normalizeDocument( ) method to ensure that adopted nodes are well-formed.

Argument

source: Node

The node to be adopted.

Exceptions

NOT_SUPPORTED_ERR

Thrown if an attempt is made to import an unsupported Node type, such as a Document node.

NO_MODIFICATION_ALLOWED_ERR

Thrown if the source node is read-only.

Java binding

public Node adoptNode(Node source) throws DOMException;