CKTIS / JavaScript
Node.appendChild — dodavanje čvora
Node.appendChild dodaje čvor kao posljednje dijete roditelja. Vraća predani čvor i premješta postojeći čvor umjesto da ga kopira.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
parent.appendChild(node)parent.appendChild(node) prihvaća jedan Node i vraća isti objekt. To je DOM API, a ne funkcija ECMAScripta.
Ako node već ima roditelja, premješta se, a ne kopira. Ponovno dodavanje postojećeg djeteta premješta ga na kraj. Kod DocumentFragment njegova se djeca premještaju postojećim redoslijedom; vraćeni fragment ostaje prazan.
Nevaljana hijerarhija, primjerice umetanje pretka u njegova potomka, uzrokuje pogrešku HierarchyRequestError. Za razliku od append(), ova metoda ne prihvaća tekst ni više argumenata kao popis čvorova.
Primjer zahtijeva DOM preglednika; sama verzija Node.js ne dokazuje podršku za ovaj API. Rezultat BA pokazuje premještanje čvora first.
Primjeri
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);Rezultat
BA true 2
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.