WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen