Método importNode() del Documento DOM HTML

Definición y uso

importNode() Este método importa un nodo desde otro documento.

el segundo parámetro se establece en true también se importarán los descendientes.

cuando

Consejo

El nodo importado no será eliminado del documento original.

El nodo importado es una copia del nodo original.

Véase también:

Método document.adoptNode()

Método element.cloneNode()

Ejemplo

Importar el primer elemento <h1> desde iframe (otro documento):
const frame = document.getElementsById("myFrame");
const h1 = frame.contentWindow.document.getElementsByTagName("H1")[0];

const node = document.importNode(h1, true);

Prueba tú mismo

SintaxisEste métododocument.importNode( El parámetro es un nodo definido en otro documento, el valor devuelto es una copia del nodo adecuada para insertarse en este documento. Si,

)

) Tipo
Este método Parámetro
El parámetro es un nodo definido en otro documento, el valor devuelto es una copia del nodo adecuada para insertarse en este documento. Si

Obligatorio. Nodo proveniente de otro documento.

  • Obligatorio.
  • false: solo se importará el nodo en sí mismo.

true: se importarán también los descendientes del nodo (hijos).

Valor devuelto Tipo
Descripción nodo

el nodo importado.

lanza Este método Si es un nodo Documento o nodo DocumentType, este método lanzará un código de NOT_SUPPORTED_ERR

lanzará una excepción DOMException debido a que no se pueden importar estos tipos de nodos.

Detalles técnicos Este método node El parámetro es un nodo definido en otro documento, el valor devuelto es una copia del nodo adecuada para insertarse en este documento. Si deep

Al importar un nodo Elemento, solo se importarán las propiedades explícitamente configuradas en el documento de origen. Al importar un nodo Attr, se establecerá automáticamente su propiedad specified en true. Si el valor es true, también se copiarán todos los descendientes del nodo. De cualquier manera, neither el nodo original ni sus descendientes serán modificados. El atributo ownerDocument del duplicado será el documento actual, pero el atributo parentNode será null, ya que aún no ha sido insertado en el documento. Las funciones de escucha de eventos registradas en el árbol de nodos original no se copiarán.

Compatibilidad del navegador

document.importNode() es una característica del nivel DOM 2 (2001).

Todos los navegadores lo soportan:

Chrome IE Edge Firefox Safari Ópera
Chrome IE Edge Firefox Safari Ópera
Soporte 9-11 Soporte Soporte Soporte Soporte