CKTIS / JavaScript
Node.cloneNode(): kopiowanie węzła DOM
Node.cloneNode() tworzy osobny węzeł DOM. Argument subtree określa, czy kopia obejmuje również potomków.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const copy = node.cloneNode();
const deepCopy = node.cloneNode(true);node.cloneNode() zwraca nowy węzeł bez rodzica. Domyślne subtree = false pomija potomków; true kopiuje ich rekurencyjnie, również węzły tekstowe. Atrybuty elementu są kopiowane w obu przypadkach.
Kopia nie jest oryginałem i nie przejmuje listenerów dodanych przez addEventListener(). Przed wstawieniem jej do tego samego dokumentu zmień skopiowane id, aby uniknąć duplikatów.
Bezpośrednie wywołanie na ShadowRoot zgłasza NotSupportedError. To przeglądarkowe API DOM, nie funkcja ECMAScript; wersja Node.js nie dowodzi jego dostępności.
Przykłady
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);Wynik
0 Hello true false 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.