Document.adoptNode()

Adopta un nodo extreno. El nodo y sub subnodos son quitados del documento en que se encuentra  y su nuevo  ownerDocument se cambia por el actual. El nodo puede entoces ser insertado en el documento actual.

Soportado desde Gecko 1.9 (Firefox 3)

Syntaxis

node = document.adoptNode(externalNode);

   node

es el nodo adoptado que recibe este documento como su propietario (ownerDocument) .  Su nodo padre (parentNode) se establece a null, esto se debe a que aún no a sido insertado en el arbol del documento.  En este punto node y externalNode refieren al mismo objeto luego de esta llamada .  

externalNode

es el nodo a ser adoptado desde otro documento.

Ejemplo

var iframe = document.getElementById('my-iframe');
var iframeImages = iframe.contentDocument.getElementsByTagName('img');

var newParent = document.getElementByTagName('images');

for (var i = 0; i < iframeImages.length; i++) {
    newParent.appendChild(document.adoptNode(iframeImages[i]));
}

Notas

Por lo general la función adoptNode puede fallar dibido a una implementación diferente en el nodo origen, sin embargo no debería ser un problema referente a las implementaciones del navegador.

Los nodos que provienen de documentos externos deben clonarse utilizando document.importNode() (o adoptados utilizando document.adoptNode()) antes que puedan ser insertados en el documento actual. Para mas información relacionada a Node.ownerDocument vea W3C DOM FAQ.

Epecificaciones

• DOM Level 3 Core: Document.adoptNode

Compatibilidad con navegadores

Vea también

• document.importNode