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.