CKTIS / JavaScript
Node.appendChild — einen Knoten anhängen
Node.appendChild fügt einen Knoten als letztes Kind eines Elternknotens ein. Die Methode gibt den übergebenen Knoten zurück und verschiebt einen bereits vorhandenen Knoten, statt ihn zu kopieren.
Version: 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) nimmt einen einzelnen Node entgegen und gibt dasselbe Objekt zurück. Dies ist eine DOM-API, keine ECMAScript-Funktion.
Hat node bereits einen Elternknoten, wird er verschoben und nicht kopiert. Wird ein vorhandenes Kind erneut angehängt, gelangt es ans Ende. Bei einem DocumentFragment werden dessen Kinder in ihrer bisherigen Reihenfolge verschoben; das zurückgegebene Fragment ist anschließend leer.
Eine ungültige Hierarchie, etwa wenn ein Vorfahr in einen seiner Nachkommen eingefügt wird, verursacht einen HierarchyRequestError. Anders als append() nimmt diese Methode weder Text noch mehrere Argumente als Knotenliste entgegen.
Das Beispiel benötigt ein Browser-DOM; eine Node.js-Version allein belegt nicht, dass diese API unterstützt wird. Das Ergebnis BA zeigt, dass first verschoben wird.
Beispiele
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);Ergebnis
BA true 2
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.