CKTIS / JavaScript
Element.append — Knoten und Text anhängen
`Element.append` fügt Knoten und Text am Ende eines Elements ein und gibt `undefined` zurück. Sind `a` und `b` verschiedene Elemente, steht nach einem erfolgreichen Aufruf von `element.append(a, b, a)` am Ende zuerst `b` und dann `a`: Beim letzten Auftreten von `a` wird der Knoten verschoben, nicht kopiert. Ist `a` dagegen ein `DocumentFragment` mit einem einzelnen Textknoten und `b` ein separates Element, wird beim ersten Auftreten von `a` der Textknoten vor `b` eingefügt und das Fragment geleert. Beim letzten Auftreten wird nichts hinzugefügt; das Fragment selbst wird nicht eingefügt.
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
element.append(...nodes)Element.append stammt aus dem ParentNode-Mixin des DOM-Standards, nicht aus ECMAScript. Die Methode fügt null oder mehr Argumente nach dem letzten untergeordneten Knoten des Elements ein.
Zeichenfolgen werden zu Text-Knoten, nicht zu HTML-Markup. Ein vorhandener Knoten wird verschoben, nicht kopiert. Ein DocumentFragment fügt seine untergeordneten Knoten ein und wird dabei geleert.
Im Gegensatz zu appendChild akzeptiert append mehrere Argumente, darunter auch Text, und gibt undefined zurück. Eine ungültige Hierarchie, etwa wenn ein Element in sich selbst eingefügt wird, führt zu HierarchyRequestError.
Beispiele
const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);Ergebnis
Status: OK! 3 undefined
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.