CKTIS / JavaScript
Node.appendChild — dodawanie węzła na końcu
Node.appendChild dodaje węzeł jako ostatnie dziecko rodzica. Zwraca przekazany węzeł, a istniejący przenosi zamiast kopiować.
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
parent.appendChild(node)parent.appendChild(node) przyjmuje jeden Node i zwraca ten sam obiekt. To API DOM, nie funkcja ECMAScript.
Jeśli node ma rodzica, zostaje przeniesiony, nie skopiowany. Ponowne dodanie dziecka przesuwa je na koniec. Dla DocumentFragment przenoszone są jego dzieci w dotychczasowej kolejności; zwracany fragment zostaje pusty.
Nieprawidłowa hierarchia, np. dodanie przodka do potomka, powoduje HierarchyRequestError. W przeciwieństwie do append(), metoda nie przyjmuje tekstu ani wielu argumentów jako listy węzłów.
Przykład wymaga DOM przeglądarki; sama wersja Node.js nie dowodzi obsługi tego API. Wynik BA pokazuje przeniesienie first.
Przykłady
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);Wynik
BA true 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.