CKTIS / JavaScript
Node.cloneNode(): kopírování uzlu DOM
Node.cloneNode() vytvoří samostatný uzel DOM. Argument subtree určuje, zda se zkopírují také potomci.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const copy = node.cloneNode();
const deepCopy = node.cloneNode(true);node.cloneNode() vrací nový uzel bez rodiče. Výchozí hodnota subtree = false potomky vynechá; true je zkopíruje rekurzivně, včetně textových uzlů. Atributy prvku se zkopírují v obou případech.
Kopie není původní uzel a nepřebírá listenery zaregistrované pomocí addEventListener(). Před vložením kopie do stejného dokumentu změň její id, aby nevznikly duplicity.
Přímé volání na objektu ShadowRoot vyvolá NotSupportedError. Jde o API DOM v prohlížeči, nikoli o funkci ECMAScriptu; verze Node.js nedokládá jeho dostupnost.
Příklady
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);Výsledek
0 Hello true false 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.