CKTIS / JavaScript
Element.before() — vor einem Element einfügen
Element.before() fügt Knoten und Text in den Elternknoten ein, nicht in das Element selbst. Normalerweise stehen sie danach vor dem Referenzelement.
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.before(...nodes)Element.before ist eine DOM-Methode des ChildNode-Mixins und keine ECMAScript-Funktion. element.before(...nodes) akzeptiert Knoten und Zeichenfolgen; Zeichenfolgen werden zu Text-Knoten, nicht zu HTML.
Vorhandene Knoten werden verschoben und nicht kopiert. Wenn du das Referenzelement selbst als Argument übergibst, kann es ebenfalls verschoben werden. Ist der Elternknoten von target ein Element oder ein DocumentFragment, platziert target.before(target, 'x') den Text nach target, nicht davor. Ist target das Wurzelelement des Dokuments, löst derselbe Aufruf HierarchyRequestError aus: Ein Fragment mit einem Text-Kindknoten kann nicht in ein Document eingefügt werden. Bei Erfolg gibt die Methode undefined zurück.
Ein Element ohne Elternknoten bleibt unverändert; der Elternknoten muss nicht zum Dokument gehören. Eine ungültige Hierarchie führt zu HierarchyRequestError. Anders als bei parent.insertBefore(node, element) rufst du diese Methode auf dem Referenzelement auf.
Beispiele
const parent = document.createElement('div');
const target = document.createElement('span');
target.textContent = 'B';
parent.appendChild(target);
const first = document.createElement('strong');
first.textContent = 'A';
const result = target.before(first, ' + ');
console.log(parent.textContent);
console.log(parent.firstChild === first);
console.log(result === undefined);Ergebnis
A + B 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.