CKTIS / JavaScript
Node.appendChild — připojení uzlu
Node.appendChild přidá uzel jako posledního potomka rodiče. Vrátí předaný uzel a existující uzel přesune, místo aby jej zkopíroval.
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
parent.appendChild(node)parent.appendChild(node) přijímá jeden Node a vrací tentýž objekt. Jde o DOM API, nikoli o funkci ECMAScriptu.
Pokud node už má rodiče, přesune se, nezkopíruje. Opětovné přidání existujícího potomka jej přesune na konec. U DocumentFragment se jeho potomci přesunou v dosavadním pořadí; vrácený fragment bude prázdný.
Neplatná hierarchie, například vložení předka do jeho potomka, způsobí chybu HierarchyRequestError. Na rozdíl od append() tato metoda nepřijímá text ani více argumentů jako seznam uzlů.
Příklad vyžaduje DOM prohlížeče; samotná verze Node.js nedokládá podporu tohoto API. Výsledek BA ukazuje přesunutí uzlu first.
Příklady
const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const second = document.createElement('span');
second.textContent = 'B';
parent.appendChild(first);
parent.appendChild(second);
const returned = parent.appendChild(first);
console.log(parent.textContent);
console.log(returned === first);
console.log(parent.childNodes.length);Výsledek
BA true 2
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.