CKTIS / JavaScript
Node.cloneNode(): einen DOM-Knoten kopieren
Node.cloneNode() erstellt einen eigenständigen DOM-Knoten. Das Argument subtree legt fest, ob auch Nachfahren kopiert werden.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const copy = node.cloneNode();
const deepCopy = node.cloneNode(true);node.cloneNode() gibt einen neuen Knoten ohne übergeordneten Knoten zurück. Das Standardargument subtree = false lässt Nachfahren aus; true kopiert sie rekursiv, einschließlich Textknoten. Attribute des Elements werden in beiden Fällen kopiert.
Die Kopie ist nicht das Original und übernimmt keine Listener, die mit addEventListener() registriert wurden. Ändere vor dem Einfügen in dasselbe Dokument die kopierte id, um Duplikate zu vermeiden.
Ein direkter Aufruf auf einem ShadowRoot löst NotSupportedError aus. Dies ist eine Browser-DOM-API, keine ECMAScript-Funktion; eine Node.js-Version belegt nicht, dass sie verfügbar ist.
Beispiele
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);Ergebnis
0 Hello true false 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.