Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Node.cloneNode(): copiar un nodo DOM

Node.cloneNode() crea un nodo DOM independiente. El argumento subtree determina si también se copian los descendientes.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const copy = node.cloneNode();
const deepCopy = node.cloneNode(true);

node.cloneNode() devuelve un nodo nuevo sin nodo padre. El valor predeterminado subtree = false omite los descendientes; true los copia de forma recursiva, incluidos los nodos de texto. Los atributos del elemento se copian en ambos casos.

La copia no es el original ni hereda los listeners registrados con addEventListener(). Antes de insertarla en el mismo documento, cambia el id copiado para evitar duplicados.

Llamar directamente al método en un ShadowRoot produce NotSupportedError. Es una API DOM del navegador, no una característica de ECMAScript; la versión de Node.js no demuestra que esté disponible.

Ejemplos

const original = document.createElement('button');
original.id = 'original';
original.textContent = 'Hello';
let calls = 0;
original.addEventListener('click', () => calls++);

const shallow = original.cloneNode();
const deep = original.cloneNode(true);
deep.id = 'copy';
deep.click();

console.log(shallow.childNodes.length);
console.log(deep.textContent);
console.log(deep.parentNode === null);
console.log(deep === original);
console.log(calls);

Resultado

0
Hello
true
false
0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes