WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen