WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen