CKTIS / JavaScript
Node.appendChild — pripojenie uzla
Node.appendChild pridá uzol ako posledného potomka rodiča. Vráti odovzdaný uzol a existujúci uzol presunie namiesto toho, aby ho skopíroval.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
parent.appendChild(node)parent.appendChild(node) prijíma jeden Node a vracia ten istý objekt. Je to DOM API, nie funkcia ECMAScriptu.
Ak node už má rodiča, presunie sa, nie skopíruje. Opätovné pridanie existujúceho potomka ho presunie na koniec. Pri DocumentFragment sa jeho potomkovia presunú v doterajšom poradí; vrátený fragment bude prázdny.
Neplatná hierarchia, napríklad vloženie predka do jeho potomka, spôsobí chybu HierarchyRequestError. Na rozdiel od append() táto metóda neprijíma text ani viacero argumentov ako zoznam uzlov.
Príklad vyžaduje DOM prehliadača; samotná verzia Node.js nedokazuje podporu tohto API. Výsledok BA ukazuje presunutie uzla first.
Prí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ýsledok
BA true 2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.