Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Node.cloneNode(): copiare un nodo DOM

Node.cloneNode() crea un nodo DOM separato. L’argomento subtree stabilisce se copiare anche i discendenti.

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

Sintassi

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

node.cloneNode() restituisce un nuovo nodo senza nodo genitore. Il valore predefinito subtree = false esclude i discendenti; true li copia in modo ricorsivo, compresi i nodi di testo. Gli attributi dell’elemento vengono copiati in entrambi i casi.

La copia non è l’originale e non eredita i listener registrati con addEventListener(). Prima di inserirla nello stesso documento, modifica l’id copiato per evitare duplicati.

Una chiamata diretta su un ShadowRoot genera NotSupportedError. Si tratta di un’API DOM del browser, non di una funzionalità ECMAScript; la versione di Node.js non dimostra che sia disponibile.

Esempi

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);

Risultato

0
Hello
true
false
0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti