Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła