CKTIS / JavaScript
Element.prepend — am Anfang eines Elements einfügen
Element.prepend fügt Knoten und Text vor dem ersten Kind eines Elements ein. Sind a und b verschiedene Elemente, fügt prepend(a, b, a) zuerst b und dann a ein, ohne a zu duplizieren.
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.prepend(...nodes)Element.prepend ist eine DOM-Methode des Mixin ParentNode, keine ECMAScript-Funktion. Sie akzeptiert Knoten und Zeichenfolgen und gibt undefined zurück.
Die Argumente werden vor dem ersten Kind eingefügt, auch wenn dieses ein Textknoten ist. Zeichenfolgen werden zu Text-Knoten, nicht zu HTML-Markup. Vorhandene Knoten werden verschoben, nicht kopiert.
Ein Verstoß gegen die Hierarchiebedingungen des Baums löst HierarchyRequestError aus. Das Beispiel benötigt eine DOM-Umgebung; allein die Node.js-Version belegt nicht, dass diese Methode verfügbar ist.
Beispiele
const container = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'Start';
container.textContent = 'End';
const result = container.prepend(label, ' | ');
console.log(container.textContent);
console.log(container.firstChild === label);
console.log(result === undefined);Ergebnis
Start | End true true
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.